前端配置
普通的form表单图片上传
仅支持post请求
<form action="/website/realAuthUpload.do" enctype="multipart/form-data" method="post"> <input type="file" name="file"> <input type="submit"> </form>
使用dropzone框架
dropzone CDN https://www.bootcdn.cn/dropzone/
<link href="https://cdn.bootcss.com/dropzone/5.5.1/min/basic.min.css" rel="stylesheet"> <link href="https://cdn.bootcss.com/dropzone/5.5.1/min/dropzone.min.css" rel="stylesheet"> <script src="https://cdn.bootcss.com/dropzone/5.5.1/min/dropzone.min.js"></script>
或者去官网下载(dist文件)
介绍
它是轻量级的,不依赖于任何其他库(如jQuery),并且是高度可定制的。
使用Dropzone
只需要一个 div
元素,用 JavaScript 代码启用即可
html结构
<div id="dropz" class="dropzone"></div>
JavaScript 启用代码如下:
var myDropzone = new Dropzone("#dropz", { url: "/upload", dictDefaultMessage: '拖动文件至此或者点击上传', // 设置默认的提示语句 paramName: "dropzFile", // 传到后台的参数名称 init: function () { this.on("success", function (file, data) { // 上传成功触发的事件 }); } });
其中 url
是必须的值,指明文件上传提交到哪个页面。其他的值都是可选的,如果使用默认值的话可以省略
详细配置 Dropzone
功能选项
url
:最重要的参数,指明了文件提交到哪个页面method
:默认为post
,如果需要,可以改为put
paramName
:相当于<input>
元素的name
属性,默认为file
maxFilesize
:最大文件大小,单位是 MBmaxFiles
:默认为 null,可以指定为一个数值,限制最多文件数量addRemoveLinks
:默认 false。如果设为 true,则会给文件添加一个删除链接acceptedFiles
:指明允许上传的文件类型,格式是逗号分隔的 MIME type 或者扩展名。例如:image/*, application/pdf, .psd, .obj
uploadMultiple
:指明是否允许 Dropzone 一次提交多个文件。默认为 false。如果设为 true,则相当于 HTML 表单添加 multiple 属性headers
:如果设定,则会作为额外的 header 信息发送到服务器。例如:{"custom-header": "value"}
init
:一个函数,在 Dropzone 初始化的时候调用,可以用来添加自己的事件监听器forceFallback
:Fallback 是一种机制,当浏览器不支持此插件时,提供一个备选方案。默认为 false。如果设为 true,则强制 fallbackfallback
:一个函数,如果浏览器不支持此插件则调用
翻译选项
dictDefaultMessage
:没有任何文件被添加的时候的提示文本dictFallbackMessage
:Fallback 情况下的提示文本dictInvalidInputType
:文件类型被拒绝时的提示文本dictFileTooBig
:文件大小过大时的提示文本dictCancelUpload
:取消上传链接的文本dictCancelUploadConfirmation
:取消上传确认信息的文本dictRemoveFile
:移除文件链接的文本dictMaxFilesExceeded
:超过最大文件数量的提示文本
常用事件
以下事件接收 file
为第一个参数
addedfile
:添加了一个文件时发生removedfile
:一个文件被移除时发生。你可以监听这个事件并手动从服务器删除这个文件uploadprogress
:上传时按一定间隔发生这个事件。第二个参数为一个整数,表示进度,从 0 到 100。第三个参数是一个整数,表示发送到服务器的字节数。当一个上传结束时,Dropzone 保证会把进度设为 100。注意:这个函数可能被以同一个进度调用多次success
:文件成功上传之后发生,第二个参数为服务器响应complete
:当文件上传成功或失败之后发生canceled
:当文件在上传时被取消的时候发生maxfilesreached
:当文件数量达到最大时发生maxfilesexceeded
:当文件数量超过限制时发生
以下事件接收一个 file list
作为第一个参数(仅当 uploadMultiple
被设为 true
时才会发生)
successmultiple
completemultiple
cancelmultiple
特殊事件
totaluploadprogress
:第一个参数为总上传进度,第二个参数为总字节数,第三个参数为总上传字节数。
使用案例
var myDropzone = new Dropzone("#dropz", { url: "/upload", // 文件提交地址 method: "post", // 也可用put paramName: "file", // 默认为file maxFiles: 1,// 一次性上传的文件数量上限 maxFilesize: 2, // 文件大小,单位:MB acceptedFiles: ".jpg,.gif,.png,.jpeg", // 上传的类型 addRemoveLinks: true, parallelUploads: 1,// 一次上传的文件数量 //previewsContainer:"#preview", // 上传图片的预览窗口 dictDefaultMessage: '拖动文件至此或者点击上传', dictMaxFilesExceeded: "您最多只能上传1个文件!", dictResponseError: '文件上传失败!', dictInvalidFileType: "文件类型只能是*.jpg,*.gif,*.png,*.jpeg。", dictFallbackMessage: "浏览器不受支持", dictFileTooBig: "文件过大上传文件最大支持.", dictRemoveLinks: "删除", dictCancelUpload: "取消", init: function () { this.on("addedfile", function (file) { // 上传文件时触发的事件 }); this.on("success", function (file, data) { // 上传成功触发的事件 }); this.on("error", function (file, data) { // 上传失败触发的事件 }); this.on("removedfile", function (file) { // 删除文件时触发的方法 }); } });
后端配置
POM
我们可以使用commons-fileupload:commons-fileupload包中的FileUtils来加快我们处理上传文件
<dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.3.2</version> </dependency>
配置 spring-mvc.xml
需要 Spring 注入 multipartResolver
实例,spring-mvc.xml
增加如下配置:
<!-- 上传文件拦截,设置最大上传文件大小 10M = 10*1024*1024(B) = 10485760 bytes --> <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> <property name="maxUploadSize" value="10485760"/> </bean>
控制器关键代码(示例)
package com.funtl.my.shop.web.admin.web.controller; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.ResponseBody; import org.springframework.web.multipart.MultipartFile; import javax.servlet.http.HttpServletRequest; import java.io.File; import java.io.IOException; import java.util.HashMap; import java.util.Map; import java.util.UUID; /** * 文件上传控制器 * <p>Title: UploadController</p> * <p>Description: </p> * * @author Lusifer * @version 1.0.0 * @date 2018/6/27 0:42 */ @Controller public class UploadController { @ResponseBody @RequestMapping(value = "upload", method = RequestMethod.POST) public Map<String, Object> upload(MultipartFile dropzFile, HttpServletRequest request) { Map<String, Object> result = new HashMap<>(); // 获取上传的原始文件名 String fileName = dropzFile.getOriginalFilename(); // 设置文件上传路径 String filePath = request.getSession().getServletContext().getRealPath("/static/upload"); // 获取文件后缀 String fileSuffix = fileName.substring(fileName.lastIndexOf("."), fileName.length()); // 判断并创建上传用的文件夹 File file = new File(filePath); if (!file.exists()) { file.mkdir(); } // 重新设置文件名为 UUID,以确保唯一 file = new File(filePath, UUID.randomUUID() + fileSuffix); try { // 写入文件 dropzFile.transferTo(file); } catch (IOException e) { e.printStackTrace(); } // 返回 JSON 数据,这里只带入了文件名 result.put("fileName", file.getName()); return result; } }
下面是实际开发中使用的代码
@Autowired private ServletContext servletContext; /** * 千万不要加requiredLogin */ @ResponseBody @PostMapping("realAuthUpload") public String realAuthUpload(MultipartFile file) { // 先得到basepath String basePath = servletContext.getRealPath("/upload"); String fileName = UploadUtil.upload(file, basePath); return "/upload/" + fileName; }
UploadUtil
/** * 上传工具 * * @author Administrator */ public class UploadUtil { /** * 处理文件上传 * * @param basePath 存放文件的目录的绝对路径 servletContext.getRealPath("/upload") */ public static String upload(MultipartFile file, String basePath) { String orgFileName = file.getOriginalFilename(); //FilenameUtils.getExtension(orgFileName)得到文件的扩展名字 String fileName = UUID.randomUUID().toString() + "." + FilenameUtils.getExtension(orgFileName); try { File targetFile = new File(basePath, fileName); FileUtils.writeByteArrayToFile(targetFile, file.getBytes()); //把文件同步到公共文件夹 //File publicFile=new File(BidConst.PUBLIC_IMG_SHARE_PATH,fileName); //FileUtils.writeByteArrayToFile(publicFile, file.getBytes()); } catch (IOException e) { e.printStackTrace(); } return fileName; } }
如果不使用FileUtils
@RequestMapping(value = "/fileupload",method = RequestMethod.POST) public String fileupload(MultipartFile file,HttpServletRequest httpServletRequest) throws IOException { //获取文件的名字 String originalFilename = file.getOriginalFilename(); InputStream inputStream = file.getInputStream(); String path = httpServletRequest.getSession().getServletContext().getRealPath("/")+originalFilename; FileOutputStream fileOutputStream = new FileOutputStream(path,true); int len=-1; byte[] bytes = new byte[1024]; while ((inputStream.read(bytes))!=-1){ fileOutputStream.write(bytes); } fileOutputStream.close(); inputStream.close(); return "login"; }