以前的文件上传都是之前前辈写的，现在自己来写一个，大家可以看看，有什么问题可以在评论中提出来。
写的这个文件上传是在spring boot 2.0中测试的，测试了，可以正常上传，下面贴代码
第一步：引入依赖
这里我用的是maven构建项目，spring boot 的相关pom我就不贴了，我这里贴我额外引入的。
<dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> </dependency> <!-- Apache Commons FileUpload --> <dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.3.3</version> </dependency> <!-- Apache Commons IO --> <dependency> <groupId>commons-io</groupId> <artifactId>commons-io</artifactId> <version>2.4</version> </dependency> <!-- thumbnailator 图片压缩工具 --> <dependency> <groupId>net.coobird</groupId> <artifactId>thumbnailator</artifactId> <version>0.4.8</version> </dependency>
第二步：编写上传返回结果实体 FileResult.java
import lombok.Data; /** * 文件上传返回的数据实体 * * @author lixingwu */ @Data public class FileResult {
// 文件名 private String fileName;
// 扩展名 private String extName;
// 文件大小，字节 private Long fileSize;
// 文件存储在服务器的相对地址 private String serverPath; }
第三步：编写 PropertiesUtils.java 和 custom.properties
import java.io.IOException; import java.io.InputStream; import java.util.Properties; /** * 读取properties文件 * * @author lixingwu */ public class PropertiesUtils { private Properties properties; private static PropertiesUtils propertiesUtils = new PropertiesUtils(); /** * 私有构造，禁止直接创建 */ private PropertiesUtils() { properties = new Properties(); InputStream in = PropertiesUtils.class.getClassLoader() .getResourceAsStream("custom.properties"); try { properties.load(in); } catch (IOException e) { e.printStackTrace(); } } /** * 获取单例 * * @return PropertiesUtils */ public static PropertiesUtils getInstance() { if (propertiesUtils == null) { propertiesUtils = new PropertiesUtils(); } return propertiesUtils; } /** * 根据属性名读取值 * * @param name 名称 */ public Object getProperty(String name) { return properties.getProperty(name); } /*************************************************************************/ /*****************************读取属性，封装字段**************************/ /*************************************************************************/ /** * 是否调试模式 */ public Boolean isDebug() { return "true".equals(properties.getProperty("isDebug")); } public String getAttachmentServer() { return properties.getProperty("attachmentServer"); } public String getAttachmentPath() { return properties.getProperty("attachmentPath"); } public String getAttachmentGainPpath() { return properties.getProperty("attachmentGainPath"); } public static void main(String[] args) { PropertiesUtils pro = PropertiesUtils.getInstance(); String value = String.valueOf(pro.getProperty("custom.properties.name").toString()); System.out.println(value); } }
custom.properties（具体路径，根据自己项目进行修改）
# 自定义 属性文件，可使用 PropertiesUtils.java 来读取 custom.properties.name=custom.properties isDebug=true #附件地址 attachmentServer=www.baidu.con/static
#服务器静态文件地址 attachmentPath=/var/www/html #服务器存储文件的地址
attachmentGainPath=/var/www/html/upload
第四步：编写 FileuploadUtil.java
package com.zhwlt.logistics.utils; import com.zhwlt.logistics.pojo.system.FileResult; import net.coobird.thumbnailator.Thumbnails; import org.apache.commons.io.FileUtils; import org.apache.commons.io.FilenameUtils; import org.apache.commons.lang3.ArrayUtils; import org.apache.commons.lang3.BooleanUtils; import org.apache.commons.lang3.StringUtils; import org.springframework.web.multipart.MultipartFile; import java.io.File; import java.io.IOException; import java.util.*; /** * 文件上传工具类（修改了bug 2019-0105） * * @author lixingwu */ public class FileuploadUtil { /** * 属性配置 */ private static PropertiesUtils pro = PropertiesUtils.getInstance(); /** * 方法描述：根据文件的绝对路径创建一个文件对象. * 创建时间：2018-10-19 09:32:34 * * @param filePath 文件的绝对路径 * @return 返回创建的这个文件对象 * @author "lixingwu" */ public static File createFile(String filePath) throws IOException { // 获取文件的完整目录 String fileDir = FilenameUtils.getFullPath(filePath); // 判断目录是否存在，不存在就创建一个目录 File file = new File(fileDir); if (!file.isDirectory()) { //创建失败返回null if (!file.mkdirs()) { throw new IOException("文件目录创建失败..."); } } // 判断这个文件是否存在，不存在就创建 file = new File(filePath); if (!file.exists()) { if (!file.createNewFile()) { throw new IOException("目标文件创建失败..."); } } return file; } /** * 方法描述：判断extension中是否存在extName * 创建时间：2018-10-20 20:46:18 * * @param extension 使用逗号隔开的字符串，精确匹配例如：txt,jpg,png,zip * @param extName 文件的后缀名 * @author "lixingwu" */ private static void isContains(String extension, String extName) { if (StringUtils.isNotEmpty(extension)) { // 切割文件扩展名 String[] exts = StringUtils.split(extension, ","); if (ArrayUtils.isNotEmpty(exts)) { assert exts != null; List<String> extList = Arrays.asList(exts); //判断 if (!extList.contains(extName)) { throw new RuntimeException("上传文件的类型只能是：" + extension); } } else { // 判断文件的后缀名是否为extension if (!extension.equalsIgnoreCase(extName)) { throw new RuntimeException("上传文件的类型只能是：" + extension); } } } } /** * 方法描述：处理上传的图片 * 创建时间：2018-10-20 20:46:18 * * @param serverPath 图片的绝对路径 * @param childFile 子文件夹 * @param extName 文件的后缀 * @author "lixingwu" */ private static String thumbnails(String serverPath, String childFile, String extName) throws IOException { // 压缩后的相对路径文件名 String toFilePath = getDestPath(childFile, extName); // scale：图片缩放比例 // outputQuality：图片压缩比例 // toFile：图片位置 // outputFormat：文件输出后缀名 // Thumbnails 如果用来压缩 png 格式的文件，会越压越大， // 得把png格式的图片转换为jpg格式 if ("png".equalsIgnoreCase(extName)) { // 由于outputFormat会自动在路径后加上后缀名，所以移除以前的后缀名 String removeExtensionFilePath = FilenameUtils.removeExtension(toFilePath); Thumbnails.of(serverPath).scale(1f) .outputQuality(0.5f) .outputFormat("jpg") .toFile(getServerPath(removeExtensionFilePath)); toFilePath = removeExtensionFilePath + ".jpg"; } else { Thumbnails.of(serverPath).scale(1f).outputQuality(0.5f) .toFile(getServerPath(toFilePath)); } // 删除被压缩的文件 FileUtils.forceDelete(new File(serverPath)); return toFilePath; } /** * 方法描述：生成文件文件名 * 创建时间：2018-10-20 20:46:18 * * @param childFile 子目录 * @param extName 后缀名 * @author "lixingwu" */ private static String getDestPath(String childFile, String extName) { //规则： 子目录/年月日_随机数.后缀名 String sb = childFile + "/" + DateUtil.formatDate(new Date(), DateUtil.DATE_FORMAT_SHORT) + "_" + Tools.getRandom() + "." + extName; return sb; } /** * 方法描述：生成文件在的实际的路径 * 创建时间：2018-10-20 20:46:18 * * @param destPath 文件的相对路径 * @author "lixingwu" */ private static String getServerPath(String destPath) { // 文件分隔符转化为当前系统的格式 return FilenameUtils.separatorsToSystem(pro.getAttachmentGainPpath() + destPath); } /** * 方法描述：上传文件. * 创建时间：2018-10-19 13:09:19 * * @param multipartFile 上传的文件对象，必传 * @param childFile 上传的父目录，为空直接上传到指定目录 （会在指定的目录下新建该目录，例如：/user/1023） * @param extension 允许上传的文件后缀名，为空不限定上传的文件类型 （使用逗号隔开的字符串，精确匹配例如：txt,jpg,png,zip） * @param isImage 上传的是否是图片，如果是就会进行图片压缩；如果不希望图片被压缩，则传false，让其以文件的形式来保存 * @return the file result * @throws IOException 异常信息应返回 * @author "lixingwu" */ private static FileResult saveFile(MultipartFile multipartFile, String childFile, String extension, Boolean isImage) throws IOException { if (null == multipartFile || multipartFile.isEmpty()) { throw new IOException("上传的文件对象不存在..."); } // 文件名 String fileName = multipartFile.getOriginalFilename(); // 文件后缀名 String extName = FilenameUtils.getExtension(fileName); if (StringUtils.isEmpty(extName)) { throw new RuntimeException("文件类型未定义不能上传..."); } // 判断文件的后缀名是否符合规则 isContains(extension, extName); // 创建目标文件的名称，规则请看destPath方法 String destPath = getDestPath(childFile, extName); // 文件的实际路径 String serverPath = getServerPath(destPath); // 创建文件 File destFile = createFile(serverPath); // 保存文件 multipartFile.transferTo(destFile); // 拼装返回的数据 FileResult result = new FileResult(); //如果是图片，就进行图片处理 if (BooleanUtils.isTrue(isImage)) { // 图片处理 String toFilePath = thumbnails(serverPath, childFile, extName); // 得到处理后的图片文件对象 File file = new File(getServerPath(toFilePath)); // 压缩后的文件后缀名 String extExtName = FilenameUtils.getExtension(toFilePath); // 源文件=源文件名.压缩后的后缀名 String extFileName = FilenameUtils.getBaseName(fileName) + "." + FilenameUtils.getExtension(toFilePath); result.setFileSize(file.length()); result.setServerPath(toFilePath); result.setFileName(extFileName); result.setExtName(extExtName); } else { result.setFileSize(multipartFile.getSize()); result.setFileName(fileName); result.setExtName(extName); result.setServerPath(destPath); } return result; } /** * 方法描述：上传文件. * 创建时间：2018-10-19 13:09:19 * * @param multipartFile 上传的文件对象，必传 * @param childFile 上传的父目录，为空直接上传到指定目录 （会在指定的目录下新建该目录，例如：/user/1023） * @param extension 允许上传的文件后缀名，为空不限定上传的文件类型 （使用逗号隔开的字符串，精确匹配例如：txt,jpg,png,zip） * @return the file result * @throws IOException 异常信息应返回 * @author "lixingwu" */ public static FileResult saveFile(MultipartFile multipartFile, String childFile, String extension) throws IOException { return saveFile(multipartFile, childFile, extension, false); } /** * 方法描述：上传图片. * 创建时间：2018-10-19 13:09:19 * * @param multipartFile 上传的文件对象，必传 * @param childFile 上传的父目录，为空直接上传到指定目录 （会在指定的目录下新建该目录，例如：/user/1023） * @param extension 允许上传的文件后缀名，为空不限定上传的文件类型 （使用逗号隔开的字符串，精确匹配例如：txt,jpg,png,zip） * @return the file result * @throws IOException 异常信息应返回 * @author "lixingwu" */ public static FileResult saveImage(MultipartFile multipartFile, String childFile, String extension) throws IOException { return saveFile(multipartFile, childFile, extension, true); } }
第五步：编写 UploadCtl.java （测试可用 Postman）
package com.zhwlt.logistics.controller.system; import com.zhwlt.logistics.controller.base.BaseController; import com.zhwlt.logistics.pojo.system.CommonResult; import com.zhwlt.logistics.utils.FileuploadUtil; import io.swagger.annotations.Api; import io.swagger.annotations.ApiOperation; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.multipart.MultipartFile; import java.io.IOException; /** * 上传文件 * * @author lixingwu */ @RestController @RequestMapping("/system") @Api(description = "上传文件类", tags = {"UploadCtl"}) public class UploadCtl extends BaseController{ /** * 方法描述：文件上传，图片也可以使用，但是图片不会被压缩. * 创建时间：2018-10-19 14:10:32 * * @param childFile 上传的父目录 * @param extension 允许上传的文件后缀名 * @author "lixingwu" */ @ApiOperation(value = "文件上传", notes = "图片也可以使用，但是图片不会被压缩") @PostMapping("/uploadFile") public CommonResult uploadFile( MultipartFile multipart, @RequestParam(value = "childFile", required = false, defaultValue = "") String childFile, @RequestParam(value = "extension", required = false, defaultValue = "") String extension ) throws IOException { return resultDataWrapper(FileuploadUtil.saveFile(multipart, childFile, extension)); } /** * 方法描述：图片上传，只能给图片使用，其他文件调用会异常. * 创建时间：2018-10-19 14:10:32 * * @param childFile 上传的父目录 * @param extension 允许上传的文件后缀名 * @author "lixingwu" */ @ApiOperation(value = "图片上传", notes = "只能给图片使用，其他文件调用会异常") @PostMapping("/uploadImage") public CommonResult uploadImage( MultipartFile multipart, @RequestParam(value = "childFile", required = false, defaultValue = "") String childFile, @RequestParam(value = "extension", required = false, defaultValue = "") String extension ) throws IOException { return resultDataWrapper(FileuploadUtil.saveImage(multipart, childFile, extension)); } }