文件上传之Apache-commons-fileupload
一、文件上传
?
? ? ? ? ?使用Apache开源组织提供的文件上传组件完成文件上传功能.
?
? ? ? ?? 1、搭建开发环境
?
? ? ? ? ? ? ? ? ?将commons-fileupload-1.2.2.jar拷贝到web项目的WEB-INF/lib目录
? ? ? ? ? ?中此版本的文件上传组件还需依赖一个commons-io.jar,将该jar包一并
? ? ? ? ? ? ? ??拷贝到web项目的WEB-INF/lib目录中,即完成了环境的搭建。
?
? ? ? ? ? 2、文件上传中主要使用的类和方法
?
? ? ? ? ? ? ? ? ??1>DiskFileItemFactory:该类是创建FileItem的工厂,该类提供了如
? ? ? ? ? ? ? ? ?下常用方法:
?
? ? ? ? ? ? ? ? ? ? ? ? ??setSizeThreshold(int sizeThreshold):该方法用于设置缓冲区大
? ? ? ? ? ? ? ? ? 小,默认大小为10Kb,当上传文件大小大于设置值,fileupload组件会
? ? ? ? ? ? ? ? ?使用临时文件缓存上传文件
?
? ? ? ? ? ? ? ? ? ? ? ? ? ?setRepository(File repository):该方法用于设置临时缓存文件的
? ? ? ? ? ? ? ? ? 目录,默认为System.getProperty("java.io.tmpdir");
?
? ? ? ? ? ? ? ? ? 2>?ServletFileUpload:该类用于处理HTML表单页面中得文件上传域,
? ? ? ? ? ? ? ? ? 将每一个输入域都封装成一个FileItem对象,该类中提供的常用方
? ? ? ? ? ? ? ? ? 法:
?
? ? ? ? ? ? ? ? ? ? ? ? ? ?isMultipartContext(javax.servlet.http.HttpServletRequest ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?request):该方法用于判断form表单的
? ? ? ? ? ? ? ? ? enctype的值是否为:multipart/form-data,如果是则返回true,
? ? ? ? ? ? ? ? ? 否则返回false
?
? ? ? ? ? ? ? ? ? ? ? ? ?? parseRequest(javax.servlet.http.HttpServletRequest
? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? request):该方法用于解析表单域,将每一个表单
? ? ? ? ? ? ? ? ? 项都封装成一个FileItem对象,以一个List的方式返回
?
? ? ? ? ? ? ? ? ? ? 3> FileItem:该类用于封装每一个表单项,提供的常用方法如下:
?
? ? ? ? ? ? ? ? ? ? ? ? ?? isFormField():该方法用于判断FileItem是否是一个普通的文本输
? ? ? ? ? ? ? ? ? ? ? ? ? ? 入域,如果是则返回true,否则返回一个false
?
? ? ? ? ? ? ? ? ? ? ? ? ? ? getString():该方法取得表单输入域的内容,此方法还有一个重载
? ? ? ? ? ? ? ? ? ? ? ? ? ? 方法getString(String encoding):此方法在获得表单域中内容的
? ? ? ? ? ? ? ? ? ? ? ? ? ? 同时指定一个解码方式
?
? ? ? ? ? ? ? ? ? ? ? ? ? ? getName():该方法用于获取上传文件的名称,如果一个FileItem
? ? ? ? ? ? ? ? ? ? ? ? ? ? 所对应的是一个普通的文本域,调用该方法将会返回一个null,只要
? ? ? ? ? ? ? ? ? ?设置了文件域中的name属性值,即使用户没有选择任何要上传的文
? ? ? ? ? ? ? ? ? ? ? ? ? ? ?件,fileupload组件依旧会将其封装到一个FileItem对象之中,只
? ? ? ? ? ? ? ? ? ?是文件名和文件内容为空而已,此时调用getName()方法将会返回
? ? ? ? ? ? ? ? ? ? ? ? ? ? ?""字符串
?
? ? ? ? ? ? ? ? ? ? ? ? ? ??getFieldName():该方法用于获取表单项的名字
?
?
? 二、编写一个文件上传的类
?
? ? ? ? ? ??1、编写一个jsp页面,包含一个form表单
?
?
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html> <head> <title>文件上传</title> </head> <body> <form action="${pageContext.request.contextPath }/servlet/FileUploadServlet" method="post" enctype="multipart/form-data">用户名:<input type="text" name="username"><br>照片1:<input type="file" name="photo1"><br>照片2:<input type="file" name="photo2"><br><input type="submit" value="提交"><input type="reset" value="重置"> </form> </body></html>?
?
? ? ? ? ?2、编写一个Servlet页面处理文件上传? ? ? ? ? ? ? ? ? ??
?
package com.itheima.upload;import java.io.File;import java.io.FileOutputStream;import java.io.IOException;import java.io.InputStream;import java.io.OutputStream;import java.io.PrintWriter;import java.io.Writer;import java.util.ArrayList;import java.util.Iterator;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.FileItemFactory;import org.apache.commons.fileupload.FileUploadException;import org.apache.commons.fileupload.disk.DiskFileItemFactory;import org.apache.commons.fileupload.servlet.ServletFileUpload;import com.itheima.util.UUIDUtil;/** * 这个Servlet是一个文件上传的类 * * @author djj * */public class FileUploadServlet extends HttpServlet {public void doGet(HttpServletRequest request, HttpServletResponse response)throws ServletException, IOException {request.setCharacterEncoding("UTF-8");// 创建一个FileItem的工厂FileItemFactory itemFactory = new DiskFileItemFactory();// 创建一个文件上传的处理器ServletFileUpload fileUpload = new ServletFileUpload(itemFactory);if (!fileUpload.isMultipartContent(request)) {// 如果客户端设置的enctype类型不是multipart/form-data则直接返回return;}// 设置能处理的单个文件的大小为1MfileUpload.setFileSizeMax(1024 * 1024);// 设置最大能处理的文件大小为200MfileUpload.setSizeMax(100 * 1024 * 1024);List itemList = new ArrayList();try {// 解析客户端输入的表单域内容itemList = fileUpload.parseRequest(request);} catch (FileUploadException e) {System.out.println("只能处理enctype类型为:multipart/form-data表单内容!");}// 取得一个itemList的迭代器Iterator iter = itemList.iterator();while (iter.hasNext()) {// 取出的每一项都是一个FileItem类的实例FileItem fileItem = (FileItem) iter.next();if (fileItem.isFormField()) {// 是普通的表单内容// 取得文本框中输入的内容,并设置解码方式为UTF-8String value = fileItem.getString("UTF-8");request.setAttribute("context", value);} else { // 是文件上传域if (fileItem.getName().trim().equals("")) {// 用户没有选择任何上传路径,直接或略continue;}// 执行文件上传操作processFileUpload(fileItem);}}}/** * 该方法用于处理文件的上传 * * @param fileItem,指定要上传的文件域 */private void processFileUpload(FileItem fileItem) {// 取得文件上传的目录String fileUploadPath = getServletContext().getRealPath("/WEB-INF/upload");try {// 取得上传域的输入流,用于得到上传文件InputStream input = fileItem.getInputStream();// 取得源上传文件的路径String resourceFilePath = fileItem.getName();// 截取该上传文件的文件名String fileName = resourceFilePath.substring(resourceFilePath.lastIndexOf("\") + 1);// 构建一个新的上传文件String newFileUploadPath = makeDirs(fileUploadPath, fileName)+ "\" + UUIDUtil.getUUID() + "_" + fileName;// 根据指定的文件构建一个输出流OutputStream out = new FileOutputStream(newFileUploadPath);byte[] b = new byte[1024];int len = -1;while ((len = input.read(b)) != -1) {out.write(b, 0, len);}out.close();input.close();// 删除临时文件fileItem.delete();} catch (IOException e) {e.printStackTrace();}}/** * 该方法构建了不同的目录 * * @param fileUploadPath,文件上传的路径 * @param fileName,文件名 * @return 返回一个新的上传路径 */private String makeDirs(String fileUploadPath, String fileName) {// 取得当前文件名的hashCode码int hashCode = fileName.hashCode();// 取得hashCode的低四位构建一级目录int direcotry1 = hashCode & 0x0f;// 取得hashCode的高四位构建二级目录int directory2 = (hashCode & 0x0f) >> 4;String newFilePath = fileUploadPath + "\" + direcotry1 + "\"+ directory2;File file = new File(newFilePath);if (!file.exists()) {// 创建该目录file.mkdirs();}return newFilePath;}public void doPost(HttpServletRequest request, HttpServletResponse response)throws ServletException, IOException {doGet(request, response);}}?
? ? ? ? ? ? ?3、该Servlet的配置文件如下:
?
<?xml version="1.0" encoding="UTF-8"?><web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> <servlet> <description>This is the description of my J2EE component</description> <display-name>This is the display name of my J2EE component</display-name> <servlet-name>FileUploadServlet</servlet-name> <servlet-class>com.itheima.upload.FileUploadServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>FileUploadServlet</servlet-name> <url-pattern>/servlet/FileUploadServlet</url-pattern> </servlet-mapping> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list></web-app>
?
? ? ? ? ?3、编写一个UUIDUtil工具类用于生成一个唯一的值:
?
package com.itheima.util;import java.util.UUID;/** * 此工具类用于生成一个唯一的值 * @author djj * */public class UUIDUtil {public static String getUUID() {return UUID.randomUUID().toString();}}
?
?
?
?
?