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"));

问题解决。