1.编写下载页面
<html>
<head> <title>文件下载</title> </head>
<body>
文件下载
<hr/>
<a href="fileDownload.action">点击此处下载风景图片</a>
</body>
</html>
2.Struts2实现文件下载的Action
Struts2的文件下载Action与普通的Action并没有太大的不同,仅仅是该Action需要提供一个返回InputStream流的方法,该输入流代表了被下载文件的入口。
该Action类的代码如下:
package action;
import java.io.InputStream;
import org.apache.struts2.ServletActionContext;
public class DownloadAction {
private String fileName;
public void setFileName(String fileName) {
try {// 解决中文文件名问题
this.fileName = new String(fileName.getBytes("ISO-8859-1"), "GBK");
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
}
public String getFileName() {
String name = "";
try {// 解决下载文件中文文件名问题
name = new String(fileName.getBytes("GBK"), "ISO8859-1");
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
return name;
}
public InputStream getInputStream() {
return ServletActionContext.getServletContext().getResourceAsStream("/" + fileName);
}
public String execute(){
return "success";
}
}
使用说明:
(1)getInputStream():该方法返回一个InputStream输入流,这个输入流返回的是下载目标文件的入口。
(2)使用getResourceAsStream方法时,文件路径必须是以“/”开头,且是相对路径。这个路径是相对于项目根目录的。
(3)可以用return new FileInputStream(fileName)的方法来得到绝对路径的文件。
3. 配置struts.xml
Struts2中实现文件的下载需要在struts.xml配置文件中配置文件下载拦截器download,并配置<result name="success" type="stream">中stream的参数值。
配置格式如下:
<struts>
<!-- 配置Struts2国际化资源文件的baseName -->
<constant name="struts.custom.i18n.resources" value="globalMessages"/>
<!-- 配置Struts2应用的编码集 -->
<constant name="struts.i18n.encoding" value="UTF-8"/>
<package name="default" extends="struts-default">
<!-- 配置下载的拦截器引用 -->
<default-action-ref name="download"/>
<action name="download" class="action.DownloadAction">
<!-- 指定被下载资源的位置 -->
<param name="fileName ">\ struts-gif.zip </param>
<!-- 配置结果类型为stream的结果 -->
<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
说明:
(1)当result为stream类型时,struts2会自动根据配置参数下载文件。
(2)contentType 参数:指定下载文件的文件类型——application/octet-stream表示无限制
(3)inputName参数: 流对象名——在Action中需要指定该输入流入口。
• 如果在Action中声明的是getInputStream()方法,在配置文件struts.xml中配置为<param name="inputName">inputStream</param>;
• 如果在Action中声明的是getTargetFile()方法,在配置文件struts.xml配置为<param name="inputName">targetFile</param>。
• 使用该配置,它就会自动去找Action中的getInputStream(或getTargetFile)方法。
(4)contentDisposition参数:指定文件下载的处理方式
使用经过转码的文件名作为下载文件名,并指定文件下载的处理方式:
• 内联方式(inline)表示浏览器会尝试直接显示文件,
• 附件方式(attachment)会弹出文件保存对话框,是默认方式,其格式是attachment;filename="${fileName}",
(5)bufferSize参数:下载文件的缓冲大小