Spring Boot 實現多圖片上傳並回顯，漲姿勢了～

作者：不學無數的程序員

鏈接：https://www.jianshu.com/p/3e28b94444be

這兩天公司有需求讓做一個商戶註冊的後臺功能，其中需要商戶上傳多張圖片並回顯。由於之前沒做過這方面的東西，此篇文章用以記錄一些知識點，以便後續查看。

上傳

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: true
      max-file-size: 20MB
      max-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 # 是否在文件或參數訪問時延遲解析多部分請求

Spring Boot 基礎教程和示例源碼：https://github.com/javastacks/spring-boot-best-practice

異常處理

異常處理用了Springboot提供的全局異常處理機制。只需要在類上加入@ControllerAdvice註解即可。在方法上加入@ExceptionHandler(想要攔截的異常類)就能攔截所有Controller的異常了。

如果想要攔截指定爲特定的Controller只需要在@ControllerAdvice(basePackageClasses=想要攔截的Controller)

@ControllerAdvice
@Slf4j
public class CommonExceptionHandler extends ResponseEntityExceptionHandler {

    @ExceptionHandler(NullOrEmptyException.class)
    @ResponseBody
    public ResponseEntity<String> nullOrEmptyExceptionHandler(HttpServletRequest request, NullOrEmptyException exception){
        log.info("nullOrEmptyExceptionHandler");
        return handleErrorInfo(request, exception.getMessage());
    }

    @ExceptionHandler(value = Exception.class)
    @ResponseBody
    public 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;
    }
}