基於SpringBoot的圖片上傳與顯示(附原始碼)

Demo地址

https://github.com/HelloSummer5/FileUploadDemo

效果圖預覽

圖片上傳Demo預覽圖

思路

  • 一般情況下都是將使用者上傳的圖片放到伺服器的某個資料夾中,然後將圖片在伺服器中的路徑存入資料庫。本Demo也是這樣做的。
  • 由於使用者自己儲存的圖片檔名可能跟其他使用者同名造成衝突,因此本Demo選擇了使用UUID來生成隨機的檔名解決衝突。
  • 但是本Demo不涉及任何有關資料庫的操作,便於演示,就用原來的檔名。

步驟

pom相關依賴

  • 基於Spring boot當然是繼承了spring boot這不用多說
  • 具體依賴,主要是FreeMarker相關依賴為了展現頁面,習慣用JSP也可以新增JSP的依賴,只是為了展示頁面,這個不重要。
<dependencies>
<!--FreeMarker模板檢視依賴-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>

application.properties相關配置

  • 除了檢視模板相關的配置,重點是要配置一下檔案上傳的記憶體大小和檔案上傳路徑
server.port=8102
### FreeMarker 配置
spring.freemarker.allow-request-override=false
#Enable template caching.啟用模板快取。
spring.freemarker.cache=false
spring.freemarker.check-template-location=true
spring.freemarker.charset=UTF-8
spring.freemarker.content-type=text/html
spring.freemarker.expose-request-attributes=false
spring.freemarker.expose-session-attributes=false
spring.freemarker.expose-spring-macro-helpers=false
#設定面板字尾
spring.freemarker.suffix=.ftl
# 設定單個檔案最大記憶體
multipart.maxFileSize=50Mb
# 設定所有檔案最大記憶體
multipart.maxRequestSize=50Mb
# 自定義檔案上傳路徑
web.upload-path=E:/Develop/Files/Photos/

生成檔名

  • 不準備生成檔名的可以略過此步驟
package com.wu.demo.fileupload.demo.util;
public class FileNameUtils {
/**
* 獲取檔案字尾
* @param fileName
* @return
*/
public static String getSuffix(String fileName){
return fileName.substring(fileName.lastIndexOf("."));
}
/**
* 生成新的檔名
* @param fileOriginName 原始檔名
* @return
*/
public static String getFileName(String fileOriginName){
return UUIDUtils.getUUID()   FileNameUtils.getSuffix(fileOriginName);
}
}

import java.util.UUID;
/**
* 生成檔名
*/
public class UUIDUtils {
public static String getUUID(){
return UUID.randomUUID().toString().replace("-", "");
}
}

檔案上傳工具類

package com.wu.demo.fileupload.demo.util;
import org.springframework.web.multipart.MultipartFile;
import java.io.File;
import java.io.IOException;
/**
* 檔案上傳工具包
*/
public class FileUtils {
/**
*
* @param file 檔案
* @param path 檔案存放路徑
* @param fileName 原始檔名
* @return
*/
public static boolean upload(MultipartFile file, String path, String fileName){
// 生成新的檔名
//String realPath = path   "/"   FileNameUtils.getFileName(fileName);
//使用原檔名
String realPath = path   "/"   fileName;
File dest = new File(realPath);
//判斷檔案父目錄是否存在
if(!dest.getParentFile().exists()){
dest.getParentFile().mkdir();
}
try {
//儲存檔案
file.transferTo(dest);
return true;
} catch (IllegalStateException e) {
// TODO Auto-generated catch block
e.printStackTrace();
return false;
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
return false;
}
}
}

Controller

package com.wu.demo.fileupload.demo.controller;
import com.wu.demo.fileupload.demo.util.FileUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.core.io.ResourceLoader;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.http.HttpServletResponse;
import java.util.Map;
@Controller
public class TestController {
private final ResourceLoader resourceLoader;
@Autowired
public TestController(ResourceLoader resourceLoader) {
this.resourceLoader = resourceLoader;
}
@Value("${web.upload-path}")
private String path;
/**
* 跳轉到檔案上傳頁面
* @return
*/
@RequestMapping("test")
public String toUpload(){
return "test";
}
/**
*
* @param file 要上傳的檔案
* @return
*/
@RequestMapping("fileUpload")
public String upload(@RequestParam("fileName") MultipartFile file, Map<String, Object> map){
// 要上傳的目標檔案存放路徑
String localPath = "E:/Develop/Files/Photos";
// 上傳成功或者失敗的提示
String msg = "";
if (FileUtils.upload(file, localPath, file.getOriginalFilename())){
// 上傳成功,給出頁面提示
msg = "上傳成功!";
}else {
msg = "上傳失敗!";
}
// 顯示圖片
map.put("msg", msg);
map.put("fileName", file.getOriginalFilename());
return "forward:/test";
}
/**
* 顯示單張圖片
* @return
*/
@RequestMapping("show")
public ResponseEntity showPhotos(String fileName){
try {
// 由於是讀取本機的檔案,file是一定要加上的, path是在application配置檔案中的路徑
return ResponseEntity.ok(resourceLoader.getResource("file:"   path   fileName));
} catch (Exception e) {
return ResponseEntity.notFound().build();
}
}
}

頁面

  • 頁面主要是from表單和下面的 <img src="/show?fileName=${fileName}" /> ,其餘都是細節。
<!DOCTYPE html>
<head>
<meta charset="UTF-8" />
<title>圖片上傳Demo</title>
</head>
<body>
<h1 >圖片上傳Demo</h1>
<form action="fileUpload" method="post" enctype="multipart/form-data">
<p>選擇檔案: <input type="file" name="fileName"/></p>
<p><input type="submit" value="提交"/></p>
</form>
<#--判斷是否上傳檔案-->
<#if msg??>
<span>${msg}</span><br>
<#else >
<span>${msg!("檔案未上傳")}</span><br>
</#if>
<#--顯示圖片,一定要在img中的src發請求給controller,否則直接跳轉是亂碼-->
<#if fileName??>
<img src="/show?fileName=${fileName}" style="width: 200px"/>
<#else>
<img src="/show" style="width: 100px"/>
</#if>
</body>
</html>