java：文件上传

上传(上传不能使用BaseServlet)

1. 上传对表单限制

• method=“post”
• enctype=“multipart/form-data”
• 表单中需要添加文件表单项：

用户名；
照　片：

2. 上传对Servlet限制

• request.getParametere(“xxx”);这个方法在表单为enctype="multipart/form-data"时，它作废了。它永远都返回null
• ServletInputStream request.getInputStream();包含整个请求的体！

---

多部件表单的体

1. 每隔出多个部件，即一个表单项一个部件。
2. 一个部件中自己包含请求头和空行，以及请求体。
3. 普通表单项：

1个头：Content-Disposition：包含name=“xxxx”，即表单项名称。
体就是表单项的值

4. 文件表单项：

2个头：
* Content-Disposition：包含name=“xxxx”，即表单项名称；还有一个filename=“xxx”，表示上传文件的名称
* Content-Type：它是上传文件的MIME类型，例如：image/pjpeg，表示上传的是图片，图上中jpg扩展名的图片。
体就是上传文件的内容。

===========================================

commons-fileupload

• commons-fileupload.jar
• commons-io.jar

这个小组件，它会帮我们解析request中的上传数据，解析后的结果是一个表单项数据封装到一个FileItem对象中。我们只需要调用FileItem的方法即可！

－－－－－－－－－－－－－－－

1. 上传三步
   相关类：

• 工厂：DiskFileItemFactory
• 解析器：ServletFileUpload
• 表单项：FileItem

1). 创建工厂：DiskFileItemFactory factory = new DiskFileItemFactory();
2). 创建解析器：ServletFileUpload sfu = new ServletFileUpload(factory);
3). 使用解析器来解析request，得到FileItem集合：List fileItemList = sfu.parseRequest(request);

2. FileItem

• boolean isFormField()：是否为普通表单项！返回true为普通表单项，如果为false即文件表单项！
• String getFieldName()：返回当前表单项的名称；
• String getString(String charset)：返回表单项的值；
• String getName()：返回上传的文件名称
• long getSize()：返回上传文件的字节数
• InputStream getInputStream()：返回上传文件对应的输入流
• void write(File destFile)：把上传的文件内容保存到指定的文件中。
• String getContentType();

－－－－－－－－－－－－－－－

上传的细节：

1. 文件必须保存到WEB-INF下！

• 目的是不让浏览器直接访问到！
• 把文件保存到WEB-INF目录下！

2. 文件名称相关问题
   　* 有的浏览器上传的文件名是绝对路径，这需要切割！C:\files\baibing.jpg
   String filename = fi2.getName();
   int index = filename.lastIndexOf("\");
   if(index != -1) {
   filename = filename.substring(index+1);
   }

• 文件名乱码或者普通表单项乱码：request.setCharacterEncoding(“utf-8”);因为fileupload内部会调用request.getCharacterEncoding();

  request.setCharacterEncoding(“utf-8”);//优先级低
  servletFileUpload.setHeaderEncoding(“utf-8”);//优先级高

• 文件同名问题；我们需要为每个文件添加名称前缀，这个前缀要保证不能重复。uuid

  filename = CommonUtils.uuid() + “_” + filename;

3. 目录打散

• 不能在一个目录下存放之多文件。

  首字符打散：使用文件的首字母做为目录名称，例如：abc.txt，那么我们把文件保存到a目录下。如果a目录这时不存在，那么创建之。
  时间打散：使用当前日期做为目录。
  哈希打散：

  • 通过文件名称得到int值，即调用hashCode()
  • 它int值转换成16进制0~9, A~F
  • 获取16进制的前两位用来生成目录，目录为二层！例如：1B2C3D4E5F，/1/B/保存文件。

4. 上传文件的大小限制

• 单个文件大小限制

  sfu.setFileSizeMax(100*1024)：限制单个文件大小为100KB
  上面的方法调用，必须在解析开始之前调用！
  如果上传的文件超出限制，在parseRequest()方法执行时，会抛出异常！FileUploadBase.FileSizeLimitExceededException

• 整个请求所有数据大小限制

  sfu.setSizeMax(1024 * 1024);//限制整个表单大小为1M
  这个方法也是必须在parseRequest()方法之前调用
  如果上传的文件超出限制，在parseRequest()方法执行时，会抛出异常！FileUploadBase.SizeLimitExceededException

5. 缓存大小与临时目录

• 缓存大小：超出多大，才向硬盘保存！默认为10KB
• 临时目录：向硬盘的什么目录保存
  设置缓存大小与临时目录：new DiskFileItemFactory(20*1024, new File(“F:/temp”))
  例1、
  UploadServlet.java文件

package day21_1;

import java.io.File;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.List;

import javax.servlet.ServletException;
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;

public class UploadServlet extends HttpServlet {

	public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

		request.setCharacterEncoding("utf-8");
		response.setContentType("text/htm;charset=utf-8");
		/*
		 * 上传三步
		 * 1. 得到工厂
		 * 2. 通过工厂创建解析器
		 * 3. 解析request，得到FileItem集合
		 * 4. 遍历FileItem集合，调用其API完成文件的保存
		 */
		DiskFileItemFactory factory=new DiskFileItemFactory();
		ServletFileUpload sfu=new ServletFileUpload(factory);
//		sfu.setFileSizeMax(100 * 1024);//限制单个文件大小为100K
//		sfu.setSizeMax(1024 * 1024);//限制整个表单大小为1M
		try {
			List<FileItem> fileItemList=sfu.parseRequest(request);
			FileItem fi1=fileItemList.get(0);
			FileItem fi2=fileItemList.get(1);
			System.out.println("普通表单项演示"+fi1.getFieldName()+"="+fi1.getString("UTF-8"));
			System.out.println("文本表单项演示:");
			System.out.println("contentType="+fi2.getContentType());
			System.out.println("size="+fi2.getSize());
			System.out.println("filename:"+fi2.getName());
			//保存文件
			File destFile= new File("d:/upload.jpg");
			try {
				fi2.write(destFile);
			} catch (Exception e) {
				throw new RuntimeException(e);
			}
		} catch (FileUploadException e) {
			throw new RuntimeException(e);
		}
		
	}

}

