解决Struts2下载中文文件乱码问题
通过《Struts2文件下载实例》的学习,读者已经学会了如何使用 Struts2 框架实现文件下载,但是细心的读者会发现,如果上传一个中文名称的文件(如文本文件.txt),再次下载此文件时,页面会报出 500 错误,如图 1 所示。
图 1 中文文件下载报错
之所以出现图 1 中的错误,是因为所要下载的文件不存在,导致 inputStream 为 null,所以报出了 500 错误。这里读者一定会很费解,明明上传了一个新文件,并可以确认文件在文件夹中是存在的,那么为什么还会报出此错误呢?
如果在 SimpleDownLoadAction 类的第 21 行代码中设置断点,并采用 Debug 模式调试执行程序,会发现传递到 Action 中的中文名称变成了乱码,如图 2 所示。
图 2 中文乱码
从图 2 中可以看到,页面中传递的“测试.txt”已经变为“æµè¯.txt”,这说明在传递过程中,中文名称发生了乱码。然而在实际应用中,下载中文文件是不可避免的。下面本节将通过一个具体的案例讲解如何使用 Struts2 框架下载中文文件。
在 filename 属性的 getter() 方法中,通过 encodeDownloadFilename(String name,String agent) 方法对不同浏览器传过来的名称进行编码,在其 setter() 方法中,对其文件名称又进行了一次编码,使文件名称统一为 UTF-8 编码格式。
通过 contentType 属性的 getContentType() 方法获取了文件的类型,并在 getFileDownload() 方法中定义了要下载的文件路径,并返回一个输入流。
图 3 中文文件下载
图 1 中文文件下载报错
之所以出现图 1 中的错误,是因为所要下载的文件不存在,导致 inputStream 为 null,所以报出了 500 错误。这里读者一定会很费解,明明上传了一个新文件,并可以确认文件在文件夹中是存在的,那么为什么还会报出此错误呢?
如果在 SimpleDownLoadAction 类的第 21 行代码中设置断点,并采用 Debug 模式调试执行程序,会发现传递到 Action 中的中文名称变成了乱码,如图 2 所示。
图 2 中文乱码
从图 2 中可以看到,页面中传递的“测试.txt”已经变为“æµè¯.txt”,这说明在传递过程中,中文名称发生了乱码。然而在实际应用中,下载中文文件是不可避免的。下面本节将通过一个具体的案例讲解如何使用 Struts2 框架下载中文文件。
1)创建文件下载页面
在项目的 WebContent 目录中创建一个名称为 filedownload.jsp 的文件,在文件中添加一个中文链接,其代码如下所示:<s:a href="filedownload?filename=测试.txt" name="test">测试.txt</s:a>
2)创建 Action 类
在 com.mengma.action 包中新建一个名称为 FileDownLoadAction 的类,该类是用于下载文件的 Action,编辑后如下所示。package com.mengma.action; import java.io.IOException; import java.io.InputStream; import java.io.UnsupportedEncodingException; import java.net.URLEncoder; import org.apache.struts2.ServletActionContext; import sun.misc.BASE64Encoder; import com.opensymphony.xwork2.ActionSupport; public class FileDownLoadAction extends ActionSupport { private String filename; // 代表下载文件的名称 private String contentType; // 下文件的 MimeType /** * 获取文件的名称 */ public String getFilename() throws IOException { // 对不同浏览器传过来的文件名进行编码 return encodeDownloadFilename(filename, ServletActionContext .getRequest().getHeader("User-Agent")); } public void setFilename(String filename) throws UnsupportedEncodingException { // 对文件名称编码 filename = new String(filename.getBytes("iso8859-1"), "utf-8"); this.filename = filename; } /** * 获取文件的类墩 */ public String getContentType() { return ServletActionContext.getServletContext().getMimeType(filename); } public void setContentType(String contentType) { this.contentType = contentType; } // 定义了返回InputStream的方法,该方法作为被下载文件的入口 public InputStream getFileDownload() { // 要下载的文件的路径 String filepath = "/upload/" + filename; return ServletActionContext.getServletContext().getResourceAsStream( filepath); } /* * 对不同浏览器传过來的文件名称进行转码 * @param name文件名窗; * @param agenr浏览器 * @return转码后的名称 */ public String encodeDownloadFilename(String name, String agent) throws IOException { if (agent.contains("Firefox")) { // 火孤浏览器 name = "=?UTF-8?B?" + new BASE64Encoder().encode(name.getBytes("utf-8")) + "?="; } else { // IE及其他浏览器 name = URLEncoder.encode(name, "utf-8"); } return name; } }上述代码中,声明了 filename 和 contentType 两个属性,分别代表所要下载文件的名称和类型。
在 filename 属性的 getter() 方法中,通过 encodeDownloadFilename(String name,String agent) 方法对不同浏览器传过来的名称进行编码,在其 setter() 方法中,对其文件名称又进行了一次编码,使文件名称统一为 UTF-8 编码格式。
通过 contentType 属性的 getContentType() 方法获取了文件的类型,并在 getFileDownload() 方法中定义了要下载的文件路径,并返回一个输入流。
3)修改配置文件
在 struts.xml 文件中,增加 FileDownLoadAction 的配置信息,其代码如下所示:<action name="filedownload" class="com.mengma.action.FileDownLoadAction"> <result type="stream"> <!--文件类型 --> <param name="contentType">${contentType}</param> <!--指定文件名 --> <param name="contentDisposition"> attachment;filename=${filename} </param> <!--输入流入口 --> <param name="inputName">filedownload</param> </result> </action>在上述配置代码中,${contentType} 和 ${filename} 会在项目运行时,将 action 中的对象属性动态地填充在 ${} 中间部分,相当于 action.getContentType() 和 action.getFilename(),通过此种方式动态地获取文件的类型和名称。
4)运行程序并查看结果
在浏览器的地址栏中输入地址 http://localhost:8080/struts2Demo06/filedownload.jsp,成功访问后,单击页面中的“测试.txt”链接,其效果如图 3 所示。图 3 中文文件下载
所有教程
- socket
- Python基础教程
- C#教程
- MySQL函数
- MySQL
- C语言入门
- C语言专题
- C语言编译器
- C语言编程实例
- GCC编译器
- 数据结构
- C语言项目案例
- C++教程
- OpenCV
- Qt教程
- Unity 3D教程
- UE4
- STL
- Redis
- Android教程
- JavaScript
- PHP
- Mybatis
- Spring Cloud
- Maven
- vi命令
- Spring Boot
- Spring MVC
- Hibernate
- Linux
- Linux命令
- Shell脚本
- Java教程
- 设计模式
- Spring
- Servlet
- Struts2
- Java Swing
- JSP教程
- CSS教程
- TensorFlow
- 区块链
- Go语言教程
- Docker
- 编程笔记
- 资源下载
- 关于我们
- 汇编语言
- 大数据
- 云计算
- VIP视频