SpringBoot 2.0 多圖片上傳加回顯

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

上傳

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 # 是否在檔案或引數訪問時延遲解析多部分請求

異常處理

異常處理用了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;
    }
}

遇到的坑

• 如果返回值是模板檔案的檔名，那麼無論是類上還是方法上都不能加@ResponseBody註解，因為如果加了的話會被解析成Json串返回。

• 注意前端所傳引數名和後端接收引數名一一對應。不然會報405錯誤

• 使用IDEA開發如果使用了lombok那麼需要在Annotation Processors中將Enable annotation processing打對勾

  

完