Struts2多文件动态下载及中文解决方案

关于文件上传的例子,网上已经有很多,所以本文就不谈文件上传,重点是文件下载及文件名为中文的时候各个浏览器出现乱码的解决方案。

下面是jsp文件的代码:

  1. <html>
  2.   <head>
  3.    <title>download</title>
  4.   </head>
  5.   <body>
  6.    <%
  7.     //取得服务器"/download/file"目录的物理路径
  8.     String path = request.getRealPath("/download/file");
  9.     //取得"/download/file"目录的file对象
  10.     File file = new File(path);
  11.     //取得file目录下所有文件
  12.     File[] files = file.listFiles();
  13.  
  14.    for (int i = 0; i < files.length; i++) {
  15.  
  16.     String fname = files[i].getName();
  17.  
  18.     //对文件名进行url编码(UTF-8指明fname原来的编码,UTF-8一般由本地编码GBK代替)
  19.      fname = java.net.URLEncoder.encode(fname, "UTF-8");
  20.  
  21.     out.println("<a href=download.action?name=" + fname + ">"
  22.      + files[i].getName() + "</a><br>");
  23.     }
  24.    %>
  25.   </body>
  26.  </html>

相应的DownloadAction.java的代码:

  1. package com.test.action;
  2.  
  3. import java.io.InputStream;
  4.  import java.io.UnsupportedEncodingException;
  5.  import com.opensymphony.xwork2.ActionSupport;
  6.  import org.apache.struts2.ServletActionContext;
  7.  
  8. public class DownloadAction extends ActionSupport {
  9.      private static final long serialVersionUID = 6329383258366253255L;
  10.  
  11.      private String fileName;
  12.  
  13.      public void setFileName(){
  14.          //得到请求下载的文件名
  15.          String fname=ServletActionContext.getRequest().getParameter("name")
  16.          try {
  17.          /*
  18.           * 对fname参数进行UTF-8解码,注意:实际进行UTF-8解码时会使用本地编码,本机为GBK。
  19.           * 这里使用request.setCharacterEncoding解码无效.
  20.           * 只有解码了getDownloadFile()方法才能在下载目录下正确找到请求的文件
  21.           * */  
  22.                fname = new String(fname.getBytes("ISO-8859-1"), "UTF-8");
  23.  
  24.        } catch (Exception e) {
  25.              e.printStackTrace();
  26.         }  
  27.         this.fileName=fname;  
  28.         System.out.println(fileName)
  29.     }
  30.  
  31.        /*
  32.         * @getFileName
  33.         * 此方法对应的是struts.xml文件中的:
  34.         * <param name="contentDisposition">attachment;filename="${fileName}"</param>
  35.         * 这个属性设置的是下载工具下载文件时显示的文件名,
  36.         * 要想正确的显示中文文件名,我们需要对fileName再次编码
  37.         * 否则中文名文件将出现乱码,或无法下载的情况
  38.         * */
  39.       public String getFileName() throws UnsupportedEncodingException {
  40.   
  41.           fileName=new String(fileName.getBytes(),"ISO-8859-1");
  42.   
  43.           return fileName;
  44.       }
  45.  
  46.      /*
  47.        * @getDownloadFile
  48.        * 此方法对应的是struts.xml文件中的:
  49.        * <param name="inputName">downloadFile</param>
  50.        * 返回下载文件的流,可以参看struts2的源码
  51.        * */
  52.       public InputStream getDownloadFile() {
  53.   
  54.          this.setFileName();
  55.  
  56.          return ServletActionContext.getServletContext().getResourceAsStream("/download/file/" + fileName);
  57.       }
  58.  
  59.      @Override
  60.       public String execute() throws Exception {
  61.           return SUCCESS;
  62.      }
  63.  }

struts.xml相应的Action配置:

  1. <action name="download" class="com.test.action.DownloadAction">
  2.       <result name="success" type="stream">
  3.           <param name="contentDisposition">attachment;filename="${fileName}"</param> 
  4.           <param name="inputName">downloadFile</param>
  5.       </result>
  6.    </action>

web.xml:

  1. <filter>
  2.     <filter-name>struts2</filter-name>
  3.     <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>
  4.  </filter>
  5.   <filter-mapping>
  6.     <filter-name>struts2</filter-name>
  7.     <url-pattern>/*</url-pattern>
  8.   </filter-mapping>
  9.  
  10.   <welcome-file-list>
  11.     <welcome-file>download.jsp</welcome-file>
  12.   </welcome-file-list>

www.xileju.biz

www.xileju.biz

www.xileju.biz

www.xileju.biz

      本文的源代码在IE8.0Bate1、firefox3.0RC1、Opera下均测试通过,能够正常下载及正确显示中文文件名。

      相对于文件上传来说,下载要相对简单的多,但是如何让浏览器下载窗口显示中文名却是一件头痛的事,我曾在execute方法里加上这样一段代码:

ServletActionContext.getResponse().setHeader("Cont ent-Disposition","attachment; filename="+ new String(this.getFileName().getBytes("GBK"),"ISO-8859-1"));

      这是由于比较固执的想法和观念没有改变造成的,总想着我要去设置setHeader,告诉浏览器这是一个下载文件并把文件名经过相应的编码给它,让它能正 确显示。事实证明这样做会带来一件让人沮丧的事,就是不管你怎么设它,在firefox和Opera里面中文文件名它都是乱码,好不容易把它转成中文显示 了,却发现文件的后缀名最后有一个英文的逗号,也就是说,用户在下载了相应的文件后要自己手动去改后缀名,才能正常使用这个文件,可想而知,这是不现实 的。我曾想过去判断用户所使用的浏览器,如果不是IE的话,我就把最后那个逗号给截了。可谁知道要是换了别的应行环境它出现的是不是还是逗号,而且这个逗 号是怎么来的,为什么是逗号,我一无所知,要是在别的环境下它出现的不是逗号,我是不是要去重新改代码,这更是一件不现实的事。还好最后我没这样做,要是 这样做了,那真是傻得没药救了!

      事实上struts2中很多功能都为我们封装得很好了,只要我们给它属性注入相应的值,程序就能正常的跑起来。文件的下载也不例外,我们找到这样一个类 StreamResult,文件的下载由这个类全部为我们完成。其中有一个非常重要的属性contentDisposition,这个属性决定了下载窗口 中显示的文件名,不用我们像上面一样去手动设置response的setHeader,我们只要给这个属性注入正确的值,一切就OK。

      而这个值需要去struts.xml文件里相应的action里去配置,由于是动态决定下载的文件,这里使用了EL表达式,${fileName},而 fileName对应的则是DownloadAction里的getFileName()方法,只要在这里给fileName相应的编码,struts2 会自动寻找这个方法,并把相应的值注入到xml文件中,这样浏览器的下载窗口中就能正常显示我们想要的中文名。

共有0个回答