Servlet - 文件上传
Servlet 可与 HTML 表单标记一起使用,以允许用户将文件上传到服务器。上传的文件可以是文本文件、图像文件或任何文档。
创建文件上传表单
以下 HTM 代码创建上传器表单。以下是需要注意的重要点 −
表单 method 属性应设置为 POST 方法,不能使用 GET 方法
表单 enctype 属性应设置为 multipart/form-data。
表单 action 属性应设置为 servlet 文件,该文件将在后端服务器上处理文件上传。以下示例使用 UploadServlet servlet 上传文件。
要上传单个文件,您应使用带有属性 type="file" 的单个 <input .../> 标签。要允许上传多个文件,请包含多个具有不同 name 属性值的 input 标签。浏览器会将浏览按钮与每个文件关联。
<html>
<head>
<title>File Uploading Form</title>
</head>
<body>
<h3>File Upload:</h3>
Select a file to upload: <br />
<form action = "UploadServlet" method = "post" enctype = "multipart/form-data">
<input type = "file" name = "file" size = "50" />
<br />
<input type = "submit" value = "Upload File" />
</form>
</body>
</html>
这将显示以下结果,允许从本地 PC 选择一个文件,当用户单击"上传文件"时,表单将与所选文件一起提交 −
文件上传: 选择要上传的文件:
注意:这只是虚拟表单,不起作用。
编写后端 Servlet
以下是 servlet UploadServlet,它将负责接受上传的文件并将其存储在目录 <Tomcat-installation-directory>/webapps/data 中。还可以使用外部配置(例如 web.xml 中的 context-param 元素)添加此目录名称,如下所示 −
<web-app>
....
<context-param>
<description>Location to store uploaded file</description>
<param-name>file-upload</param-name>
<param-value>
c:\apache-tomcat-5.5.29\webapps\data\
</param-value>
</context-param>
....
</web-app>
以下是 UploadServlet 的源代码,它可以一次处理多个文件上传。在继续之前,请确保以下 −
以下示例依赖于 FileUpload,因此请确保您的类路径中具有最新版本的 commons-fileupload.x.x.jar 文件。您可以从 https://commons.apache.org/fileupload/ 下载它。
FileUpload 依赖于 Commons IO,因此请确保您的类路径中具有最新版本的 commons-io-x.x.jar 文件。您可以从 https://commons.apache.org/io/ 下载。
在测试以下示例时,您应该上传一个小于 maxFileSize 的文件,否则文件将无法上传。
确保您已提前创建目录 c:emp 和 c:\apache-tomcat8.0.28\webapps\data。
// 导入所需的 Java 库
import java.io.*;
import java.util.*;
import javax.servlet.ServletConfig;
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;
import org.apache.commons.io.output.*;
public class UploadServlet extends HttpServlet {
private boolean isMultipart;
private String filePath;
private int maxFileSize = 50 * 1024;
private int maxMemSize = 4 * 1024;
private File file ;
public void init( ){
// 获取存储文件的位置。
filePath = getServletContext().getInitParameter("file-upload");
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, java.io.IOException {
// 检查我们是否有文件上传请求
isMultipart = ServletFileUpload.isMultipartContent(request);
response.setContentType("text/html");
java.io.PrintWriter out = response.getWriter( );
if( !isMultipart ) {
out.println("<html>");
out.println("<head>");
out.println("<title>Servlet upload</title>");
out.println("</head>");
out.println("<body>");
out.println("<p>No file uploaded</p>");
out.println("</body>");
out.println("</html>");
return;
}
DiskFileItemFactory factory = new DiskFileItemFactory();
// 存储在内存中的最大大小
factory.setSizeThreshold(maxMemSize);
// 保存大于 maxMemSize 的数据的位置。
factory.setRepository(new File("c:\temp"));
// 创建新的文件上传处理程序
ServletFileUpload upload = new ServletFileUpload(factory);
// 可上传的最大文件大小。
upload.setSizeMax( maxFileSize );
try {
// 解析请求以获取文件项。
List fileItems = upload.parseRequest(request);
// 处理上传的文件项
Iterator i = fileItems.iterator();
out.println("<html>");
out.println("<head>");
out.println("<title>Servlet upload</title>");
out.println("</head>");
out.println("<body>");
while ( i.hasNext () ) {
FileItem fi = (FileItem)i.next();
if ( !fi.isFormField () ) {
// 获取上传文件参数
String fieldName = fi.getFieldName();
String fileName = fi.getName();
String contentType = fi.getContentType();
boolean isInMemory = fi.isInMemory();
long sizeInBytes = fi.getSize();
// 写入文件
if( fileName.lastIndexOf("\") >= 0 ) {
file = new File( filePath + fileName.substring( fileName.lastIndexOf("\"))) ;
} else {
file = new File( filePath + fileName.substring(fileName.lastIndexOf("\")+1)) ;
}
fi.write( file ) ;
out.println("Uploaded Filename: " + fileName + "<br>");
}
}
out.println("</body>");
out.println("</html>");
} catch(Exception ex) {
System.out.println(ex);
}
}
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, java.io.IOException {
throw new ServletException("GET method used with " +
getClass( ).getName( )+": POST method required.");
}
}
}
编译并运行 Servlet
编译上述 servlet UploadServlet 并在 web.xml 文件中创建所需的条目,如下所示。
<servlet> <servlet-name>UploadServlet</servlet-name> <servlet-class>UploadServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>UploadServlet</servlet-name> <url-pattern>/UploadServlet</url-pattern> </servlet-mapping>
现在尝试使用上面创建的 HTML 表单上传文件。当您尝试 http://localhost:8080/UploadFile.htm 时,它将显示以下结果,这将帮助您从本地机器上传任何文件。
文件上传:选择要上传的文件:
如果您的 servlet 脚本运行正常,您的文件应该上传到 c:\apache-tomcat8.0.28\webapps\data\ 目录中。

