从服务器发送一个文件到浏览器需要以下几个步骤
把HTTP响应里的ContentType标头设置为被下载文件的内容类型。ContentType标头的作用是表明数据包里的数据是什么类型,它由一个多媒体类型和一个子类型标识符组成(可以去http://www.iana.org/assignments/media-types/index.html 处查看所有标准内容类型)。若你不愿意查看内容类型,或者是你想让浏览器总是提示一个文件下载对话框,则只需要把它设置为Application/Octet-stream(不区分大小写)。
在HTTP响应里增加一个名为 Content-Disposition的标头并把它设置为attachment;filename="theFileName"。这里的"theFileName"为显示在下载对话框中文件的名字。
stream结果类型
Struts 2专门为文件下载提供了一种Stream结果类型。这个结果类型与我们经常使用的dispatcher结果类型不同,我们不需要为他配置一个JSP页面,下面为stream结果类型可以使用的参数:
参数名 - 数据类型 - 默认值 - 说明
inputName - String - inputStream - 一个动作类属性的名字,该属性返回的InputStream对象将被发送到浏览器 。
bufferSize - int - 1024 - 通过InputStream对象读取数据,通过OutputStream对象向浏览器发送数据时使用的缓冲区的长度。
contentType - String - text/plain - 用来设置HTTP响应里的Content-Type标头。
contentLength - int - 没有 - 用来设置HTTP响应里的Content-Length标头。
contentDisposition - String - inline - 用来设置HTTP响应里的Content-Disposition标头 。
示例:下载服务器上的指定文件
显示下载链接的页面:
Your Choice
view_image
download_image
struts.xml配置信息:
image/jpeg
filename="picture.jpg"
simpleDownloadStream
application/octet-stream
filename="picture.jpg"
simpleDownloadStream
可以看出,两个action都是使用同一个类SimpleFileDownloadAction实现的,他们的不同点仅仅在于"contentType"参数不同,将contentType参数设置为"image/jpeg",则动作将文件发送给浏览器,并让浏览器显示其内容。将contentType参数设置为"application/octet-stream",则动作将以文件下载的方式发送给浏览器。换一种说法就是,若为"image/jpeg",就是告诉浏览器这是一个jpg文件,请显示它的内容;若为"application/octet-stream",就是告诉浏览器,问用户想不想保存这个文件。
支持下载的动作类:
public class SimpleFileDownloadAction extends ActionSupport implementsServletContextAware
{
private static final long serialVersionUID = 620526993016670680L;
private ServletContext context;
@Override
public void setServletContext(ServletContext context)
{
this.context = context;
}
public InputStream getSimpleDownloadStream()
{
return context.getResourceAsStream("/download/10.JPG");
}
@Override
public String execute()
{
return SUCCESS;
}
}
该动作类实现了ServletContextAware接口,该接口提供一个setServletContext(ServletContext context)方法,实现该接口是为了方便获取ServletContext对象,该对象包含了一些辅助方法可以简化下载操作。getSimpleDownloadStream() 这个方法是这个类实现下载功能的核心,该方法的方法名称可以任意取,但是要符合JavaBean属性的规范,此方法名与stream结果类型中的"inputName"参数有关,该参数的值为方法名去掉get前缀将第一个字母改为小写,例如,方法名为getSimpleDownloadStream,那么参数的值就为simpleDownloadStream。这是因为Struts 2框架会在动作类里寻找将"inputName"参数的值加上"get"并且将值的第一个字母改为大写的方法,由该方法获取InputStream的对象。
测试:
在浏览器中输入:http://localhost:8081/Struts2/simple_download.jsp,获得如下界面:
分别点击view_image链接与download_image链接:
看到下载对话框上,我们设置的filename="picture"生效了,出现下载对话框后,我们点击保存,将它保存到D盘下:
点击保存,现在查看D盘:
看到我们成功下载图片!