struts2本身没有提供解析上传文件内容的功能,但是他使用第三方组件提供对文件上传的支持。struts2的默认的文件上传组件是apache的commons-fileupload组件,该组件性能优异而且支持任意大小的文件上传。commons-fileupload组件从1.1版本开始依赖apache的另一个项目:commons-io,本次使用的是2.0版本。
struts2提供了一个文件上传拦截器:org.apache.struts2.interceptor.FileUploadInterceptor,他负责调用顶层的文件上传组件解析文件内容,并为action准备与上传文件相关的属性值。处理文件上传请求的action必须提供特殊样式命名的属性,例如需要上传的是image图片,那么action中就应该提供以下三个属性:
- image:java.io.File类型,上传文件的File对象;
- imageFileName:上传文件的文件名;
- imageContentType:上传文件的内容类型(MIME类型);
这三个属性的值会由FileUploadInterceptor拦截器准备。
以下就以实例介绍利用该组件实现单个和多个文件的上传和下载。
1、新建web工程Struts2_FileUpload
2、编辑上传文件的Action类,在其类中定义三个变量,分别代表上传文件的对象,上传文件的名称,上传文件的MIME类型,并重写execute()方法,把上传文件保存在WEB-INF/UploadFiles文件夹下。FileUploadAction类代码如下:
package com.struts2.actions;
import java.io.BufferedInputStream;
import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.Date;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionSupport;
/**
* 文件上传Action类
* @author 江南渔翁
*/
public class FileUploadAction extends ActionSupport {
// 代表上传文件的file对象
private File file;
// 上传文件名
private String fileFileName;
// 上传文件的MIME类型
private String fileContentType;
// 上传文件的描述信息
private String description;
// 保存上传文件的目录,相对于Web应用程序的根路径,在struts.xml文件中配置
private String uploadDir;
public String getDescription() {
return description;
}
public void setDescription(String description) {
this.description = description;
}
public String getUploadDir() {
return uploadDir;
}
public void setUploadDir(String uploadDir) {
this.uploadDir = uploadDir;
}
public File getFile() {
return file;
}
public void setFile(File file) {
this.file = file;
}
public String getFileFileName() {
return fileFileName;
}
public void setFileFileName(String fileFileName) {
this.fileFileName = fileFileName;
}
public String getFileContentType() {
return fileContentType;
}
public void setFileContentType(String fileContentType) {
this.fileContentType = fileContentType;
}
@Override
public String execute() throws Exception {
String newFileName = null;
// 得到当前时间自1990年1月1日0时0分0秒开始流逝的毫秒数,将这个毫秒数作为上传文件的新文件名
long now = new Date().getTime();
// 得到保存上传文件的目录的真实路径
String path = ServletActionContext.getServletContext().getRealPath(uploadDir);
File dir = new File(path);
// 如果这个目录不存在,则创建它
if (!dir.exists()) {
dir.mkdir();
}
int index = fileFileName.lastIndexOf('.');
// 判断上传文件名是否有扩展名,以时间截取为新的文件名
if (index != -1) {
newFileName = now + fileFileName.substring(index);
} else {
newFileName = Long.toString(now);
}
BufferedOutputStream bos = null;
BufferedInputStream bis = null;
// 读取保存在临时目录下的上传文件,写入到新的文件中
try {
FileInputStream fis = new FileInputStream(file);
bis = new BufferedInputStream(fis);
FileOutputStream fos = new FileOutputStream(new File(dir, newFileName));
bos = new BufferedOutputStream(fos);
byte[] buf = new byte[4096];
int len = -1;
while ((len = bis.read(buf)) != -1) {
bos.write(buf, 0, len);
}
} finally {
try {
if (null != bis) {
bis.close();
}
} catch (IOException ex) {
ex.printStackTrace();
}
try {
if (null != bos) {
bos.close();
}
} catch (IOException ex) {
ex.printStackTrace();
}
}
return SUCCESS;
}
}
3、在项目的src目录下新建struts-config文件夹,在其内新建fileupload.xml文件,配置FileUploadAction类,代码如下:
<?xml version="1.0" encoding="UTF-8" ?>
<!-- 指定拦截器的DTD信息 -->
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<constant name="struts.multipart.maxSize" value="100000000"/>
<package name="upload" namespace="/upload" extends="fileupload">
<action name="upload" class="com.struts2.actions.FileUploadAction">
<interceptor-ref name="fileUpload">
<param name="maximumSize">10000</param>
<param name="allowedTypes">
image/gif,image/jpeg,image/png
</param>
</interceptor-ref>
<interceptor-ref name="defaultStack"/>
<result name="input">/fileupload.jsp</result>
<result name="success">/success.jsp</result>
<param name="uploadDir">/WEB-INF/UploadFiles</param>
</action>
</package>
</struts>
4、把fileupload.xml文件引入到struts.xml文件中,代码如下:
<?xml version="1.0" encoding="UTF-8" ?>
<!-- 指定拦截器的DTD信息 -->
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<!-- 通过常量配置Struts2所使用的解码集 -->
<constant name="struts.i18n.encoding" value="gbk" />
<constant name="struts.devMode" value="true" />
<include file ="struts-config/fileupload.xml" />
<package name="fileupload" namespace="/fileupload" extends="struts-default"/>
</struts>
5、在src下新建org.apache.struts2包,并在这个包下新建struts-messages.properties文件,修改上传过滤失败后的提示错误信息内容,代码如下:
#改变文件类型不允许的提示信息
struts.messages.error.content.type.not.allowed=您上传的文件类型只能是图片文件!请重新选择!
#改变上传文件太大的提示信息
struts.messages.error.file.too.large=您要上传的文件太大,请重新选择!
6、在WebContent下新建页面fileupload.jsp,代码如下:
<%@ page language="java" import="java.util.*" pageEncoding="GBK"%>
<%@taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html>
<head>
<title>文件上传</title>
</head>
<body>
<h1>上传文件</h1>
<hr />
<!-- 使用红色的前景色输出错误信息 -->
<div style="color:red">
<s:fielderror/>
</div>
<s:form action="upload/upload.action" method="post" enctype="multipart/form-data">
<s:file name="file" label="请选择上传的文件" />
<s:textarea name="description" cols="50" rows="10" label="文件描述"></s:textarea>
<s:submit value=" 上 传 " align="center" cssClass="button"/>
</s:form>
</body>
</html>
7、在同一文件夹下新建success.jsp,用来提示上传成功的信息,代码如下: