SpringMVC注解实现上传下载
Jony_zhang 人气:0一、文件下载
1-1、servlet原生方式下载
/** * 基于servlet api的文件下载 */ @RequestMapping("/download") public String download(HttpServletRequest request,HttpServletResponse response) throws IOException { // 获得当前项目路径下的下载文件(真实开发中文件名肯定是从数据中读取的) String realPath =request.getServletContext().getRealPath("/file/20181129204254948.png"); // 根据文件路径封装成了File对象 File tmpFile=new File(realPath); // 可以直接根据File对象获得文件名 String fileName = tmpFile.getName(); // 设置响应头 content-disposition: 就是设置文件下载的打开方式,默认会在网页上打开, // 设置attachment;filename= 就是为了以下载方式来打开文件 // "UTF-8"设置如果文件名有中文就不会乱码 response.setHeader("content-disposition", "attachment;filename="+ URLEncoder.encode(fileName, "UTF-8")); // 根据文件路径 封装成文件输入流 InputStream in = new FileInputStream(realPath); int len = 0; // 声明了一个1KB的字节 的缓冲区 byte[] buffer = new byte[1024]; // 获取输出流 OutputStream out = response.getOutputStream(); // 循环读取文件,每次读1KB,避免内存溢出 while ((len = in.read(buffer)) > 0) { // 往客户端写入 out.write(buffer,0,len);//将缓冲区的数据输出到客户端浏览器 } in.close(); return null; }
以上代码中需要注意的地方我们设置了响应头
response.setHeader("content-disposition", "attachment;filename="+ URLEncoder.encode(fileName, "UTF-8"));
其中content-disposition可以让前端以文件的形式下载,否则就会直接在浏览器打开了
1-2、使用ResponseEntity实现下载
可以同时定制响应数据的内容、响应头以及响应状态码
1-2-1、使用ResponseEntity实现响应内容的定制。
一般在前后端分离的场景中,前端请求后端的接口,后端一般会返回三个值,分别为:请求状态、请求数据,以及请求信息。使用ResponseEntity就可以帮助我们定制这样的内容。
通过上图我们可以看到,通过ResponseEntity可以返回相关数据、也可以设置响应头、以及状态码。
另外需要注意的是,可以看到方法的返回类型是是Response< String> 那我们在返回ResponseEntity的时候,第一个参数一定是String类型。这个就是返回泛型的值。
2-2-2、使用ResponseEntity下载文件
/** * 基于servlet api的文件下载 */ @RequestMapping("/download02") public ResponseEntity<byte[]> download02(HttpServletRequest request) throws IOException { // 获得当前项目路径下的下载文件(真实开发中文件名肯定是从数据中读取的) String realPath =request.getServletContext().getRealPath("/file/20181129204254948.png"); // 根据文件路径封装成了File对象 File tmpFile=new File(realPath); // 可以直接根据File对象获得文件名 String fileName = tmpFile.getName(); HttpHeaders headers=new HttpHeaders(); headers.set("content-disposition", "attachment;filename="+ URLEncoder.encode(fileName, "UTF-8")); // 根据文件路径 封装成文件输入流 InputStream in = new FileInputStream(realPath); return new ResponseEntity<>(new byte[in.available()],headers,HttpStatus.OK); }
可以看到使用ResponseEntity也可以同样下载数据,但是无法设置缓冲区,只能全部一次性读取。
1-2-3、servlet下载和ResponseEntity下载区别
两者区别,使用原生servlet下载,我们可以设置缓冲区,但是使用ResponseEntity就无法进行设置,只能将文件的全部数据以字节数组的方式一次性读取。为了避免内存溢出,建议使用servlet原生的方式下载
二、文件上传
Spring MVC 为文件上传提供了直接的支持,这种支持是通过即插即用的 MultipartResolver 实现的。Spring 用 Jakarta Commons FileUpload 技术实现了一个 MultipartResolver 实现类:CommonsMultipartResovler
Spring MVC 上下文中默认没有装配 MultipartResovler,因此默认情况下不能处理文件的上传工作,如果想使用 Spring 的文件上传功能,需现在上下文中配置 MultipartResolver。
2-1、添加commons-fileupload依赖
下载基于Jakarta Commons FileUpload的上传支持jar包
<!-- https://mvnrepository.com/artifact/commons-fileupload/commons-fileupload --> <dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.4</version> </dependency>
如果使用idea一定要手动再导入一下包(导入方式可以看之前的文章)
2-2、配置spring.xml注入CommonsMultipartResolver文件上传解析器
<!--注入基于CommonsMultipartResolver文件上传解析器--> <bean class="org.springframework.web.multipart.commons.CommonsMultipartResolver" id="multipartResolver"> <!--设置编码集,防止出现中文乱码--> <property name="defaultEncoding" value="UTF-8"></property> <!--设置最大上传字节 配置10MB--> <property name="maxUploadSize" value="#{1024*1024*10}"></property> </bean>
2-3、文件上传
2-3-1、单个文件上传
2-3-1-1、编写控制器方法
/** * 基于springmvc MultiPartResolver文件上传 * @param desc * @param multipartFile * @return * @throws IOException */ @PostMapping("/upload01") public String upload01(String desc, @RequestParam("myfile") MultipartFile multipartFile) throws IOException { System.out.println(desc); System.out.println(multipartFile.getOriginalFilename()); String path = "d:\\img\\" + multipartFile.getOriginalFilename(); File file = new File(path); multipartFile.transferTo(file); return "success"; }
2-3-1-2、视图层
<form enctype="multipart/form-data" action="${pageContext.request.contextPath}/upload01" method="post"> <p>文件描述:<input type="text" name="desc" /></p> <p>文件:<input type="file" name="myfile" accept="image/*"/></p> <p><input type="submit" value="上传单个文件"></p> </form>
2-3-2、多文件上传
2-3-2-1、编写控制器方法
/** * 基于springmvc MultiPartResolver多文件文件上传 * @param desc * @param myfile * @return * @throws IOException */ @PostMapping("/upload02") public String upload02(String desc,MultipartFile[] myfile) throws IOException { for (MultipartFile multipartFile : myfile) { System.out.println(desc); System.out.println(multipartFile.getOriginalFilename()); String path = "d:\img\" + multipartFile.getOriginalFilename(); File file = new File(path); multipartFile.transferTo(file); } return "success"; }
2-3-2-2、视图层
视图层我们可以控制file上传的文件是否多选可以使用mutiple="mutiple" 在h5中如果属性和值相等,可以将值省略,然后设置了accept属性,可以在用户选择的时候自动过滤,如下面代码只显示图片类型的文件
<form enctype="multipart/form-data" action="${pageContext.request.contextPath}/upload03" method="post"> <p>文件描述:<input type="text" name="desc" /></p> <p>文件:<input type="file" name="myfile" multiple accept="image/*"/></p> <p><input type="submit" value="上传多个文件"></p> </form>
2-3-3、通过多线程的方式批量上传文件
上面举例中,使用了多文件上传,利用for的方式虽然可以逐个读取文件并上传,但是在某些场景下,这样就效率就降低了很多,为了提高我们上传的效率,可以利用多线程的方式来进行上传。
2-3-3-4、编写控制器方法
/** * 基于springmvc MultiPartResolver多文件文件上传--多线程 * @param desc * @param myfile * @return * @throws IOException */ @PostMapping("/upload03") public String upload03(String desc,MultipartFile[] myfile) throws IOException, InterruptedException { System.out.println(desc); for (MultipartFile multipartFile : myfile) { // 声明线程 Thread thread = new Thread(() -> { System.out.println(multipartFile.getOriginalFilename()); String path = "d:\img\" + multipartFile.getOriginalFilename(); File file = new File(path); try { multipartFile.transferTo(file); } catch (IOException e) { e.printStackTrace(); } }); thread.start(); //启动线程 thread.join(); // 让子线程执行完再执行主线程 } return "success"; }
加载全部内容