一. 文件上传的原理
表单元素的enctype属性
enctype属性指定的是表单数据的编码方式,大部分时候无需设定表单元素的encype属性。
该属性有如下3个值:
application/x-www-form-urlencoded:这是默认的编码方式,它只处理表单域里的value属性值.采用这种编码方式的表单会将表单域的值处理成URL编码方式.
multipart/form-date:这种编码方式会以二进制流的方式来处理表单数据,这种编码方式会把文件域指定文件的内容也封装到请求参数里.
text/plain:这种编码方式当表单的action属性为mailto:URL的形式比较方便,这种方式主要适用于直接通过表单发送邮件的方式.
使用上传框架完成上传
对于Java应用而言,比较常用的上传框架有两个:Common-FileUpload和COS。不管使用哪个上传框架,框架都负责解析出HttpServletRequest请求中的所有域。
一旦通过上传框架获得文件域对于的文件内容,即可以通过IO流将文件内容写入服务器的任意位置,从而完成文件上传。
Common-FileUpload:该项目还依赖与另一个项目Common-IO.
实现文件上传的Action
Struts2默认使用的是Jakarta的Common-FileUpload的文件上传框架.
在Struts2的struts.properties配置文件中,有
struts.multipart.parser=jakarta
即上传使用jakarta的Common-FileUpload的文件上传框架
若需要使用struts2的文件上传功能,则需要在Web应用中增加两个JAR文件.
Struts2的文件上传支持在原有的文件上传项目上做进一步的封装.简化了上传的代码实现.取消了不同上传项目上的编程差异.
实现文件上传的Action
为了上传.将表单的enctype属性设置为multipart/form-date.
…
<from action=”upload” method=”post” enctype=”mulitipart/form-data”>
文件标题:<input type=”text” name=”title” /><br />
选择文件:<input type=”file” name=”upload” /><br />
<input name=”submit” type=”submit” value=”上传文件”/>
</from>
…
Struts2使用File类来封装文件域:
public class UploadAction extends ActionSupport{
private String title; //封装文件标题请求参数的属性
private File upload; //封装文件上传域请求的属性
private String uploadContentType; //封装上传文件类型的属性
private String uploadFileName; //封装上传文件名的属性
private String savePath; //接收依赖注入的属性
//接收依赖注入的方法
public void setSavePath(String value){
this.savePath=value;
}
//返回上传文件的保存位置
private String getSavePath() throws Exception{
retrun ServletActionContext.getRequest().getRealPath(savePath);
}
//文件标题的的setter和getter
public void setTitle(String title){
this.title=title;
}
public String getTitle(){
return this.title;
}
//上传文件内容的setter和getter
public void setUpload(File upload){
this.upload=upload;
}
public File getUpload(){
retrun this.upload
}
//上传文件的文件类型的setter和getter方法
public void setUploadContentType(String uploadContentType){
this. uploadContentType= uploadContentType;
}
public String getUploadContentType(){
return this.uploadContentType;
}
//上传文件的文件名的setter和getter
public void setUploadFileName(String uploadFileName){
this. uploadFileName= uploadFileName;
}
public String getUploadFileName(){
return this.uploadFileName;
}
public String execute() throws Exception{
FileOutputStream fos=new FileOutputStream(getSavePath()+”\\”+
getUploadFileName());
FileInputStream fis=new FileInputStream(getUpload());
byte[] buffer=new byte[1024];
int len=0;
while((len=fis.read(buffer))>0){
fos.write(buffer,0,len);
}
return SUCCESS;
}
}
以上Action的title,upload与普通Action没有区别.即这些属性对应了表单域的name属性,且封装两个表单域的请求参数.
但是以上Action还有uploadFileName,uploadContentType ,即上传文件名,上传文件类型.Action类直接通过File类直接封装了上传文件的内容.Struts2自动将文件域中包含的上传文件名和文件类型的信息封装到uploadFileName, uploadContentType.
可以认为:
若表单的文件域的name=”xxx”
则Action需要使用3个属性来封装文件域的信息:
类型为File的xxx属性:封转文件域对应的文件内容.
类型为String的xxxFileName属性:封装文件域对应的文件的文件名.
类型为String的xxxContentType属性:封装文件域对应的文件的文件类型.
通过以上属性,在execute()中即可以实现上传.
Action中还有savePath属性,该属性值通过配置文件来设置,从而允许动态设置该属性的值.
配置文件上传的Action
与普通Action的配置相似.只需要额外配置一个<param…/>元素,该元素用于为该Action的属性动态分配属性值.
在struts.xml中,
…
<!—设置应用使用的解码集-->
<constant name=”struts.custom.i18n.encoding” value=”GBK” />
<action name=”upload” class=”XXX.UploadAction”>
<!—设置Action的savePath属性 -->
<param name=”savePath”>/upload</param>
<result>/succ.jsp</result>
</action>
…
设置GBK解码是为了处理中文参数请求.
若上传内容可以被浏览器显示,则可以用struts2标签与HTML来显示上传内容.
…
<body>
上传成功<br />
文件标题:<s:property value=” +title” /><br />
文件为:<img src=”<s:property value=”’upload/’+uploadFileName” />” /><br />
</body>
…
文件下载
使用超链接实现简单下载
<a href=”文件路径”>下载</a>
Struts2提供Stream结果类型,该类型专门支持文件下载功能.
指定stream结果类型时需要指定一个inputName参数,该参数指定一个输入流.这个输入流是被下载文件的入口.
使用Struts2,实现文件下载的Action
Struts2的文件下载Action需要提供一个返回InputStream流的方法,该输入流代表了被下载文件的入口.该Action类的代码如下:
public class FileDownloadAction implements Action{
private String inputPath; //该属性是依赖注入的属性,在配置文件中动态指定属性值.
public void setInputPath(String value){ //依赖注入该属性值的setter方法
inputPath=value;
}
//下载用的Action应该返回一个InputStream实例.
//该方法对应在result里的inputName属性值为targetFile
public InputStream getTargetFile() throws Exception{
return ServletActionContext.getServletContext().getResourceAsStream(inputPath);
}
public String execute() throws Exception{
return SUCCESS;
}
}
该Action中包含了一个getTargetFile()方法,该方法返回一个InputStream输入流,该输入流返回的是下载目标文件的入口.由于方法名称为getTargetFile,所以Action有一个targetFile属性来返回下载文件.
一旦定义了该Action,就可以通过该Action来实现文件下载.
配置下载Action
与普通Action相似,配置普通Action的基础.再加上额外的download的拦截器引用.
除此之外,关键是需要配置一个类型为Stream的结果,配置时需要指定如下4个属性:
contentType:指定被下载文件的类型.该参数可以省略.
inputName:指定陪下载文件的入口输入流.必须指定该参数.
contentDisposition:指定下载的文件名.该参数可以省略.
格式:< contentDisposition >filename=”文件名称”</contentDisposition>
若不指定该参数,则下载的文件名是”Action名称.文件后缀”.
有些下载的文件可以直接在浏览器中显示.为了使文件下载到指定的浏览器下载目录中,则指定格式为:
< contentDisposition >attachment; filename=”文件名称” </contentDisposition>
bufferSize:指定下载文件时的缓冲大小.该参数可以省略.
以下是一个下载图片的Action配置.
<default-action-ref name=”download” />
<action name=”download” class=”XXX.FileDownloadAction”>
<param name=”inputPath”>\images\XXX.jpg</param>
<result name=”success” type=”stream”>
<param name=”contentType”>image/gif</param>
<param name=”inputName”>targetFile</param>
<param name=” contentDisposition”>filename=”struts.gif”</param>
<param name=” bufferSize”>4096 </param>
</result>
</action>
说明:
使用”inputName”参数指定下载流.以上配置中的targetFile默认为是Action的一个inputSream的属性.
在下载的Action中,必须指定返回InputSream getXxx().这里的Xxx应该是”inputName”指定的属性值.
getXxx()方法必须返回一个inputStream流,这里的返回方法可以有多种方式.以上例子中的写法是为了使用与web应用程序的可移植性.而且getResourceAsStream(String path)的参数,只能是相对路径.