前言
本文为JavaWeb基础文件上传与下载相关知识介绍~，Java全栈学习路线可参考： 【Java全栈学习路线】最全的Java学习路线及知识清单，Java自学方向指引，内含最全Java全栈学习技术清单~
一、文件上传下载概述
1.什么是文件上传下载
所谓文件上传下载就是将本地文件上传到服务器端，从服务器端下载文件到本地的过程。例如目前网站需要上传头像、上传下载图片或网盘等功能都是利用文件上传下载功能实现的。
文件上传下载实际上是两步操作，第一是文件上传，就是将本地文件上传到服务器端，实现文件多用户之间的共享，第二是文件下载，就是将服务器端的文件下载到本地磁盘。
2.文件上传下载实现原理
文件上传及下载实现原理图如下：
文件上传实现流程如下：
- 客户端浏览器通过文件浏览框，选择需要上传的文件内容（其中包括文件路径及文件内容）。
- 客户端浏览器通过点击上传按钮，将本地文件上传到服务器端。
- 服务器端通过程序接收本地文件内容，并将其保存在服务器端磁盘中
文件下载实现流程如下：
客户端浏览器通过点击下载按钮，将服务器端保存的文件下载到本地磁盘。
服务器端通过程序将服务器端文件响应给客户端。
二、文件上传
要实现Web开发的上传功能，通常需要完成两步操作：
一是在Web页面中添加上传输入项；
二是在Servlet中读取上传文件的数据，并保存到本地硬盘中。
上传大多数情况是通过表单的形式提交给服务器，使用标签。使用标签需要注意以下两点：
（1）必须设置name属性，不然浏览器不会发送上传文件的数据。
（2）必须将method属性设置为post，ectype属性设置为“multipart/form-data”类型。
文件上传的注意事项：
（1）为保证服务器安全，.上传文件应该放在外界无法直接访问的目录下， 比如放于WEB-INF目录下
（2）为防止文件覆盖的现象发生，要为上传文件产生一个唯一的文件名
（3）要限制上传文件的最大值
（4）可以限制上传文件的类型,在收到上传文件名时，判断后缀名是否合法
由于在Servlet直接读取上传数据，并且解析出相应文件数据是一项非常麻烦的工作。为了方便处理上传数据，Apache组织提供了一个开源组件Commons-FileUpload。该组件可以将“multipart/form-data”类型请求的各种表单域解析出来，并实现一个或多个文件上传，同时也可以限制上传文件的大小等内容。其性能十分优异，使用极其简单。
文件上传示例如下：
1.创建Web项目，导包
首先，创建一个Web项目，导入开源组件Commons-FileUpload的两个jar包：
- commons-fileupload-1.3.3.jar
- commons-io-2.6.jar
2.创建文件上传页面
<!DOCTYPE html> <html> <head lang="en"> <meta charset="UTF-8"> <title>文件上传</title> </head> <body> <!--表单的enctype属性要设置为multipart/form-data--> <form action="UploadServlet" method="post" enctype="multipart/form-data"> <table width="600"> <tr> <td>上传者</td> <td><input type="text" name="name"/></td> </tr> <tr> <td>上传文件</td> <td><input type="file" name="myfile"/></td> </tr> <tr> <!--设置单元格可横跨的列数。--> <td colspan="2"><input type="submit" value="上传"/></td> </tr> </table> </form> </body> </html>
3.创建Servlet
package cn.itcast.fileupload; import org.apache.commons.fileupload.FileItem; import org.apache.commons.fileupload.disk.DiskFileItemFactory; import org.apache.commons.fileupload.servlet.ServletFileUpload; import javax.servlet.ServletException; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.*; import java.util.List; import java.util.UUID; /** * Created by lc on 2018/8/24. */ @WebServlet(name = "UploadServlet",urlPatterns = "/UploadServlet") public class UploadSevlet extends HttpServlet { protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { doGet(request,response); } protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { try{ response.setContentType("text/html;charset=utf-8"); //1.创建DiskFileItemFactory工厂对象，处理文件上传路径或大小限制 DiskFileItemFactory factory=new DiskFileItemFactory(); //设置文件缓存目录，如果该文件夹不存在则创建一个 File f=new File("S:\\TempFolder"); if (!f.exists()){ f.mkdirs(); } factory.setRepository(f); //2.创建并获取ServletFileUpload对象 ServletFileUpload fileUpload=new ServletFileUpload(factory); //设置字符编码 fileUpload.setHeaderEncoding("utf-8"); //3.处理上传的文件，先解析request，将form表单的各个字段封装为FileItem对象 List<FileItem> fileItems = fileUpload.parseRequest(request); //获取字符流 PrintWriter writer=response.getWriter(); //遍历List集合 for (FileItem fileItem:fileItems) { //判断是否为普通字段 if (fileItem.isFormField()){ //获取字段名称 String name = fileItem.getFieldName(); if(name.equals("name")){ //如果字段值不为空 if (!fileItem.getString().equals("")){ String value=fileItem.getString("utf-8"); writer.print("上传者："+value+"<br />"); } } } else { //获取上传的文件名 String filename=fileItem.getName(); //处理上传文件 if(filename!=null&&filename!=""){ writer.print("上传的文件名称是："+filename+"<br />"); //保持文件名唯一 filename= UUID.randomUUID().toString()+"_"+filename; String webpath="/upload/"; //创建文件路径 String filepath=getServletContext().getRealPath(webpath+filename); //创建File对象 File file=new File(filepath); //创建文件夹 file.getParentFile().mkdirs(); //创建文件 file.createNewFile(); //获取上传文件流 InputStream in=fileItem.getInputStream(); //使用 FileOutputStream打开服务器端的上传文件 FileOutputStream out=new FileOutputStream(file); //流的对拷 byte[] bytes=new byte[1024];//每次读取一个字节 int len; //开始读取上传文件的字节，并将其输出到服务器端的上传文件输出流中 while ((len=in.read(bytes))>0) out.write(bytes,0,len); in.close(); out.close(); fileItem.delete(); writer.print("文件上传成功！"); } } } }catch (Exception e){ throw new RuntimeException(e); } } }
4.查看运行结果
三、文件下载
1.创建文件下载页面
<!DOCTYPE html> <html> <head lang="en"> <meta charset="UTF-8"> <title>文件下载</title> </head> <body> <a href="/Download?filename=1.jpg">文件下载</a> </body> </html>
2.创建Servlet
package cn.itcast.fileupload; import javax.servlet.ServletException; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.IOException; import java.io.InputStream; import java.io.OutputStream; /** * Created by lc on 2018/8/24. */ @WebServlet(name = "DownloadServlet",urlPatterns = "/Download") public class DownloadServlet extends HttpServlet { protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { doGet(request,response); } protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { response.setContentType("text/html;charset=utf-8"); //获取文件名 String filename = request.getParameter("filename"); //文件所在的文件夹 String folder="/download/"; //通知浏览器以下载的方式打开 response.addHeader("Content-Type","application/octet-stream"); response.addHeader("Content-Disposition","attachment;filename="+filename); //通过文件输入流读取文件 InputStream in=getServletContext().getResourceAsStream(folder+filename); OutputStream out=response.getOutputStream(); byte[] bytes=new byte[1024]; int len=0; while ((len=in.read(bytes))!=-1){ out.write(bytes,0,len); } } }
3.在项目发布目录，创建download文件夹，并且放置一个jpg文件
4.查看运行结果
后记
Java全栈学习路线可参考：【Java全栈学习路线】最全的Java学习路线及知识清单，Java自学方向指引，内含最全Java全栈学习技术清单~
