SpringBoot 2.0 多圖片上傳加回顯

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打對勾

完整代碼地址