第三十一章：文件上传&下载

作者：java_wxid

文件的上传介绍
文件的上传和下载功能是很多系统中非常常见的功能。非常的重要。

文件的上传
1、首先需要一个form表单
2、然后在表单内有input type=”file”
3、提交的方式必须是method=”POST”
4、enctype="multipart/form-data"编码类型必须是多段的表单数据

enctype属性有两种值：

当enctype属性值为application/x-www-form-urlencoded的时候，表单提交的时候，浏览器会把所有的表单以name=value&name=value的形式进行拼接，然后做URL编码操作。
URL编码操作，就是把非字母数字的字符，比如说中文，转换成为：%xx%xx的格式内容

javaScript客户端的URL编解码：

		<script type="text/javascript">
			var url = "key=中文";
			// 编码操作
			var encodedURL = encodeURI(url);
// 			alert(encodedURL);
			// 解码操作
			var decodedURL = decodeURI(encodedURL);
			alert(decodedURL);
		</script>

java中的URL编解码操作

public class JavaEncodeAndDecode {
	public static void main(String[] args) throws Exception {
		String url = "key=中文";
		// URLEncoder.encode 编码操作
		String encodedUrl = URLEncoder.encode(url, "UTF-8");
		System.out.println(encodedUrl);
		// 解码操作
		String decodedUrl = URLDecoder.decode(encodedUrl, "UTF-8");
		System.out.println( decodedUrl );
	}
}

当enctype属性值为multipart/form-data的时候，表单提交，浏览器会把所有表单项的信息，
以多个段的形式拼接在一起，以二进制流的形式发送给服务器。每个表单项，都会以特定的格式封装成为一段的数据。

文件上传，HTTP协议的说明。
谷歌浏览器f12进行查看：
在这里插入图片描述
commons-fileupload.jar 常用API介绍说明
commons-fileupload.jar 需要依赖 commons-io.jar 这个包，所以两个包我们都要引入。
commons-fileupload-1.2.1.jar
commons-io-1.4.jar

commons-fileupload.jar和commons-io.jar包中，我们常用的类有哪些？

boolean ServletFileUpload.isMultipartContent(HttpServletRequest request);
判断，你提交过来的数据，是否是多段的上传数据，如果是返回true，如果数据格式不合法，返回false

扫描二维码关注公众号，回复： 4120213 查看本文章

public List ServletFileUpload.parseRequest(HttpServletRequest request)
直接把上传的数据，都解析成为每一个表单项。
每一个表单项由FileItem类表示

boolean FileItem.isFormField()
判断，是不是普通的表单项。如果是返回true，如果不是返回false

String FileItem.getFieldName()
获取表单项的name的属性值

String FileItem.getString()
获取表单项的值，多用于普通表单项。

String FileItem.getName();
获取上传的文件名

void FileItem.write( file );
把上传的文件写到file所指向的位置。

fileupload类库的使用：

文件上传的表单：

<body>
	<form action="http://192.168.10.100:8080/day10/upload" enctype="multipart/form-data" method="post">
		用户名：<input type="text" name="username" /><br/>
		头像：<input type="file" name="file"/><br/>
		<input type="submit" />
	</form>
</body>

解决上传代码:

public class Upload extends HttpServlet {
	private static final long serialVersionUID = 1L;

	protected void doPost(HttpServletRequest request,
			HttpServletResponse response) throws ServletException, IOException {
		// 判断，到底接收到的数据，是不是文件上传的格式（多段的multipart/form-data）
		if (ServletFileUpload.isMultipartContent(request)) {
			FileItemFactory fileItemFactory = new DiskFileItemFactory();
			// 创建文件上传解决的对象
			ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
			try {
				// 解析上传的数据 ====>>>会得到每一个表单项
				// 每个FileItem表示一个表单项
				List<FileItem> fileItems = servletFileUpload.parseRequest(request);
				// 遍历操作每一个表单项
				for (FileItem fileItem : fileItems) {
					if (fileItem.isFormField()) {
						// 表示这是一个普通表单项
						// 关心name属性值和value属性值
						System.out.println("name的属性值：" + fileItem.getFieldName());
						System.out.println("提交过来的值：" + fileItem.getString());
					} else {
						// 上传的文件项
						// 关心name属性值，和上传的文件名，以及把上传的文件写到某个硬盘位置 
						System.out.println("name的属性值：" + fileItem.getFieldName());
						System.out.println("上传的文件名：" + fileItem.getName());
						fileItem.write(new File("E:\\" + fileItem.getName()));
					}
				}
			} catch (Exception e) {
				e.printStackTrace();
			}
		}
	}
}

文件下载

下载的常用API说明：

response.getOutputStream();
servletContext.getResourceAsStream();
servletContext.getMimeType();
response.setContentType();

response.setHeader(“Content-Disposition”, “attachment; fileName=1.jpg”);
这个响应头告诉浏览器。这是需要下载的。Content-Disposition是内容-配置，而attachment表示附件，也就是下载的一个文件。fileName=后面，表示下载的文件名。

完成上面的两个步骤，下载文件是没问题了。但是如果我们要下载的文件是中文名的话。你会发现，下载无法正确显示出正确的中文名。
原因是在响应头中，不能包含有中文字符，只能包含ASCII码。