例2、UploadServlet2.java文件

package day21_1;

import java.io.File;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.List;

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

import cn.itcast.commons.CommonUtils;

public class UploadServlet2 extends HttpServlet {

	public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
		request.setCharacterEncoding("utf-8");
		response.setContentType("text/htm;charset=utf-8");
		/*
		 * 上传三步
		 */
		// 工厂:设置了缓存大小和临时目录
		DiskFileItemFactory factory = new DiskFileItemFactory(20*1024, new File("D:/d/temp"));
		// 解析器
		ServletFileUpload sfu = new ServletFileUpload(factory);
		try {
			List<FileItem> list = sfu.parseRequest(request);
			FileItem fi=list.get(1);
			//
			//目录打散！
			/*
			 * 1. 得到文件保存的路径
			 */
			String root = this.getServletContext().getRealPath("/WEB-INF/files/");
			/*
			 * 2. 生成二层目录
			 *   1). 得到文件名称
			 *   2). 得到hashCode
			 *   3). 转发成16进制
			 *   4). 获取前二个字符用来生成目录
			 */
			String filename=fi.getName();//获取上传的文件名称
			/*
			 * 处理文件名的绝对路径问题
			 */
			int index=filename.lastIndexOf("\\");
			if(index!=-1){
				filename=filename.substring(index+1);
			}
			/*
			 * 给文件名称添加uuid前缀，处理文件同名问题
			 */
			String savename=CommonUtils.uuid()+"_"+filename;
			/*
			 * 1. 得到hashCode
			 */
			int hCode=filename.hashCode();
			String hex=Integer.toHexString(hCode);
			/*
			 * 2. 获取hex的前两个字母，与root连接在一起，生成一个完整的路径
			 */
			File dirFile=new File(root,hex.charAt(0)+"/"+hex.charAt(1));
			/*
			 *3、创建目录链
			 */
			dirFile.mkdirs();
			/*
			 * 4、创建目录文件
			 */
			File destFile=new File(dirFile,savename);
			/*
			 * 保存
			 */
			fi.write(destFile);
			//
		} catch (FileUploadException e) {
			if(e instanceof FileUploadBase.FileSizeLimitExceededException) {
				request.setAttribute("msg", "您上传的文件超出了100KB！");
				request.getRequestDispatcher("/upload2.jsp").forward(request, response);
			}
		} catch (Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
		
		
	}

}

jsp表单：

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ page isELIgnored="false" %>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <base href="<%=basePath%>">
    
    <title>My JSP 'upload2.jsp' starting page</title>
    
	<meta http-equiv="pragma" content="no-cache">
	<meta http-equiv="cache-control" content="no-cache">
	<meta http-equiv="expires" content="0">    
	<meta http-equiv="keywords" content="keyword1,keyword2,keyword3">
	<meta http-equiv="description" content="This is my page">
	<!--
	<link rel="stylesheet" type="text/css" href="styles.css">
	-->

  </head>
  
  <body>
  <h1>上传文件</h1>
  <h3>${msg }</h3>
   <form action="<c:url value='/UploadServlet2' />" method="post" enctype="multipart/form-data">
     用户名：<input type="text" name="username" /><br/>
    照    片：<input type="file" name="zhaoPian"/><br/>
	<input type="submit" value="上传" />
   </form>
  </body>
</html>