[原创]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>