之前介绍servlet3.0新特性的时候有提到过servlet API提供了一个part类来实现对文件的上传和保存,Struts其实是在其基础上做了进一步的封装,更加简单易用。至于文件下载,Struts贯彻AOP 思想,在下载之前提供对用户权限控制的API。下面我们将详细介绍上传和下载的相关内容。
一、Struts文件上传机制
想要实现文件上传功能,页面的表单的method属性必须被指定为post,还有enctype属性必须为multipart/form-data,该值表示上传的内容将会以二进制的形式被上传到服务器,至于该属性的其他值的作用及他们之间的区别,请查看之前文章:servlet3.0新特性。下面给出表现层页面代码:
<body>
<s:form method="post" enctype="multipart/form-data" action="/upload">
<s:file name="ufile" label="浏览"/>
<s:submit value="上传"/>
</s:form>
</body>
实际上在Struts的文件上传中,它使用三个Action属性来描述被上传的文件。commons-fileupload-1.3.2.jar和commons-io-2.2.jar这两个包就是用于辅助表单上传的内容赋值到action属性中,所以在使用Struts的文件上传之前应当先包含着两个包到项目中。下面给出upload对应的action:
public class UploadFile extends ActionSupport {
//封装的上传文件的文件内容
private File ufile;
//封装的上传文件的文件名
private String ufileFileName;
//封装的上传文件的文件类型
private String ufileContentType;
....省去getter,setter方法
public String execute() throws IOException {
FileInputStream fin = new FileInputStream(ufile);
FileOutputStream fos = new FileOutputStream("F:\\360\\"+ufileFileName);
byte[] buffer = new byte[1024];
int len;
while((len = fin.read(buffer))>0){
fos.write(buffer,0,len);
}
return SUCCESS;
}
}
先不看execute方法,在该action中,我们可以看到有三个属性。ufile封装了上传的文件的二进制内容,ufileFileName(xxxFileName)封装了该文件的文件名,ufileContentType(xxxContentType)封装了该文件的类型。他们的值是我们不必关心的,框架会根据表单上传的文件对他们进行赋值,只需要遵守他的命名规则即可。
execute方法主要是完成将上传的文件保存到硬盘上,代码也比较简单,读取属性ufile中的内容,写入磁盘指定位置。下面我们看看运行的结果截图:
至此我们就完成了对上传文件的获取保存,总体上看来,实际上还是使用了三个action实例属性对上传文件相关信息的封装。一个属性封装的是该上传文件的二进制内容,一个属性封装该文件的文件名称,一个属性封装的是该文件的文件类型。实际上把控好这三个属性,基本可以完成对该上传文件的所有操作。下面我们看文件下载。
二、Struts文件下载机制
广义上的文件下载,其实可以使用a标签链接到对应资源完成对资源的下载,但是在浏览器中使用这种方式会导致浏览器直接打开该资源文件而非弹出下载框指定下载位置。Struts下载机制通过配置result元素的type属性为stream来实现的。在类型为stream的result元素中可以配置一些参数,这些参数主要有以下一些:
- contentType:指定被下载文件的文件类型
- inputName:指定被下载文件的输入流入口
- contentDisposition:指定下载文件的文件名
- bufferSize:指定下载文件的缓冲大小
具体的应用我们从代码示例中体会:
//直接访问的action
<body>
<a href="/download">下载资源</a>
</body>
public class DownloadFile extends ActionSupport {
private String inputPath;
public void setInputPath(String s){
this.inputPath = s;
}
public String getInputPath(){
return this.inputPath;
}
public InputStream getTarFile(){
return ServletActionContext.getServletContext().getResourceAsStream(inputPath);
}
@Override
public String execute(){
return SUCCESS;
}
}
//download的action配置
<action name="download" class="MyPackage.DownloadFile">
<param name="inputPath">/m.jpg</param>
<result type="stream">
<param name="inputName">tarFile</param>
<param name="contentType">image/jpg</param>
<param name="contentDisposition">attachment;filename="walker.jpg"</param>
</result>
</action>
首先解析下Struts.xml中有关action的配置代码,第一个param元素为action中的属性inputPath动态赋值,该参数的值指定了将要被下载的文件资源位置,我们此处指定的web应用根目录下的一张图片。
接下来就是配置的结果类型result,该元素的默认type属性为dispather表示分发的意思,而我们此处的stream表示流的意思,它将返回给浏览器一个InputStream(被下载文件的入口)。其中它配置了inputName,该参数的值对应于action中getXXXX方法,当接受到请求的时候,框架会通过该参数匹配调用action中的getXXXX方法,该方法会根据指定资源路径返回该文件的入口InputStream,交给浏览器。
我们也看到contentType参数指定了该文件的类型,和互联网MIME标准中的规定类型一致,例如:text/plain代表纯文本,text/xml表示XML,image/gif代表GIF图片,image/jpeg代表JPG图片等。
contentDisposition参数表示被下载文件在保存时候的文件名,它有两个属性值。第一个属性值可以是inline或者attachment,它指定浏览器是直接打开还是下载,filename指定了下载或者打开文件的名称。下面看上述代码的运行结果截图:
至此,有关Struts控制文件的上传和下载的相关内容已经简单介绍完了,有些核心的,深层次的内容涉及到拦截器,所以当我们介绍完拦截器之后,想必大家会有更加深刻的理解。下篇文章开始总结拦截器相关知识,总结的不好,海涵。