在servlet技术出现之后不久的那段时期,文件上传仍然是一项比较具有挑战性的任务,包括在服务器端解析原始的http响应。值得庆幸的是,Apache Software Foundation 于2003年发布了它的开源Commons FileUpload 组件,并且很快就受到了世界各地servlet/jsp 爱好者的追捧。
几年之后,servlet的设计者才意识到文件上传的重要性,最终,文件上传在servlet3.0中成为了一项内置的特性。servlet3.0的开发者不再需要将Commons FileUpload 组件导入到他们的工程中去。
要上传文件,必须利用 multipart/form-data 设置HTML表单的enctype属性值,旨在告诉服务器,向服务器发送二进制数据。
这个表单中必须包含类型file的一个输入元素,它会被显示成一个按钮,单击它时,会打开一个对话框,供我们选择文件。表单中还可以包含其他类型域,如文本域或隐藏域等。
表单页面
<%@ 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>FileUpload</title> </head> <body> <center> <form action="sf" enctype="multipart/form-data" method="get"> username: <input type="text" name="username" /><br> file: <input type="file" name="filename" /><br> <input type="submit" value="Submit" /> </form> </center> </body> </html>
servlet中的服务器端文件上传编程主要围绕着MultipartConfig 注解类型和javax.servlet.http.Part接口进行。处理上传文件的servlet必须用@MultipartConfig进行标注。
MultipartConfig可以带有以下属性,这些全部是可选的:
maxFileSize:表示最多可上传的文件容量。超过设定值的文件将会遭到拒绝。maxFileSize 的默认值为-1,表示不受限制。
maxRequestSize:表示允许多部分http请求的最大容量。它的默认值为-1,表示它是不受限制的。
location:将上传的文件保存到磁盘中的指定位置,调用Part 中的write 方法将用到它。
fileSizeThreshold:设定一个溢出尺寸,超过这个值之后,上传的文件将被写入磁盘。
在一个由多部分组成的请求中,每一个表单域,包括非文本域,都会被转换成一个Part。
后台servlet
package com.fileupload; import java.io.File; import java.io.FileOutputStream; import java.io.IOException; import java.io.InputStream; import java.util.Collection; import java.util.Enumeration; import javax.servlet.ServletException; import javax.servlet.annotation.MultipartConfig; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.http.Part; /** * Servlet implementation class Test */ @WebServlet("/sf") @MultipartConfig public class SingleFileUpload extends HttpServlet { private static final long serialVersionUID = 1L; /** * @see HttpServlet#HttpServlet() */ public SingleFileUpload() { super(); } /** * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response) */ protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { doPost(request, response); } /** * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response) */ protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { Enumeration<String> heads = request.getHeaderNames(); while (heads.hasMoreElements()) { String header = heads.nextElement(); System.out.println(header + "=" + request.getHeader(header)); } Part part = request.getPart("filename"); Collection<String> headerNames = part.getHeaderNames(); for (String header : headerNames) { System.out.println(header + "=" + part.getHeader(header)); } InputStream is = part.getInputStream(); String filename = new String(getFilename(part).getBytes(), "UTF-8"); File file = new File("D:\\fileupload"); if (!file.exists() || !file.isDirectory()) { file.mkdir(); } FileOutputStream fos = new FileOutputStream(new File(file + File.separator + filename)); byte[] buf = new byte[1024]; while (is.read(buf) != -1) { fos.write(buf); } fos.flush(); fos.close(); is.close(); } public String getFilename(Part part) { String contentDispositionHeader = part.getHeader("content-disposition"); String[] elements = contentDispositionHeader.split(";"); for (String element : elements) { if (element.trim().startsWith("filename")) { return element.substring(element.indexOf('=') + 1).trim().replace("\"", ""); } } return null; } }
servlet3.0的文件上传,是servlet3.0新添加的特性,servlet所在的工程必须是在servlet3.0的规范下。
低于3.0 版本的servlet规范,文件上传执行不起来。