java struts 文件下载_Struts2学习之文件下载

前言

上一篇文章总结了上传，说完上传，那就不得不说说下载了。说到下载，就要先看看《Struts2学习之结果类型总结》这篇文章中总结的结果类型了。

Struts2提供了stream结果类型，该结果类型就是专门用于支持文件下载功能的。指定stream结果类型时，需要指定一个inputName参数，该参数指定了一个输入流，这个输入流是被下载文件的入口。通过Struts2的文件下载支持，允许系统控制浏览者下载文件的权限。

实现文件下载的Action

实现文件的下载，思路无非都是这样的：

Request->File->Stream->Response

有了这样的思路，我们就知道，我们最终要给客户端返回一个Stream。那么我们在服务器的主要任务就是生成这个Stream。具体的代码如下：

配置Action

Struts2是以配置为主的框架。对此，在开发一个下载模块的时候，最重要的任务还是配置。主要涉及以下几个配置项的配置：

contentType – 指定被下载文件的类型，默认为text/plain

contentLength – 指定被下载文件的大小，浏览器根据这个来显示一个下载进度条

contentDisposition – 指定下载的文件名

inputName – 指定下载文件的入口输入流，默认为inputStream

bufferSize – 指定下载文件时的缓冲大小，默认为1024字节

对应的，我们的配置文件写法如下：

到此，我们在浏览器中输入：http://localhost:8080/Struts2DownloadDemo/download?fileName=struts2result.png就可以进行下载测试了。

为什么不用指定“contentLength”？

我们实现下载功能时，基本上都会指定下载文件的大小，好让浏览器知道我们下载文件的大小，从而正确的显示进度条等信息。然而，上面的配置中，我并没有指定contentLength参数，这是为什么？

当我们进行配置时，如果没有没有指定contentLength参数，这里就涉及到另一个协议——HTTP TRUNKED协议。该协议当content-Length未指定的时候，会对数据进行分片传输，并以0结尾，标示文件传输结束。同时，当文件大小不可知或未能明确给出时，会在http的响应报文中，给出Transfer-Encoding chunked字段；同时content-Length与Transfer-Encoding：chunked只能存在其一。

总结

我们在开发的过程中，经常会实现下载的功能，比如验证码，这个也需要下载功能。我们需要更多的实战去掌握这些知识点。

果冻想，认真玩技术的地方。

2016年5月5日 于呼和浩特。