JavaWeb 之 使用 commons-fileupload.jar 实现文件上传

一、文件上传

  文件的上传和下载,是非常常见的功能,在很多的系统中,或软件中都经常使用文件的上传和下载

  文件的上传主要分为下面几步:

  1、前台页面需要一个 form 标签,里面的 method 为 post 请求;

  2、在 form 标签必须添加 encType属性,且属性值必须是 multipart/form-data值;

  3、在 form 标签中使用 input type=file 添加上传的文件;

  4、在服务器编写代码(Servlet程序)接收,处理上传的数据。

    注意点:

      1. 请求必须是 post,因为 get 请求有长度限制;

      2. encType=multipart/form-data 表示提交的数据,是以多段(每一个表单项一个数据段)的形式进行拼接,然后以二进制流的形式发送给服务器的;

      3. 在服务器端必须以流的方式接收数据;

二、文件上传之 HTTP 协议的说明

    

三、Commons-fileupload.jar 常用 API 

   注意:commons-fileupload.jar 包需要依赖 commons-io.jar这个包,所以需要在项目中引入两个包。

  1、常用API

FileItemFactory      表单项工厂接口
ServletFileUpload    文件上传类,用于解析上传的数据
FileItem             表单项类,表示每一个表单项
boolean ServletFileUpload.isMultipartContent(HttpServletRequest request) 判断当前上传的数据格式是否是多段的格式,只有是多段数据,才能使用该方式 public List<FileItem> parseRequest(HttpServletRequest request) 解析上传的数据,返回包含 表单项的 List 集合 boolean FileItem.isFormField()       判断当前这个表单项,是否是普通的表单项,还是上传的文件类型,true 表示普通类型的表单项;false 表示上传的文件类型 String FileItem.getFieldName()       获取表单项的 name 属性值 String FileItem.getString()     获取当前表单项的值; String FileItem.getName()         获取上传的文件名 void FileItem.write( file )        将上传的文件写到 参数 file 所指向存取的硬盘位置

  

  2、流程图

      

四、案例

  上传文件的表单:

1 <form action="uploadServlet" method="post" enctype="multipart/form-data">
2   用户名: <input type="text" name="username" /> <br>
3   照片: <input type="file" name="photo" > <br>
4   <input type="submit" value="上传">
5 </form>

  解析上传的数据的 Servlet

 1 import org.apache.commons.fileupload.FileItem;
 2 import org.apache.commons.fileupload.FileItemFactory;
 3 import org.apache.commons.fileupload.disk.DiskFileItemFactory;
 4 import org.apache.commons.fileupload.servlet.ServletFileUpload;
 5 
 6 import javax.servlet.ServletException;
 7 import javax.servlet.http.HttpServlet;
 8 import javax.servlet.http.HttpServletRequest;
 9 import javax.servlet.http.HttpServletResponse;
10 import java.io.File;
11 import java.io.IOException;
12 import java.util.List;
13 
14 public class UploadServlet extends HttpServlet {
15     protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
16         //解决中文乱码
17         request.setCharacterEncoding("UTF-8");
18 
19         //1. 先判断上传的的数据是否多段数据(只有是多段的数据,才是文件上传的)
20         if ( ServletFileUpload.isMultipartContent(request) ) {
21 
22             //创建 FileItemFactory 工厂实现类
23             FileItemFactory fileItemFactory = new DiskFileItemFactory();
24             // 2. 创建用于解析上传数据的工具类
25             ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
26 
27             try {
28                 // 3. 解析 上传的数据,得到每一个表单项 FiltItem
29                 List<FileItem> list = servletFileUpload.parseRequest(request);
30 
31                 //循环判断,每一个表单项,是普通类型,还是上传的文件
32                 for (FileItem fileItem : list) {
33 
34                     // 是普通表单项
35                     if ( fileItem.isFormField() ) {
36                         String fieldName = fileItem.getFieldName();
37                         String value = fileItem.getString("UTF-8");
38 
39                         System.out.println("表单项的name属性值 = " + fieldName);
40                         System.out.println("表单项的value属性值 = " + value);
41                     } else {
42                         //是上传的文件
43                         String name = fileItem.getFieldName();
44                         String fieldName = fileItem.getName();
45 
46                         System.out.println("表单项的name属性值 = " + name);
47                         System.out.println("上传的文件名 = " + fieldName);
48 
49                         // 将数据写到指定的位置
50                         fileItem.write(new File( "F:\\" + fileItem.getName()));
51                     }
52                 }
53 
54             } catch (Exception e) {
55                 e.printStackTrace();
56             }
57 
58         }
59 
60 
61     }

  注意:

    这样的上传还有一个小问题,当上传多个同名同类型的文件时,后上传的文件会覆盖掉原来上传的文件,为了解决这一问题,可以在文件名前面加入当前时间的毫秒值即可。

  防止文件覆盖,将数据存储可改成下面这种写法:

fileItem.write(new File( "F:\\" + System.currentTimeMillis() + fileItem.getName()));

  

猜你喜欢

转载自www.cnblogs.com/niujifei/p/12448294.html