[原创]java WEB学习笔记49：文件上传基础，基于表单的文件上传,使用fileuoload 组件

本博客为原创：综合 尚硅谷（http://www.atguigu.com）的系统教程（深表感谢）和 网络上的现有资源(博客，文档，图书等)，资源的出处我会标明

本博客的目的：①总结自己的学习过程，相当于学习笔记 ②将自己的经验分享给大家，相互学习，互相交流，不可商用

内容难免出现问题，欢迎指正，交流，探讨，可以留言，也可以通过以下方式联系。

本人互联网技术爱好者，互联网技术发烧友

微博：伊直都在0221

QQ：951226918

-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

1.基于表单的文件上传

　　1）如果在表单中使用表单元素 <input type=“file” />，浏览器在解析表单时，会自动生成一个输入框和一个按钮，输入框可供用户填写本地文件的文件名和路径名，按钮可以让浏览器打开一个文件选择框供用户选择文件：

　　      

　　2）Enctype 属性

　　① 当表单需要上传文件时，需指定表单 enctype 的值为 multipart/form-data

　　② 在 form 元素的语法中，enctype 属性指定将数据发送到服务器时浏览器使用的编码类型

　　③ enctype 属性取值:

　　　　> application/x-www-form-urlencoded：表单 enctype 属性的默认值。这种编码方案使用有限的字符集，当使用了非字母和数字时，必须用”%HH”代替(H 代表十六进制数字)。对于大容量的二进制数据或包含非 ASCII 字符的文本来说，这种编码不能满足要求

　　　　> multipart/form-data：form 设定了enctype=“multipart/form-data”属性后，表示表单以二进制传输数据

　　3）总结：进行文件上传时，表单需要做的准备

　　　① 请求请求方式为 post  ：<form action="uploadServlet" method="post"   ....... >

　　　② 使用file 表单域  File:<input type="file" name="file"/>

　　　③ 使用请求编码方式 ： enctype="multipart/form-data"

　　　④ 在服务端不能再使用 request.getParameter() 等方式获取请求信息。获取不到，因为请求的编码方式已经为multipart/form-data ，以二进制的方式来提交请求信息，可以使用输入流的方式来获取请求信息

upload.jsp

 <%@ page language="java" contentType="text/html; charset=UTF-8"
     pageEncoding="UTF-8"%>
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Insert title here</title>
 </head>
 <body>

     <form action="uploadServlet" method="post" enctype="multipart/form-data">
         File:<input type="file" name="file"/>
         <br><br>
         Desc:<input type="text" name="desc"/>
         <br><br>
         <input type="submit" value="submit"/>
     </form>

 </body>
 </html>

UploadServlet.java

 package com.jason.fileupload;

 import java.io.BufferedReader;
 import java.io.IOException;
 import java.io.InputStream;
 import java.io.InputStreamReader;
 import java.io.Reader;

 import javax.servlet.ServletException;
 import javax.servlet.annotation.WebServlet;
 import javax.servlet.http.HttpServlet;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;

 /**
  * Servlet implementation class UploadServlet
  */
 @WebServlet("/uploadServlet")
 public class UploadServlet extends HttpServlet {
     private static final long serialVersionUID = 1L;

     /**
      * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response)
      */
     protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
         //1.获取请求信息
 //        String file = request.getParameter("file");
 //        String desc = request.getParameter("desc");
 //
 //        System.out.println(file);
 //        System.out.println(desc);

         //以流的方式处理 上传的代码
         InputStream in = request.getInputStream();

         Reader reader = new InputStreamReader(in);
         BufferedReader bufferedReader = new BufferedReader(reader);

         String str = null;

         while((str = bufferedReader.readLine()) != null){
             System.out.println(str);
         }

     }

 }

2.使用fileuoload 组件

　　1）环境的搭建：加入jar包到 lib目录

　　

　　2）基本思想：

　　① commons-fileupload 可以解析请求，得到一个FileItem 对象组成的List

　  ② commons-fileupload 把请求的信息都解析为FileItem 对象，无论是一个一般的文本域还是一个文件域

　　③ 可以调用 FileItem 的 isFormField() 方法来判断是一个表单域 或不是表单域(则是一个文件域)

　　④ 进一步获取信息

　　　　

 // Process a regular form field
 if (item.isFormField()) {
     String name = item.getFieldName();
     String value = item.getString();
     ...
 }

　

 // Process a file upload
 if (!item.isFormField()) {
     String fieldName = item.getFieldName();
     String fileName = item.getName();
     String contentType = item.getContentType();
     boolean isInMemory = item.isInMemory();
     long sizeInBytes = item.getSize();
     ...
 }

