JSP、Struts2下载中文文件名乱码问题
原来处理下载的代码如下：
response.setHeader("Content-Disposition", "attachment; filename=" + java.net.URLEncoder.encode(fileName, "UTF-8"));
下载的程序里有了这句，一般在IE6的下载提示框上将正确显示文件的名字，无论是简体中文，还是日文。
一. 上面方式，也就是先用URLEncoder编码，当中文文字超过17个时，IE6 无法下载文件。
这是IE的bug，参见微软的知识库文章 KB816868 。
原因可能是因为ie在处理 Response Header 的时候，对header的长度限制在150字节左右。
而一个汉字编码成UTF-8是9个字节，那么17个字便是153个字节，所以便会报错。
微软提供了一个补丁。这个补丁需要先安装ie6 sp1。
二. 我尝试使用 javamail 的MimeUtility.encode()方法来编码文件名，也就是编码成 =?gb2312?B?xxxxxxxx?= 这样的形式，
并从 RFC1522 中找到对应的标准支持。不过很遗憾，IE6并不支持这一个标准。
我试了一下，Firefox是支持的。
三. 按网上很多人提供的解决方案：将文件名编码成ISO8859-1似乎是有效的解决方案，代码如下：
response.setHeader( "Content-Disposition", "attachment;filename="+new String(fileName.getBytes("gb2312"), "ISO8859-1" ) );
在确保附件文件名都是简体中文字的情况下，那么这个办法确实是最有效的，不用让客户逐个的升级IE。
如果台湾同胞用，把gb2312改成big5就行。但现在的系统通常都加入了国际化的支持，普遍使用UTF-8。
如果文件名中又有简体中文字，又有繁体中文，还有日文。那么乱码便产生了。
另外，在我的电脑上Firefox (v1.0-en)下载也是乱码。
折中考虑，我结合了一、三的方式，代码片断如下：
String fileName = URLEncoder.encode(atta.getFileName(), "UTF-8");
/*
* see http://support.microsoft.com/default.aspx?kbid=816868
*/
if (fileName.length() > 150) {
String guessCharset = xxxx /*根据request的locale 得出可能的编码，中文操作系统通常是gb2312*/
fileName = new String(atta.getFileName().getBytes(guessCharset), "ISO8859-1");
}
response.setHeader("Content-Disposition", "attachment; filename=" + fileName);
暂且不考虑 Firefox。
/////////////////////
下面是解决文件名空格问题
String fileName = StringUtils.trim(file.getName());
String formatFileName = encodingFileName(name);//在后面定义方法encodingFileName(String fileName);
response.setHeader("Content-Disposition", "attachment; filename=" + formatFileName );
//处理文件名中出现的空格
//其中%20是空格在UTF-8下的编码
public static String encodingFileName(String fileName) {
String returnFileName = "";
try {
returnFileName = URLEncoder.encode(fileName, "UTF-8");
returnFileName = StringUtils.replace(returnFileName, "+", "%20");
if (returnFileName.length() > 150) {
returnFileName = new String(fileName.getBytes("GB2312"), "ISO8859-1");
returnFileName = StringUtils.replace(returnFileName, " ", "%20");
}
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
if (log.isWarnEnabled()) {
log.info("Don't support this encoding ...");
}
}
return returnFileName;
方案二
Struts2下载文件实现的说明
contentType
内容类型，和互联网MIME标准中的规定类型一致，例如text/plain代表纯文本，text/xml表示XML，image/gif代表GIF图片，image/jpeg代表JPG图片
inputName
下载文件的来源流，对应着action类中某个类型为Inputstream的属性名，例如取值为inputStream的属性需要编写getInputStream()方法
contentDisposition
文件下载的处理方式，包括内联(inline)和附件(attachment)两种方式，而附件方式会弹出文件保存对话框，否则浏览器会尝试直接显示文件。取值为：
attachment;filename="struts2.txt"，表示文件下载的时候保存的名字应为struts2.txt。如果直接写filename="struts2.txt"，那么默认情况是代表inline，浏览器会尝试自动打开它，等价于这样的写法：inline;filename="struts2.txt"
bufferSize
下载缓冲区的大小
contentType属性和contentDisposition分别对应着HTTP响应中的头Content-Type和Content-disposition头。
如下例：
down.jsp
<a href="<s:url value='test/fileDown.do?fileName=struts2配置参数详解.txt'> </s:url>">下载</a>
struts.xml配置：
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<package name="com" namespace="/test" extends="struts-default">
<action name="fileDown" class="it.com.down.FileDown">
<result type="stream">
<!-- 下载文件类型定义 -->
<param name="contentType">
application/octet-stream
</param>
<!-- 下载文件输出流定义 -->
<param name="inputName">inputStream</param>
<!-- 下载文件处理方法 -->
<param name="contentDisposition">
attachment;filename="${fileName}"
</param>
<!-- 下载文件的缓冲大小 -->
<param name="bufferSize">4096</param>
</result>
</action>
</package>
</struts>
文件下载Action:
public class FileDown extends ActionSupport {
private String fileName;
public String getFileName() {
return fileName;
}
public void setFileName(String fileName) {
this.fileName = fileName;
}
public InputStream getInputStream() throws UnsupportedEncodingException {
return ServletActionContext.getServletContext().getResourceAsStream(
"/WEB-INF/" + fileName);
}
public String execute(){
System.out.println(fileName+"----------");
return "success";
}
}
这个例子运行可，可能会出现：下载页面的文件名为：fileDown.do或htm等情况。
这在实际保存时，要改成相应的文件名，在不知道原文件类型情况下就无法改了。
这种情况，可以这样解决：
将struts.xml配置改为：
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<package name="com" namespace="/test" extends="struts-default">
<result type="stream">
<!-- 下载文件类型定义 -->
<param name="contentType">
application/octet-stream
</param>
<!-- 下载文件输出流定义 -->
<param name="inputName">inputStream</param>
<!-- 下载文件的缓冲大小 -->
<param name="bufferSize">4096</param>
</result>
</action>
</package>
</struts>
文件下载action改为：
public class FileDown extends ActionSupport {
private String fileName;
public String getFileName() {
return fileName;
}
public void setFileName(String fileName) {
this.fileName = fileName;
}
public InputStream getInputStream(){
HttpServletResponse response = ServletActionContext.getResponse();
response.setHeader("Content-Disposition", "attachment;fileName="+
fileName);
return ServletActionContext.getServletContext().getResourceAsStream(
"/WEB-INF/" + fileName);
}
public String execute(){
System.out.println(fileName+"----------");
return "success";
}
}
这样就行了。
如果下载文件名称是中文，会出现乱码现象，解决方案：
将上面action相应的改为如下两步
（1）设置：
public void setFileName(String fileName) throws UnsupportedEncodingException {
this.fileName = new String(fileName.getBytes("ISO-8859-1"),"UTF-8");
}
（2）设置：
response.setHeader("Content-Disposition", "attachment;fileName="
+ java.net.URLEncoder.encode(fileName,"UTF-8"));
问题解决。
分享出来。。。希望能帮到大家