上传文件

共计 4119 个字符，预计需要花费 11 分钟才能阅读完成。

1、文件上传的作用

例如网络硬盘！就是用来上传下载文件的。

往百度网盘上传一个文件就是文件上传。

2、文件上传对页面的要求

上传文件的要求比较多，需要记一下：

• 必须使用表单，而不能是超链接；
• 表单的 method 必须是 POST，而不能是 GET；
• 表单的 enctype 必须是 multipart/form-data；
• 在表单中添加 file 表单字段，即 <input type=”file”…/>

例如：

    <form action="${pageContext.request.contextPath}/FileUploadServlet" method="post" enctype="multipart/form-data">
    	用户名：<input type="text" name="username"/><br/>
    	文件 1：<input type="file" name="file1"/><br/>
    	文件 2：<input type="file" name="file2"/><br/>
    	<input type="submit" value="提交"/>
    </form>
 

3、文件上传对 Servlet 的要求

当提交的表单是文件上传表单时，那么对 Servlet 也是有要求的。

首先我们要肯定一点，文件上传表单的数据也是被封装到 request 对象中的。

**request.getParameter(String)** 方法获取指定的表单字段字符内容，但文件上传表单已经不在是字符内容，而是字节内容，所以失效。

这时可以使用 request 的 getInputStream() 方法获取 ServletInputStream 对象，它是 InputStream 的子类，这个 ServletInputStream 对象对应整个表单的正文部分（从第一个分隔线开始，到最后），这说明我们需要的解析流中的数据。当然解析它是很麻烦的一件事情，而 Apache 已经帮我们提供了解析它的工具：commons-fileupload。

可以尝试把 request.getInputStream() 这个流中的内容打印出来看看

public void doPost(HttpServletRequest request, HttpServletResponse response)
			throws ServletException, IOException {InputStream in = request.getInputStream();
		String s = IOUtils.toString(in); // 使用 apache 的 commons 的 io 组件，把流中的数据读取出来转换成字符串 
		System.out.println(s);
	}

-----------------------------7ddd3370ab2
Content-Disposition: form-data; name="username"
 
hello
-----------------------------7ddd3370ab2
Content-Disposition: form-data; name="file1"; filename="a.txt"
Content-Type: text/plain
 
aaa
-----------------------------7ddd3370ab2
Content-Disposition: form-data; name="file2"; filename="b.txt"
Content-Type: text/plain
 
bbb
-----------------------------7ddd3370ab2--

4、commons-fileupload 工具介绍

4.1、fileupload 概述

fileupload 是由 apache 的 commons 组件提供的上传组件。它最主要的工作就是帮我们解析 request.getInputStream()。

fileupload 组件需要的 JAR 包有：

• commons-fileupload.jar，核心包；

• commons-io.jar，依赖包。

4.2、fileupload 简单应用

fileupload 的核心类有：DiskFileItemFactory、ServletFileUpload、FileItem。

使用 fileupload 组件的步骤如下：

• 创建工厂类 DiskFileItemFactory 对象：DiskFileItemFactory factory = new DiskFileItemFactory()

• 使用工厂创建解析器对象：ServletFileUpload fileUpload = new ServletFileUpload(factory)

• 使用解析器来解析 request 对象：List list = fileUpload.parseRequest(request)

隆重介绍 FileItem 类，它才是我们最终要的结果。一个 FileItem 对象对应一个表单项（表单字段）。一个表单中存在文件字段和普通字段，可以使用 FileItem 类的 isFormField() 方法来判断表单字段是否为普通字段，如果不是普通字段，那么就是文件字段了。

• String getName()：获取文件字段的文件名称；

• String getString()：获取字段的内容，如果是文件字段，那么获取的是文件内容，当然上传的文件必须是文本文件；

• String getFieldName()：获取字段名称，例如：，返回的是 username；

• String getContentType()：获取上传的文件的类型，例如：text/plain。

• int getSize()：获取上传文件的大小；

• boolean isFormField()：判断当前表单字段是否为普通文本字段，如果返回 false，说明是文件字段；

• InputStream getInputStream()：获取上传文件对应的输入流；

• void write(File)：把上传的文件保存到指定文件中。

4.3、简单上传示例

写一个简单的上传示例：

• 表单包含一个用户名字段，以及一个文件字段；

• Servlet 保存上传的文件到 uploads 目录，显示用户名，文件名，文件大小，文件类型。

第一步：

完成 index.jsp，只需要一个表单。注意表单必须是 post 的，而且 enctype 必须是 mulitpart/form-data 的。

	<form action="${pageContext.request.contextPath}/FileUploadServlet" method="post" enctype="multipart/form-data">
    	用户名：<input type="text" name="username"/><br/>
    	文件 1：<input type="file" name="file1"/><br/>
    	<input type="submit" value="提交"/>
    </form>

第二步：

完成 FileUploadServlet

public void doPost(HttpServletRequest request, HttpServletResponse response)
			throws ServletException, IOException {// 因为要使用 response 打印，所以设置其编码 
		response.setContentType("text/html;charset=utf-8");
		
		// 创建工厂 
		DiskFileItemFactory dfif = new DiskFileItemFactory();
		// 使用工厂创建解析器对象 
		ServletFileUpload fileUpload = new ServletFileUpload(dfif);
		try {// 使用解析器对象解析 request，得到 FileItem 列表 
			List<FileItem> list = fileUpload.parseRequest(request);
			// 遍历所有表单项 
			for(FileItem fileItem : list) {// 如果当前表单项为普通表单项 
				if(fileItem.isFormField()) {// 获取当前表单项的字段名称 
					String fieldName = fileItem.getFieldName();
					// 如果当前表单项的字段名为 username
					if(fieldName.equals("username")) {// 打印当前表单项的内容，即用户在 username 表单项中输入的内容 
						response.getWriter().print("用户名：" + fileItem.getString() + "<br/>");
					}
				} else {// 如果当前表单项不是普通表单项，说明就是文件字段 
					String name = fileItem.getName();// 获取上传文件的名称 
					// 如果上传的文件名称为空，即没有指定上传文件 
					if(name == null || name.isEmpty()) {continue;
					}
					// 获取真实路径，对应 ${项目目录}/uploads，当然，这个目录必须存在 
					String savepath = this.getServletContext().getRealPath("/uploads");
					// 通过 uploads 目录和文件名称来创建 File 对象 
					File file = new File(savepath, name);
					// 把上传文件保存到指定位置 
					fileItem.write(file);
					// 打印上传文件的名称 
					response.getWriter().print("上传文件名：" + name + "<br/>");
					// 打印上传文件的大小 
					response.getWriter().print("上传文件大小：" + fileItem.getSize() + "<br/>");
					// 打印上传文件的类型 
					response.getWriter().print("上传文件类型：" + fileItem.getContentType() + "<br/>");
				}
			}
		} catch (Exception e) {throw new ServletException(e);
		} 
	}