- 表单的enctype属性指定的是表单数据的编码方式,该属性有如下三个值:
1.application/x-www-form-urlencoded: 这是默认的编码方式,它只处理表单域里的value属性值,采用这种编码方式的表单会将表单域处理成URL编码方法.
2.multipart/form-data: 这种编码方式会以二进制流的方式来处理表单数据,这种编码方式会把文件域指定文件的内容也封装到请求参数里.
3.text/plain: 这种编码方式当表单的action属性为mailto:URL的形式时比较方便,这种方式主要适用于直接通过表单发送邮件的方式.
1. 上传文件的JSP:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib uri="/struts-tags" prefix="s"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>文件上传</title> </head> <body> <div style="color:red"> <s:fielderror/> </div> <!-- 为了完成文件上传,设置该表单的enctype属性为multipart/form-data --> <form action="upload.action" method="post" enctype="multipart/form-data"> 选择文件:<input type="file" name="upload" /> <input type="submit" value="上传" /> </form> </body> </html>
2. 下面是处理上传请求的Action类代码:
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.util.Date;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.Action;
public class UploadAction implements Action {
//封装上传文件域的属性
private File upload;
//封装上传文件类型的属性
private String uploadContentType;
//封装上传文件名的属性
private String uploadFileName;
//接受依赖注入的属性
private String savePath;
public void setSavePath(String savePath){
this.savePath = savePath;
}
public String getSavePath(){
return savePath;
}
public File getUpload() {
return upload;
}
public void setUpload(File upload) {
this.upload = upload;
}
public String getUploadContentType() {
return uploadContentType;
}
public void setUploadContentType(String uploadContentType) {
this.uploadContentType = uploadContentType;
}
public String getUploadFileName() {
return uploadFileName;
}
public void setUploadFileName(String uploadFileName) {
this.uploadFileName = uploadFileName;
}
@Override
public String execute() throws Exception {
String newFileName = null; // 新的文件名
long now = new Date().getTime(); // 得到当前时间自1970年1月1日0时0分0秒开始流逝的毫秒数,将这个毫秒数作为上传文件新的文件名
//得到保存上传文件的目录的真实路径
File filePath = new File(ServletActionContext.getRequest().getRealPath(savePath));
//如果目录不存在就创建
if(!filePath.exists())
filePath.mkdir();
//判断文件是否有扩展名
int index = uploadFileName.lastIndexOf('.');
if(index != -1)
newFileName = now + uploadFileName.substring(index);
else
newFileName = Long.toString(now);
// 以服务器的文件保存地址加上新的文件名建立上传文件输出流
FileOutputStream fos = new FileOutputStream(new File(filePath,newFileName));
// 以上传文件建立一个上传文件流
FileInputStream fis = new FileInputStream(upload);
byte[] buffer = new byte[1024*10];
int len = 0;
while((len=fis.read(buffer)) > 0 ){
fos.write(buffer, 0, len);
}
fis.close();
fos.close();
return SUCCESS;
}
}
- 值得注意的是,上面的Action还包含了两个属性:uploadFileName和uploadContentType,这两个属性分别用于封装上传文件的文件名、上传文件的文件类型。Action类直接通过File类属性直接封装了上传文件内容,但这个File属性无法获取上传文件的名和文件类型,所以Struts2直接将文件域中包含的上传文件名和文件类型的信息封装到uploadFileName和uploadContentType属性中。可以认为:如果表单中包含一个name属性为xxx的文件域,则对应Action需要使用3个属性来封装该文件域的信息:
- 类型为File的xxx属性封装了该文件域对应的文件内容。
- 类型为String的xxxFileName属性封装了该文件域对应的文件的文件名。
- 类型为String的xxxContentType属性封装了该文件域对应的文件的文件类型。
3. 以下是Struts.xml配置文件的代码:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <!-- 指定国际化资源文件的baseName为globalMessage --> <constant name="struts.custom.i18n.resources" value="globalMessage" /> <!-- 设置该应用使用的解码集 --> <constant name="struts.i18n.encoding" value="UTF-8" /> <package name="lee" extends="struts-default"> <!-- 配置处理文件的Action --> <action name="upload" class="lee.UploadAction"> <!-- 配置fileUpload的拦截器 --> <interceptor-ref name="fileUpload"> <!-- 配置允许上传的文件类型 --> <param name="allowedTypes">image/bmp,image/png,image/gif,image/jpg,image/pjpeg,image/jpeg</param> <!-- 配置允许上传的文件大小 --> <param name="maximumSize">500000</param> </interceptor-ref> <interceptor-ref name="defaultStack" /> <!-- 设置Action的属性值,文件保存路径 --> <param name="savePath">/upload</param> <!-- 配置Struts2默认的视图页面 --> <result>/succ.jsp</result> <!-- 配置该应用的input逻辑视图 --> <result name="input">/upload.jsp</result> </action> </package> </struts>
- Struts2 中文件上传的过滤器是fileUpload,配置fileUpload拦截器时,可以为其指定两个参数:
- allwedTypes: 该参数指定允许上传的文件类型,多个文件类型之间以逗号隔开。
- maximumSize:该参数指定允许上传的文件大小,单位是字节。
- 当文件过滤失败后,系统自动转入input逻辑视图,因此必须为该Action配置名为input的逻辑视图。除此之外,还必须显示地为该Action配置defaultStack的拦截器引用,并将defaultStack放到fileUpload拦截器后。
4. web.xml文件的配置:
<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" id="WebApp_ID" version="2.5"> <display-name>test</display-name> <!-- 定义Struts2 的核心Filter --> <filter> <filter-name>struts</filter-name> <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class> </filter> <!-- 定义Struts2核心Filter拦截的URL --> <filter-mapping> <filter-name>struts</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> </web-app>
5. 输入错误提示
如果上传失败,系统返回原来的上传页面,并输入提示信息,采用国际化信息替换系统默认的提示信息
globalMessage.properties 文件的代码:
struts.messages.error.uploading=文件上传错误
struts.messages.error.content.type.not.allowed=不允许上传这种类型的文件
struts.messages.error.file.too.large=上传的文件超过了限制的长度
- 当每次上传文件时,都可以在Tomcat的控制台看见如下所示的输入信息:
INFO(org.apache.Struts2.dispatcher.Dispatcher:624)-Unable to find 'struts.multipart.saveDir'property setting.Defaulting to javax.servlet.context.tempdir
INFO(org.apache.Struts2.interceptor.FileUploadInterceptor:277)-Removing file upload D:\tomcat5520\work/Catalina\localhost\simpleUpload\ upload_103b2706_112b45dc4a3_8000_00000001.tmp- 其中第一个提示信息说,系统找不到struts.multipart.saveDir属性的设置,默认使用javax.servlet.context.tempdir路径,这是因为Struts2执行文件上传过程中,需要指定一个临时文件夹,如果没有指定临时文件夹,系统默认使用javax.servlet.context.tempdir,在Tomcat安装路径下的work\Catalina\localhost\路径下。
- 第二个提示信息说,系统正在删除一个临时文件,该临时文件就是上传过程中产生的临时文件。
如果为了避免文件上传是使用Tomcat的工作路径为临时路径,则应该设置struts.multipart.saveDir属性。设置该属性可以通过struts.properties文件设置,如:struts.multipart.saveDir = /tmp
也可以通过Struts.xml文件的常量配置,如:<constant name="struts.multipart.saveDir" value="/tmp"/> - 除此之外,还有一个文件上传的属性:struts.multipart.maxSize,该属性设置整个表单请求内容的最大字节数。