SpringBoot實(shí)現(xiàn)圖片上傳及本地訪問

更新時(shí)間：2022年09月19日 10:28:36 作者：_多拉不懂A夢(mèng)

在SpringBoot項(xiàng)目中,處理靜態(tài)文件訪問尤其是實(shí)時(shí)更新的文件如商品圖片,可通過配置WebMvcConfig將本地文件映射到URL路徑上,以解決重啟項(xiàng)目才能訪問文件的問題,本文詳解如何保存和訪問這些文件,幫助開發(fā)者優(yōu)化項(xiàng)目文件管理

項(xiàng)目需求

最近做軟件架構(gòu)平臺(tái)的課程實(shí)驗(yàn)時(shí)遇到這樣的一個(gè)問題。需求是要修改商品的圖片，完成圖片的上傳，這本身并不難，使用form-data的格式進(jìn)行交互就能完成。但是上傳后無法立馬訪問到才是最頭疼的問題。

一開始選擇是將圖片存到static目錄下面，當(dāng)作靜態(tài)文件處理，但是后面發(fā)現(xiàn)，只有重啟項(xiàng)目后，靜態(tài)文件加載到target中才能訪問到。

找了很多解決辦法，最終找到了合適的方案。

springboot靜態(tài)文件講解

springboot的靜態(tài)文件根據(jù)需求我們可以分成兩種

恒不變的項(xiàng)目靜態(tài)文件static：

這種類型的文件是項(xiàng)目建立初就不會(huì)變動(dòng)的文件，典型的有各種各樣的UI庫(kù)，bootstrap，jquery，還有項(xiàng)目的圖標(biāo)等等。
這些文件最終會(huì)被加載到項(xiàng)目的target目錄下，作為類似項(xiàng)目的依賴包持續(xù)使用，差不多和maven依賴包一樣。

target目錄下的文件不需要進(jìn)行任何配置盡可以通過域名加目錄直接訪問到。如localhost:8080/echarts/echarts.min.js

持續(xù)上傳更新的文件file：

這一類文件是保存在系統(tǒng)服務(wù)端的數(shù)據(jù)文件，會(huì)不斷的收到用戶和管理員的CRUD操作處理，典型的有系統(tǒng)文檔，商品圖片等等。
這些文件僅保存在服務(wù)端，但是不會(huì)進(jìn)入項(xiàng)目目錄下，更不會(huì)加載到target中。

上傳文件

根據(jù)上面的描述，我們很清楚我們需要解決的就是如何存儲(chǔ)持續(xù)上傳更新的文件，以及如何才能訪問的到。

寫一個(gè)上傳文圖片的接口，并將圖片保存到本地的目錄項(xiàng)

public class Constant {
    public static final String ITEM_PICTURE_PATH = "D:\\Tools\\";
}

    @PostMapping("/importPicture")
    public MsgEntity importPicture(@RequestParam("file") MultipartFile file, @RequestParam("id") String id) throws FileNotFoundException {
        //獲得文件的后綴
        String filename = UUID.randomUUID() + Objects.requireNonNull(file.getOriginalFilename()).substring(file.getOriginalFilename().lastIndexOf("."));
        //獲取文件存儲(chǔ)路徑
        File filepath = new File(Constant.ITEM_PICTURE_PATH + filename);
        String url = String.valueOf(filepath);
        try {
            //存文件
            file.transferTo(filepath);
        } catch (IOException e) {
            e.printStackTrace();
        }
        itemService.setPictureUrl("http://localhost:8080/temp-image/" + filename, id);
        return new MsgEntity("SUCCESS", "200", url);
    }

訪問文件

上傳文件已經(jīng)完成了，那么如何訪問到存儲(chǔ)在本地服務(wù)器的文件呢？

其實(shí)SpringBoot已經(jīng)很好的為我們解決了這個(gè)問題，我們只需要加上一點(diǎn)配置，就能將本地文件映射到url路徑上。

在properties中加上自定義配置

# 配置上傳圖片的路徑和訪問圖片圖片的路徑
upload.file.location=file:D:/Tools/
upload.file.path =/temp-image/**

編寫WebMvcConfig的配置類

@Configuration
public class MyWebAppConfigurer implements WebMvcConfigurer {
    @Value("${upload.file.location}")
    private String fileLocation;
    @Value("${upload.file.path}")
    private String filePath;

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
		//注冊(cè)配置類，使用addResourceHandlers方法，將本地路徑fileLocation映射到filePath路由上。
        registry.addResourceHandler(filePath).addResourceLocations(fileLocation);
        WebMvcConfigurer.super.addResourceHandlers(registry);
    }
}

這樣就可以在瀏覽器上訪問了