struts实现文件下载

  今天学习了如何用struts实现文件下载的功能,可以将服务器的文件下载到客户端。

  其实不用struts也可以实现下载,可以直接用一个链接,href里面写文件的目录。如:

1 <a href="download/123.rar">123.rar</a>

  这种方法简单,不过它只能下载压缩文件,而其他一些文件如文本文件、图片等都会直接在页面上面显示出来而不会下载到客户端,所以此方法不可取。

  下面介绍另一种方法,也就是用struts实现文件的下载。首先,在WebRoot目录下面建一个文件夹download,可以将文件上传到这个目录下面。下载文件也从该目录下面下载。然后新建一个TestAction类,代码如下(struts的配置这里就不讲了):

 1 public class TestAction extends ActionSupport{
 2     
 3     public String fileLoad() throws IOException{
 4         String fileName = ServletActionContext.getRequest().getParameter("fileName");
 5         //要处理中文乱码问题
 6         fileName = new String(fileName.getBytes("iso8859-1"),"utf-8");
 7         //要下载的哪个文件
 8         String path = ServletActionContext.getServletContext().getRealPath("/");//得到项目的根目录
 9         InputStream is = new FileInputStream(path+"/download/"+fileName);
10         
11         //下载到哪里?客户端
12         HttpServletResponse response = ServletActionContext.getResponse();
13         OutputStream os = response.getOutputStream();
14         //弹出下载的框filename:提示用户下载的文件名
15         response.addHeader("content-disposition", "attachment;filename="+java.net.URLEncoder.encode(fileName,"utf-8"));
16         
17         byte[] b = new byte[1024];
18         int size = is.read(b);
19         while(size>0){
20             os.write(b,0,size);
21             size = is.read(b);
22         }
23         is.close();
24         os.close();
25         return null;
26     }
27     
28 }

index.jsp的内容如下:

1 <a href="test!fileLoad.action?fileName=A.java">A.java</a>
2 
3 <a href="test!fileLoad.action?fileName=jquery.txt">jquery.txt</a>
4 
5 <a href="test!fileLoad.action?fileName=中文.txt">中文.txt</a>

文件下载分为两步:读文件、写文件。从服务器读取,然后写到客户端去,所以需要InputStream和OutputStream。然后设置content-disposition弹出下载提示框,提示用户下载的文件名和从何处下载的。下面一段代码是读写文件的金典代码,我也不多讲了!

1 byte[] b = new byte[1024];
2 int size = is.read(b);
3 while(size>0){
4     os.write(b,0,size);
5     size = is.read(b);
6 }

 实现下载功能要注意:因为是用链接传过来的文件名,所以必须处理中文乱码问题。

以上方法实现下载功能没有使用struts2里面自带的文件下载。下面使用struts2自带的方法实现文件下载功能。

struts.xml配置如下:

 1 <struts>
 2    <package name="com.action" extends="struts-default">
 3            <action name="download" class="com.action.FileLoadAction">
 4                <result name="success" type="stream">
 5                    <param name="contentType">application/txt;</param>
 6                    <param name="inputName">downloadFile</param>
 7                    <param name="bufferSize">2048</param>
 8                </result>
 9            </action>
10    </package>
11 </struts>    

FileLoadAction.java类

 1 public class FileLoadAction extends ActionSupport{
 2     private String fileName;
 3 
 4     public String getFileName() {
 5         return fileName;
 6     }
 7     public void setFileName(String fileName) throws UnsupportedEncodingException {
 8         this.fileName = new String(fileName.getBytes("iso8859-1"),"utf-8");
 9     }
10     public InputStream getDownloadFile() throws UnsupportedEncodingException, FileNotFoundException{
11         //attachment为进行文件保存,这个时候还可以附件另一个参数filename表示保存时的缺省名称
12         //inline为在线打开,不进行保存
13         ServletActionContext.getResponse().setHeader("Content-Disposition","attachment;fileName="+ java.net.URLEncoder.encode(fileName, "UTF-8"));
14         HttpServletResponse response = ServletActionContext.getResponse();
15         return new FileInputStream("d:/"+this.getFileName());
16     }
17     public String downloadFile(){
18         return SUCCESS;
19     }
20 }

index.jsp代码如下:

1 <%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
2 <%@taglib prefix="s" uri="/struts-tags" %>
3 
4 <s:url value="download.action" var="url">
5     <s:param name="fileName">中文.txt</s:param>
6 </s:url>
7 <a href="${url }">点击下载</a>

action特殊的地方在于result的类型是一个流(stream),配置stream类型的结果时,因为无需指定实际的显示的物理资源,所以无需指定location属性,只需要指定inputName属性,该属性指向被下载文件的来源,对应着Action类中的某个属性,类型为InputStream,,struts2会寻找一个返回类型为InputStream的方法getInputStream()(方法名最好为getInputStream,有人说此方法名可以为别的可能需要与struts.xml中的inputName保存一致下面有解释另一种理解:action中定义一个返回InputStream的方法,该方法作为被下载文件的入口,且需要配置stream类型结果时指定inputName参数,inputName参数的值就是方法去掉get前缀、首字母小写的字符串。

 

下面则列出了和下载有关的一些参数列表: 

参数说明 
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 
下载缓冲区的大小

 

 

 

 

 

posted @ 2013-02-03 23:27  残剑_  阅读(11028)  评论(1编辑  收藏  举报