Spring Boot 2.0 多图片上传加回显

点击上方蓝色“程序猿DD”，选择“设为星标”

回复“资源”获取独家整理的学习资料！

来源：http://r6f.cn/crEY

这两天公司有需求让做一个商户注册的后台功能，其中需要商户上传多张图片并回显。由于之前没做过这方面的东西，此篇文章用以记录一些知识点，以便后续查看。

上传

Controller的代码非常简单，由于用了SpringMVC框架，所以直接用MultipartFile来接即可。由于是多图片上传所以用数组来接。此处应该注意参数名应该和<input>中的name值相对应

@RequestMapping("/pic")
@ResponseBody
public ResponseEntity<String> pic(MultipartFile [] pictures) throws Exception {ResponseEntity<String> responseEntity = new ResponseEntity<>();long count = Arrays.asList(pictures).stream().map(MultipartFile::getOriginalFilename).filter(String::isEmpty).count();if (count == pictures.length){responseEntity.setCode(ResponseEntity.ERROR);throw new NullOrEmptyException("图片不能同时为空");}responseEntity.setCode(ResponseEntity.OK);responseEntity.setMessage("上传成功");return responseEntity;
}

前端页面的代码，此处的name值和Controller的参数名称是对应的

<div class="container"><div class="avatar-upload"><div class="avatar-edit"><input type='file' name="pictures" id="imageOne" accept=".png, .jpg, .jpeg"/><label for="imageOne"></label></div><div class="avatar-preview"><div id="imageOnePreview"style="background-image: url(http://ww3.sinaimg.cn/large/006tNc79ly1g556ca7ovqj30ak09mta2.jpg);"></div></div></div>
</div>

js代码回显

function readURLOne(input) {if (input.files && input.files[0]) {var reader = new FileReader();reader.onload = function(e) {$('#imageOnePreview').css('background-image', 'url("+e.target.result +")");$('#imageOnePreview').hide();$('#imageOnePreview').fadeIn(650);}reader.readAsDataURL(input.files[0]);}
}
$("#imageOne").change(function() {readURLOne(this);
});

js代码上传

function getUpload(){//获取form表单中所有属性 key为name值var formData = new FormData($("#picForm")[0]);$.ajax({url: '/pic',type: 'POST',dataType:"json",data: formData,processData: false,contentType: false,success:(function(data) {window.confirm(data.message);window.location.reload();}),error:(function(res) {alert("失败");})});
}

效果展示

初始页面如下

上传完图片以后回显为

点击提交以后可将图片上传至后台

配置上传图片的属性

默认情况下只允许上传1MB以下的图片，如果要设置上传图片大小。那么需要在配置文件中如下配置

spring:servlet:multipart:enabled: truemax-file-size: 20MBmax-request-size: 20MB

关于文件的配置有下面几个

spring.servlet.multipart.enabled=true # 是否支持多文件上传
spring.servlet.multipart.file-size-threshold=0B # 文件写入磁盘的阈值
spring.servlet.multipart.location= # 上传文件的保存地址
spring.servlet.multipart.max-file-size=1MB # 上传文件的最大值
spring.servlet.multipart.max-request-size=10MB # 请求的最大值
spring.servlet.multipart.resolve-lazily=false # 是否在文件或参数访问时延迟解析多部分请求

异常处理

异常处理用了Springboot提供的全局异常处理机制。只需要在类上加入@ControllerAdvice注解即可。在方法上加入@ExceptionHandler(想要拦截的异常类)就能拦截所有Controller的异常了。如果想要拦截指定为特定的Controller只需要在@ControllerAdvice(basePackageClasses=想要拦截的Controller)

@ControllerAdvice
@Slf4j
public class CommonExceptionHandler extends ResponseEntityExceptionHandler {@ExceptionHandler(NullOrEmptyException.class)@ResponseBodypublic ResponseEntity<String> nullOrEmptyExceptionHandler(HttpServletRequest request, NullOrEmptyException exception){log.info("nullOrEmptyExceptionHandler");return handleErrorInfo(request, exception.getMessage());}@ExceptionHandler(value = Exception.class)@ResponseBodypublic ResponseEntity<String> defaultErrorHandler(HttpServletRequest request, Exception exception){log.info("defaultErrorHandler");return handleErrorInfo(request, exception.getMessage());}private ResponseEntity<String> handleErrorInfo(HttpServletRequest request, String message) {ResponseEntity<String> responseEntity = new ResponseEntity<>();responseEntity.setMessage(message);responseEntity.setCode(ResponseEntity.ERROR);responseEntity.setData(message);responseEntity.setUrl(request.getRequestURL().toString());return responseEntity;}
}

遇到的坑

如果返回值是模板文件的文件名，那么无论是类上还是方法上都不能加@ResponseBody注解，因为如果加了的话会被解析成Json串返回。
注意前端所传参数名和后端接收参数名一一对应。不然会报405错误
使用IDEA开发如果使用了lombok那么需要在Annotation Processors中将Enable annotation processing打对勾

完整代码地址

https://github.com/modouxiansheng/Doraemon/tree/master/springdemo

往期推荐为什么 Java 中 1000==1000 为 false ？抖音创始人张一鸣：10 年面试 2000 人，混的好的人，都有一个特质黑客使用合法工具接管 Docker 和 Kubernetes 平台居然仅用浏览器，就完成了Spring Boot应用的开发与部署！Stack Overflow 2020 开发者调查中的 21 条关键结果
最后，推荐一个专注分享后端面试要点的公众号「后端面试那些事儿」，置顶标星。每日一篇常问的面试问题，秀的一批~扫描下方二维码关注！