理解和灵活应用 Struts2 的文件下载功能

小鱼儿 2022-08-06 11:06 163阅读 0赞

文件下载给我们最直接的概念就是，给个文件链接点击就下载。似乎太简单，然而 Struts2 却把它作为一个独立的学问来对待，理由有四：  
  
1. 文件名为中文时，直接点击下载，链接可能会走样(某些浏览器，URL 编码的问题)，致使无法下载。  
2. 不总是从下载实际的文件，文件内容有时候是动态生成的，如数据库中的内容。  
3. 对于知名的文件类型不让浏览器直接打开，而是出现下载对话框保存文件。例如，要下载的文件是 .txt 的，可能直接就在浏览器中显示其内容。  
4. 需要授权才能下载文件时  
  
当然对于以上若干问题，Servlet/JSP 都能通过正确的 URL 编码，响应头设置、权限代码控制解决，只是 Struts2 让我们处理起来更方便了，内部原理自然是一样的。  
  
先来看下 Servlet 如何实现文件下载的，直接见代码：  
  
PrintWriter out = response.getWriter(); //不管实际类型，待下载文件 ContentType 统一指定为 application/octet-stream response.setContentType("application/octet-stream"); //中文文件名必须转码为 ISO8859-1,否则为乱码 String fileName = new String("文本文件.txt".getBytes(), "ISO8859-1"); //作为附件下载，相应的 "inline;filename = "+fileName 是在线(浏览器中显示内容)打开 response.setHeader("Content-Disposition", "inline;filename = " + fileName); //因为文件编码也为 ISO8859-1，所以内容须转码成 ISO8859-1,尚不知如何控制下载文本文件的编码 //或有谁知道的，还请告诉我一下。 文件内容可以从物理文件中来，或者数据库中读取填入等等 out.write(new String("Servlet 文件下载测试".getBytes(), "ISO8859-1"));  
知道了上面各行的含义，再来看下 Struts2 的解决方式，其实不过是把某些代码的功能移入到了配置文件而已。在李刚所著的《Struts 2 权威指南》中说 Struts 实现文件下载是由一个 download 拦截器。其实不然，只是一个 StreamResult(org.apache.struts2.dispatcher.StreamResult) 而已，也不像实现文件上传那样要额外的 JAR 包。在 StreamResult 中有以下几个默认属性要留意一下：  
  
    public static final String DEFAULT\_PARAM = "inputName";

protected String contentType = "text/plain";  
    protected String contentDisposition = "inline";  
    protected String inputName = "inputStream";  
    protected InputStream inputStream;  
    protected int bufferSize = 1024;  
  
StreamResult 的实现细节敬请阅读它的源代码，实现过程一言以蔽之就是：从 inputStream 获取内容，以相应的 contentType、contentDisposition 和 bufferSize 输出给浏览器，对 contentType 和 contentDisposition 的相应设置就能实现文件下载，可对照前面 Servlet 的实现。看个实际的例子吧。  
  
struts.xml 中 Action 的配置，假定 Action 类为 com.unmi.DownLoadAction  
  
<action name="download" class="com.unmi.action.DownloadAction"> <result name="success" 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>  
说明：对于上面的配置其他参数可以用默认值，关键就是 contentDisposition 要设置为 attachment 才能提示下载，同时用 filename 指定文件名，若直接指定非动态的文件名。  
  
DownloadAction 代码，需要实现 getInputStream() 返回输入流；因前面用的动态文件名，所以须加上 getFileName() 返回文件名，若非动态文件名，则该方法可省去。  
  
package com.unmi.action; import java.io.\*; import java.text.\*; import java.util.Date; /\*\* \* 文件下载的 Action \* @author Unmi \*/ public class NetbookSerialAction \{ public String execute() throws Exception \{ //这里可加入权限控制 return "success"; \} //获得下载文件的内容，可以直接读入一个物理文件或从数据库中获取内容 public InputStream getInputStream() throws Exception \{ //return new FileInputStream("somefile.rar"); 直接下载 somefile.rar //和 Servlet 中不一样，这里我们不需对输出的中文转码为 ISO8859-1 return new ByteArrayInputStream("Struts2 文件下载测试".getBytes()); \} //对于配置中的 $\{fileName\}, 获得下载保存时的文件名 public String getFileName() \{ DateFormat df = new SimpleDateFormat("yyyy-MM-dd"); String fileName = "序列号(" + df.format(new Date()) + ").txt"; try \{ //中文文件名也是需要转码为 ISO8859-1，否则乱码 return new String(fileName.getBytes(), "ISO8859-1"); \} catch (UnsupportedEncodingException e) \{ return "impossible.txt"; \} \} \}  
  
谨记一个就是，要想下载的文件名不乱码就要以 ISO8859-1 字符集进行转码，内容会否乱码可在调试中解决。  
  
好啦，启动服务，访问 [http://localhost:8080/teststruts2/download.action][http_localhost_8080_teststruts2_download.action]，浏览器便会提示下载 序列号(2009-06-17).txt，内容为：“Struts2 文件下载测试”。  
  
参考：1. [浅谈Struts2下载文件的方法实现][Struts2]  
        2. [struts2多文件动态下载及中文解决方案][struts2]

[http_localhost_8080_teststruts2_download.action]: http://localhost:8080/teststruts2/download.action
[Struts2]: http://it.hexun.com/2009-06-04/118322014.html
[struts2]: http://www.xileju.biz/index.php/74/