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

<ahref="<s:urlvalue='test/fileDown.do?fileName=struts2配置参数详解.txt'></s:url>">下载</a>

struts.xml配置：

<?xmlversion="1.0"encoding="UTF-8"?>
<!DOCTYPEstrutsPUBLIC
"-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>

<packagename="com"namespace="/test"extends="struts-default">
<actionname="fileDown"class="it.com.down.FileDown">

<resulttype="stream">

<!--下载文件类型定义-->
<paramname="contentType">
application/octet-stream
</param>

<!--下载文件输出流定义-->
<paramname="inputName">inputStream</param>
<!--下载文件处理方法-->

<paramname="contentDisposition">
attachment;filename="${fileName}"
</param>

<!--下载文件的缓冲大小-->
<paramname="bufferSize">4096</param>
</result>
</action>
</package>

</struts>

文件下载Action:

publicclassFileDownextendsActionSupport{
privateStringfileName;

publicStringgetFileName(){
returnfileName;
}

publicvoidsetFileName(StringfileName){

this.fileName=fileName;

}

publicInputStreamgetInputStream()throwsUnsupportedEncodingException{

returnServletActionContext.getServletContext().getResourceAsStream(
"/WEB-INF/"+fileName);
}

publicStringexecute(){
System.out.println(fileName+"----------");
return"success";
}

}

这个例子运行可，可能会出现：下载页面的文件名为：fileDown.do或htm等情况。

这在实际保存时，要改成相应的文件名，在不知道原文件类型情况下就无法改了。

这种情况，可以这样解决：

将struts.xml配置改为：

<?xmlversion="1.0"encoding="UTF-8"?>
<!DOCTYPEstrutsPUBLIC
"-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>

<packagename="com"namespace="/test"extends="struts-default">

<resulttype="stream">

<!--下载文件类型定义-->
<paramname="contentType">
application/octet-stream
</param>

<!--下载文件输出流定义-->
<paramname="inputName">inputStream</param>
<!--下载文件的缓冲大小-->
<paramname="bufferSize">4096</param>
</result>
</action>
</package>

</struts>

文件下载action改为：

publicclassFileDownextendsActionSupport{
privateStringfileName;

publicStringgetFileName(){
returnfileName;
}

publicvoidsetFileName(StringfileName){

this.fileName=fileName;

}

publicInputStreamgetInputStream(){

HttpServletResponseresponse=ServletActionContext.getResponse();
response.setHeader("Content-Disposition","attachment;fileName="+
fileName);

returnServletActionContext.getServletContext().getResourceAsStream(
"/WEB-INF/"+fileName);
}

publicStringexecute(){
System.out.println(fileName+"----------");
return"success";
}

}
这样就行了。

如果下载文件名称是中文，会出现乱码现象，解决方案：

将上面action相应的改为如下两步

（1）设置：
publicvoidsetFileName(StringfileName)throwsUnsupportedEncodingException{

this.fileName=newString(fileName.getBytes("ISO-8859-1"),"UTF-8");
}
（2）设置：
response.setHeader("Content-Disposition","attachment;fileName="
+java.net.URLEncoder.encode(fileName,"UTF-8"));

问题解决。

分享出来。。。希望能帮到大家