Struts2 文件下载(中文处理方法以及控制下载文件名称和扩展名)

Struts2的框架提供了现成的文件下载方式,大大简化了开发下载功能的便利性。网上的例子有很多,我把一些大家普遍比较关注的点,集中一下,给出一个整体方案。

一般我们照着书本或者网上的列子写出了一个Demo,都会存在几个疑问:

1.下载文件的文件名怎么搞?不搞的话浏览器默认名字是提交的action的名字,显然不好

2.文件名里面想搞中文,但是实际上下载文件名出现了乱码或不显示中文怎么搞?

3.文件的扩展名怎么搞?比如要下载的文件是word(doc,docx)或者excel(xls,xlsx)怎么办?难道让用户自己改扩展名,太不友好了吧。

下面我们逐个说明。

场景:我们需要下载存放在服务器tomcat中webapp文件夹,对应x项目根目录下“电子表格.xlsx"文件。即tomcatwebappx电子表格.xlsx文件。

并且希望用户下载的名字是“我的电子表格.xlsx”。

首先,如同Struts2框架处理其他问题一样,我们需要有一个标准的action类来对下载请求进行处理。

Action类:

  Struts2 文件下载(中文处理方法以及控制下载文件名称和扩展名)

Struts.xml的action配置

 Struts2 文件下载(中文处理方法以及控制下载文件名称和扩展名)

看完代码后的解释:

1.核心的下载功能是怎么实现的

 第一,action类里面提供了InputStream流的对象is,并且在配置文件中,同Struts框架的inputName参数进行了绑定。Strut2利用Servlet本来就有的标准流服务提供给客户端的浏览器进行下载。

  关键配置:

  result的type不再是一般的"dispatcher",而是"stream",表明返回给客户端的是流对象。一个名字为"inputName"的param参数表示,你得告诉框架,

action类里面哪个参数是要提供下载的InputStream对象。我们这里就是is

  Struts2 文件下载(中文处理方法以及控制下载文件名称和扩展名)

     关键代码:

  InputStream对象 is,并且必须有对应的get方法,不然框架拿不到这个对象。注意大小写

     Struts2 文件下载(中文处理方法以及控制下载文件名称和扩展名)

      Struts2 文件下载(中文处理方法以及控制下载文件名称和扩展名)

  为is对象赋值,得到真正文件的流对象。

Struts2 文件下载(中文处理方法以及控制下载文件名称和扩展名)

    

 2.名字怎么搞?

 这种姿势搞(顺便把扩展名和中午字符一并搞了):

   关键配置:

Struts2 文件下载(中文处理方法以及控制下载文件名称和扩展名)

  attachment标示告诉浏览器是附件,不要打开(有时候下载的文件是txt之类的有些浏览器默认自动打开,而不是下载)。

  filename=&{fileName},指定要下载的文件是什么名字。${fileName}这个通配符加大括号表示,文件的名字不是fileName,而是在

 action类中一个名字叫fileName的参数的值

  关键编码:

  Struts2 文件下载(中文处理方法以及控制下载文件名称和扩展名)

Struts2 文件下载(中文处理方法以及控制下载文件名称和扩展名)

Struts2 文件下载(中文处理方法以及控制下载文件名称和扩展名)

  由于浏览器在只能识别用ISO8859-1编码的UTF-8的字符串,所以我们需要在代码中把中文的文件名用ISO8859-1再重新编码一下。这样就解决了中文问题。

 扩展名怎么解决?看上面的图,xlsx扩展名一并同文件名统一处理。下载的文件自然就带这个扩展名了。

以上,文章开头的三个问题得到解决。

至于buffersize就不解释了,所有的流传输肯定都有缓冲的概念。

有人可能会问,为什么action的配置中,param参数了没有如<param name="contentType">application/zip</param>这样的配置。其实这就是html页面的头部标记。

我不用是因为:

我不需要呀!因为result的type设置为stream,让浏览器已经知道了是流文件,再加上contentDisposition把文件名连同连扩展名都搞定了,加上这个头参数没啥用。不信可以加上,随便设置什么MIME的头标记,都不起作用了。

当然,如果每次下载的都是固定名字,配置文件也可以这样:

Struts2 文件下载(中文处理方法以及控制下载文件名称和扩展名)

Struts2 文件下载(中文处理方法以及控制下载文件名称和扩展名)

这串文字代表MIME协议(多用途的网际邮件扩充协议;)里面的xlsx格式。

下面附上MIME常用的数据类型对应关系:

.doc     application/msword

.docx   application/vnd.openxmlformats-officedocument.wordprocessingml.document
.rtf       application/rtf
 
.xls     application/vnd.ms-excel application/x-excel
.xlsx    application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
 
.ppt     application/vnd.ms-powerpoint
.pptx    application/vnd.openxmlformats-officedocument.presentationml.presentation
 
.pps     application/vnd.ms-powerpoint
.ppsx   application/vnd.openxmlformats-officedocument.presentationml.slideshow
 
.pdf     application/pdf
.swf    application/x-shockwave-flash
.dll      application/x-msdownload
 
.exe    application/octet-stream
.msi    application/octet-stream
.chm    application/octet-stream
.cab    application/octet-stream
.ocx    application/octet-stream
 
.rar     application/octet-stream
.tar     application/x-tar
.tgz    application/x-compressed
.zip    application/x-zip-compressed
.z       application/x-compress
 
.wav   audio/wav
.wma   audio/x-ms-wma
.wmv   video/x-ms-wmv
.mp3 .mp2 .mpe .mpeg .mpg     audio/mpeg
.rm     application/vnd.rn-realmedia
 
.mid .midi .rmi     audio/mid
 
.bmp     image/bmp
.gif     image/gif
.png    image/png
.tif .tiff    image/tiff
.jpe .jpeg .jpg     image/jpeg
 
.txt      text/plain
.xml     text/xml
.html     text/html
.css      text/css
.js        text/javascript
 
.mht .mhtml   message/rfc822

以上