天天看点

struts2实现文件下载

1 使用Struts2控制文件下载 可能很多人会觉得,文件下载太简单,直接在页面上给出一个超级链接,该链接的href属性等于要下载文件的文件名,不就可以实现文件下载了吗?大 部分时候的确可以实现文件下载,但如果该文件的文件名为中文文件名,则会导致下载失败;或者应用程序需要在让用户下载之前进行进一步检查,比如判断用户是 否有足够权限来下载该文件等。 看下面的一个原始的下载页面代码片段: <h1>原始的下载</h1> <ul><li> <!-- 包含中文文件名的下载链接 --> 下载Struts2的Logo:<a href="images/中.gif" target="_blank" rel="external nofollow" >下载图形文件</a> </li><li> 下载Struts2的Logo的压缩文件:<a href="images/struts-gif.zip" target="_blank" rel="external nofollow" >下载压缩文件</a> </li></ul> 上面页面的包含两个下载的超级链接,两个链接的资源都是存在的,但因为第一个资源文件的文件名是中文文件名,如果单击第一个超级链接,将出现如下图所示的页面。 从图中页面中椭圆形框包围的地方,我们看到被下载的文件名变成了包含大量%的字符串,很明显,这种文件名显然无法取得需要下载的文件。 为了解决这个问题,我们使用Struts2的文件下载支持来下载该文件。

2 实现文件下载的Action Struts2的文件下载Action与普通的Action并没有太大的不同,仅仅是该Action需要提供一个返回InputStream流的方法,该输入流代表了被下载文件的入口。该Action类的代码如下: public class FileDownloadAction implements Action { //该属性是依赖注入的属性,该属性可以在配置文件中动态指定该属性值 private String inputPath; //依赖注入该属性值的setter方法 public void setInputPath(String value) { inputPath = value; } public InputStream getTargetFile() throws Exception { return ServletActionContext.getServletContext().getResourceAsStream(inputPath); } //处理用户请求的execute方法,该方法返回success字符串 public String execute() throws Exception { return SUCCESS; } } 从上面的Action中看到,该Action中包含了一个getTargetFile()方法,该方法返回一个InputStream输入流,这 个输入流返回的是下载目标文件的入口。该方法的方法名为getTargetFile,表明该Action有一个targetFile属性来返回下载文件。 一旦我们定义了该Action,就可通过该Action来实现文件下载。

3 配置Action 配置该文件下载的Action与配置普通的Action并没有太大的不同,需要在配置普通Action的基础之上,在加上额外的download的拦截器引用。 除此之外,关键是需要配置一个类型为stream的结果,配置stream类型的结果时需要指定如下四个属性:  contentType:指定被下载文件的文件类型。  inputName:指定被下载文件的入口输入流。  contentDisposition:指定下载的文件名。  bufferSize:指定下载文件时的缓冲大小。 因为stream结果类型的逻辑视图是返回给客户端一个输入流,因此无需指定location属性。 提示:配置stream类型的结果时,因为无需指定实际的显示的物理资源,所以无需指定location属性,只需要指定inputName属性,该属性指向被下载文件。 下面是配置该下载所用的Action类的配置文件片段: <?xml version="1.0" encoding="GBK"?> <!-- 指定Struts2配置文件的DTD信息 --> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <!-- 配置Struts2国际化资源文件的baseName --> <constant name="struts.custom.i18n.resources" value="globalMessages"/> <!-- 配置Struts2应用的编码集 --> <constant name="struts.i18n.encoding" value="GBK"/> <package name="lee" extends="struts-default"> <!-- 配置下载的拦截器引用 --> <default-action-ref name="download"/> <action name="download" class="lee.FileDownloadAction"> <!-- 指定被下载资源的位置 --> <param name="inputPath">/images/中.gif</param> <!-- 配置结果类型为stream的结果 --> <result name="success" type="stream"> <!-- 指定下载文件的文件类型 --> <param name="contentType">image/gif</param> <!-- 指定下载文件的文件位置 --> <param name="inputName">targetFile</param> <param name="contentDisposition">filename="struts.gif"</param> <!-- 指定下载文件的缓冲大小 --> <param name="bufferSize">4096</param> </result> </action> </package> </struts> 如果通过上面的Struts2提供文件下载支持来实现文件下载,就可以实现包含中文文件名的文件下载。

上面的下载的方式没有办法动态的给定文件名,于是就将上面的方法进行了改进:

首先struts.xml配置文件如下:

<!-- 文件下载2-->

	<action name="filedown" class="com.actions.FileDownActions">

		<param name="inputPath">/upload/</param>

		<result name="success" type="stream">

			<param name="contentType">image/gif</param>

			<param name="inputName">targetFile</param>

			<param name="contentDisposition">filename="download.gif"</param> 

			<param name="bufferSize">4096</param>

		</result>

	</action>      

再就是html中加入:

<a href="filedown.action?download=52415.gif" target="_blank" rel="external nofollow" >download</a>

下面给出FileDownActions的代码:

package com.actions;



import java.io.InputStream;



import org.apache.struts2.ServletActionContext;



import com.opensymphony.xwork2.ActionSupport;



public class FileDownActions extends ActionSupport {

	private String download;

	private String inputPath;

	public String getInputPath() {

		return inputPath;

	}



	public void setInputPath(String inputPath) {

		this.inputPath = inputPath;

	}



	public String getDownload() {

		return download;

	}



	public void setDownload(String download) {

		this.download = download;

	}

	

	public InputStream getTargetFile() throws Exception 

	{ 

		return ServletActionContext.getServletContext().getResourceAsStream(inputPath+download); 

	} 

	public String execute(){

		return SUCCESS;

	}

}
           
通过上面的操作就可以实现文件的下载了