使用Servlet3.0提供的Part类实现文件上传操作

Servlet3.0较之以往版本,增加了一些使用的新功能,其中有两个比较大的改进是:HttpServletRequest增加了对文件上传的支持、ServletContext允许通过编程的方式动态注册Servlet、Filter。

就文件上传来说,HttpServletRequest提供了如下两个方法来处理文件上传:
(1)Part getPart(String name):根据名称来获取文件上传域。

(2)Collection<Part> getParts():获取所有的文件上传域。

上面的两个方法都涉及到了一个新的API:Part,每一个Part对象对应于一个文件上传域,该对象提供了大量方法来访问上传文件的文件类型、大小、输入流等,并提供了一个write(String file)方法将文件写入服务器磁盘。

为了向服务器上传文件,需要在表单里使用<input type="file".../>文件域,还需要为表单域设置为enctype属性,表单的enctype属性指定的是表单数据的编码方式,该属性有如下三个值:

(1)application/x-www-form-urlencoded:默认的编码方式,它只处理表单域里的value属性值,采用这种编码方式的表单会将表单域的值处理成URL编码方式。

(2)multipart/form-data:这种编码方式会以二进制流的方式来处理表单数据,这种编码方式会把文件域指定文件的内容也封装到请求参数里。

(3)text/plain:使用这种编码方式,当表单的action属性为mailto:URL的形式时比较方便,这种方式主要适用于直接使用表单发送邮件的方式。

如果将enctype设置为application/x-www-form-urlencoded或者不设置,提交表单的时候就只发送文件域的文本框里的字符串,也就是浏览器所选择文件的绝对路径,对服务器获取该文件在客户端上的绝对路径没有任何作用,因为服务器不可能访问客户机的文件系统。

下面是一个文件上传的例子:

<%@ 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>上传文件测试</title>
</head>
<body>
<form action="upload" method="post" enctype="multipart/form-data">
	文件名:<input type="text" id="name" name="name" /><br />
	选择文件:<input type="file" id="file" name="file" /><br />
	<input type="submit" value="上传" />
</form>
</body>
</html>

上面是index.jsp中内容,下面是upload这个Servlet中的内容:

package net.yedward.demo.controller;

import java.io.IOException;
import java.io.PrintWriter;
import java.util.Collection;

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;

@WebServlet(name="upload", urlPatterns={"/upload"})
@MultipartConfig
public class UploadServlet extends HttpServlet {
	@Override
	protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
		response.setContentType("text/html;charset=UTF-8");
		PrintWriter out = response.getWriter();
		// 为了简单,后面也直接就以fileName作为保存文件的名称
		String fileName = request.getParameter("name");
		Part part = request.getPart("file");
		out.println("上传文件的类型为:" + part.getContentType() + "<br />");
		out.println("上传文件的大小为:" + part.getSize() + "<br />");
		Collection<String> headerNames = part.getHeaderNames();
		// 遍历文件上传域的Header Name
		for (String headerName : headerNames) {
			out.println(headerName + "---->" + part.getHeader(headerName) + "<br />");
		}
		// 将文件保存到项目下的uploads文件夹下,为了简单这里没写判断目录是否存在及创建目录的操作,要先确保该目录已经存在
		part.write(getServletContext().getRealPath("/uploads") + "/" + fileName);
	}
}

我在本地已经测试过了,上面的代码确实可以成功的上传文件以指定的文件名存到指定的项目下的uploads目录下。如果是在Servlet3.0之前,由于Servlet并不支持上传文件,往往需要引入common-fileupload这个API,该API的教程可在网上找到。

本文标题:使用Servlet3.0提供的Part类实现文件上传操作

本文链接:http://yedward.net/?id=332

本文版权归作者所有,欢迎转载,转载请以文字链接的形式注明文章出处。

相关文章