Struts2的框架提供了现成的文件下载方式,大大简化了开发下载功能的便利性。网上的例子有很多,我把一些大家普遍比较关注的点,集中一下,给出一个整体方案。
一般我们照着书本或者网上的列子写出了一个Demo,都会存在几个疑问:
1.下载文件的文件名怎么搞?不搞的话浏览器默认名字是提交的action的名字,显然不好
2.文件名里面想搞中文,但是实际上下载文件名出现了乱码或不显示中文怎么搞?
3.文件的扩展名怎么搞?比如要下载的文件是word(doc,docx)或者excel(xls,xlsx)怎么办?难道让用户自己改扩展名,太不友好了吧。
下面我们逐个说明。
场景:我们需要下载存放在服务器tomcat中webapp文件夹,对应x项目根目录下“电子表格.xlsx"文件。即tomcatwebappx电子表格.xlsx文件。
并且希望用户下载的名字是“我的电子表格.xlsx”。
首先,如同Struts2框架处理其他问题一样,我们需要有一个标准的action类来对下载请求进行处理。
Action类:
Struts.xml的action配置
看完代码后的解释:
1.核心的下载功能是怎么实现的
第一,action类里面提供了InputStream流的对象is,并且在配置文件中,同Struts框架的inputName参数进行了绑定。Strut2利用Servlet本来就有的标准流服务提供给客户端的浏览器进行下载。
关键配置:
result的type不再是一般的"dispatcher",而是"stream",表明返回给客户端的是流对象。一个名字为"inputName"的param参数表示,你得告诉框架,
action类里面哪个参数是要提供下载的InputStream对象。我们这里就是is
关键代码:
InputStream对象 is,并且必须有对应的get方法,不然框架拿不到这个对象。注意大小写
为is对象赋值,得到真正文件的流对象。
2.名字怎么搞?
这种姿势搞(顺便把扩展名和中午字符一并搞了):
关键配置:
attachment标示告诉浏览器是附件,不要打开(有时候下载的文件是txt之类的有些浏览器默认自动打开,而不是下载)。
filename=&{fileName},指定要下载的文件是什么名字。${fileName}这个通配符加大括号表示,文件的名字不是fileName,而是在
action类中一个名字叫fileName的参数的值
关键编码:
由于浏览器在只能识别用ISO8859-1编码的UTF-8的字符串,所以我们需要在代码中把中文的文件名用ISO8859-1再重新编码一下。这样就解决了中文问题。
扩展名怎么解决?看上面的图,xlsx扩展名一并同文件名统一处理。下载的文件自然就带这个扩展名了。
以上,文章开头的三个问题得到解决。
至于buffersize就不解释了,所有的流传输肯定都有缓冲的概念。
有人可能会问,为什么action的配置中,param参数了没有如<param name="contentType">application/zip</param>这样的配置。其实这就是html页面的头部标记。
我不用是因为:
我不需要呀!因为result的type设置为stream,让浏览器已经知道了是流文件,再加上contentDisposition把文件名连同连扩展名都搞定了,加上这个头参数没啥用。不信可以加上,随便设置什么MIME的头标记,都不起作用了。
当然,如果每次下载的都是固定名字,配置文件也可以这样:
这串文字代表MIME协议(多用途的网际邮件扩充协议;)里面的xlsx格式。
下面附上MIME常用的数据类型对应关系:
.doc application/msword
以上