附件中文名乱码问题解决方案：
方案一：URLEncoder解决 IE 和谷歌浏览器的附件中文名问题。
如果客户端浏览器是IE浏览器或者是谷歌浏览器。我们需要使用URLEncoder类先对中文名进行UTF-8的编码操作。
因为IE浏览器和谷歌浏览器收到含有编码后的字符串后会以UTF-8字符集进行解码显示。

		// 把中文名进行UTF-8编码操作。
		String str = "attachment; fileName=" + URLEncoder.encode("中文.jpg", "UTF-8");
		// 然后把编码后的字符串设置到响应头中
		response.setHeader("Content-Disposition", str);

方案二：BASE64编解码解决火狐浏览器的附件中文名问题
如果客户端浏览器是火狐浏览器。那么我们需要对中文名进行BASE64的编码操作。

这时候需要把请求头Content-Disposition: attachment; filename=中文名
编码成为：Content-Disposition: attachment; filename==?charset?B?xxxxx?=

=?charset?B?xxxxx?= 现在我们对这段内容进行一下说明。
=? :表示编码的开始
charset :表示你使用什么字符集
B :表示使用BASE64编码
xxxx :是base64编码后的内容
?= :表示编码的结束

BASE64编解码操作：

@Test
public void test() throws Exception {
	String url = "中文.jpg";
	// 创建一个base64编码器对象
	BASE64Encoder base64Encoder = new BASE64Encoder();
	// base64Encoder.encode执行base64编码操作
	String base64EncodedString = base64Encoder.encode(url.getBytes("UTF-8"));
	System.out.println(base64EncodedString);
	// 解码
	BASE64Decoder base64Decoder = new BASE64Decoder();
	// base64解码操作
	byte[] buffer = base64Decoder.decodeBuffer(base64EncodedString);
	System.out.println( new String(buffer, "UTF-8") );
}

因为火狐使用的是BASE64的编解码方式还原响应中的汉字。所以需要使用BASE64Encoder类进行编码操作。

// 使用下面的格式进行BASE64编码后
String str = "attachment; fileName=" + "=?utf-8?B?"
		+ new BASE64Encoder().encode("中文.jpg".getBytes("utf-8")) + "?=";
// 设置到响应头中
response.setHeader("Content-Disposition", str);

那么我们如何解决上面两种不同编解码方式呢。我们只需要通过判断请求头中User-Agent这个请求头携带过来的浏览器信息即可判断出是什么浏览器。

如下：

String ua = request.getHeader("User-Agent");
// 判断是否是火狐浏览器
if (ua.contains("Firefox")) {
	// 使用下面的格式进行BASE64编码后
	String str = "attachment; fileName=" + "=?utf-8?B?"
			+ new BASE64Encoder().encode("中文.jpg".getBytes("utf-8")) + "?=";
	// 设置到响应头中
	response.setHeader("Content-Disposition", str);
} else {
	// 把中文名进行UTF-8编码操作。
	String str = "attachment; fileName=" + URLEncoder.encode("中文.jpg", "UTF-8");
	// 然后把编码后的字符串设置到响应头中
	response.setHeader("Content-Disposition", str);
}

案例代码：

public class Download extends HttpServlet {
	private static final long serialVersionUID = 1L;

	protected void doGet(HttpServletRequest request,
			HttpServletResponse response) throws ServletException, IOException {
		String path = "/imgs/d.jpg";
		ServletContext servletContext = getServletContext();
		// getMimeType 获取文件的数据类型
		String type = servletContext.getMimeType(path);
		System.out.println(type);
		// 要设置返回的数据类型
		response.setContentType(type);

		/**
		 * 通过判断请求头User-Agent判断是不是火狐浏览器，还是其他浏览器
		 */
		if (request.getHeader("User-Agent").contains("Firefox")) {
			// 火狐浏览器
			response.setHeader(
					"Content-Disposition",
					"attachment; filename==?UTF-8?B?"
							+ new BASE64Encoder().encode("中文.jpg"
									.getBytes("UTF-8")) + "?=");
		} else {
			// 如果是谷歌浏览器，或IE浏览器，需要使用URL编码处理
			// 设置响应头 告诉浏览器，你收到数据，要当成下载处理。
			// attachment 表示附件
			// fileName表示下载的文件名
			response.setHeader("Content-Disposition", "attachment; filename="
					+ URLEncoder.encode("中文.jpg", "UTF-8"));
		}

		// 1 想办法读取需要下载的文件
		// 斜杠打头，表示到http://ip:prot/工程名/ 映射到代码的webContent目录
		InputStream stream = servletContext.getResourceAsStream(path);
		// 2 通过字节的响应输出流，输出给客户端
		ServletOutputStream outputStream = response.getOutputStream();
		// copy方法 把输入流的内容都读取然后写到输出流中
		IOUtils.copy(stream, outputStream);
		// 关流释放 资源
		stream.close();
		outputStream.close();
	}
}

项目文本替换
页面内替换文本：Ctrl+F
项目中所有文本替换
在这里插入图片描述

第三十一章：文件上传&下载

猜你喜欢