　　3） 如何得到List<FileItem> 对象

简单方式：

 // Create a factory for disk-based file items
 FileItemFactory factory = new DiskFileItemFactory();

 // Create a new file upload handler
 ServletFileUpload upload = new ServletFileUpload(factory);

 // Parse the request
 List /* FileItem */ items = upload.parseRequest(request);

复杂方式：可以对文件的上床加入限制条件和其他属性

 // Create a factory for disk-based file items
 DiskFileItemFactory factory = new DiskFileItemFactory();

 // Set factory constraints
 factory.setSizeThreshold(yourMaxMemorySize);//设置内存中最多可以存放的上传的文件的大小，若超出则把文件写到一个临时文件夹中，以 byte 为单位
 factory.setRepository(yourTempDirectory);//设置那个临时文件夹

 // Create a new file upload handler
 ServletFileUpload upload = new ServletFileUpload(factory);

 // Set overall request size constraint
 upload.setSizeMax(yourMaxRequestSize);//设置整个文件的大小

 // Parse the request
 List /* FileItem */ items = upload.parseRequest(request);

helloword.java测试

 package com.jason.fileupload;

 import java.io.BufferedReader;
 import java.io.File;
 import java.io.FileOutputStream;
 import java.io.IOException;
 import java.io.InputStream;
 import java.io.InputStreamReader;
 import java.io.OutputStream;
 import java.io.Reader;
 import java.util.List;

 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 org.apache.commons.fileupload.FileItem;
 import org.apache.commons.fileupload.FileUploadException;
 import org.apache.commons.fileupload.disk.DiskFileItemFactory;
 import org.apache.commons.fileupload.servlet.ServletFileUpload;

 /**
  * Servlet implementation class UploadServlet
  */
 @WebServlet("/upload/uploadServlet")
 public class UploadServlet extends HttpServlet {
     private static final long serialVersionUID = 1L;

     /**
      * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse
      *      response)
      */
     protected void doPost(HttpServletRequest request,
             HttpServletResponse response) throws ServletException, IOException {
         // 1.得到FileIrem 的集合 items
         // Create a factory for disk-based file items
         DiskFileItemFactory factory = new DiskFileItemFactory();

         // Set factory constraints
         factory.setSizeThreshold(1024 * 500);
         File tempDirectory = new File("e:\\tempDirectory");
         factory.setRepository(tempDirectory);

         // Create a new file upload handler
         ServletFileUpload upload = new ServletFileUpload(factory);

         // Set overall request size constraint
         upload.setSizeMax(1024 * 1024 * 5);

         // Parse the request
         try {
             List<FileItem> items = upload.parseRequest(request);
             // 2.遍历items：若是一般表单域，打印信息
             for (FileItem item : items) {
                 if (item.isFormField()) {
                     String name = item.getFieldName();
                     String value = item.getString();
                     System.out.println(name + " : " + value);
                 } else {
                     // 3.若是文件域则把文件保存到目录 files
                     String fieldName = item.getFieldName();
                     String fileName = item.getName();
                     String contentType = item.getContentType();
                     long sizeInBytes = item.getSize();

                     System.out.println(fieldName);
                     System.out.println(fileName);
                     System.out.println(contentType);
                     System.out.println(sizeInBytes);

                     InputStream in = item.getInputStream();
                     byte[] buffer = new byte[1024];
                     int len = 0;
                     fileName = "e:\\file\\" + fileName;
                     System.out.println(fileName);

                     OutputStream out = new FileOutputStream(fileName);
                     while ((len = in.read(buffer)) != -1) {
                         out.write(buffer, 0, len);
                     }
                     out.close();
                     in.close();
                 }
             }

         } catch (FileUploadException e) {
             e.printStackTrace();
         }

     }

 }

upload.jsp

 <%@ page language="java" contentType="text/html; charset=UTF-8"
     pageEncoding="UTF-8"%>
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 <title>Insert title here</title>
 </head>
 <body>

     <form action="uploadServlet" method="post" enctype="multipart/form-data">
         File:<input type="file" name="file"/>
         <br><br>
         Desc:<input type="text" name="desc"/>
         <br><br>
         <input type="submit" value="submit"/>
     </form>

 </body>
 </html>