在Java领域,常用两个组件进行文件的上传,一个是Apache的Jakarta的common-FileUpload组件,另一个是Oreilly的COS框架。这里我们使用前者。
一.环境准备
需要在struts2的jar包基础上增加commons-fileupload-1.3.jar commons-io-2.0.1.jar两个包,所有的包加起来如图所示:
二.代码:
首先说前台的页面upload.jsp,在表单内使用file类型的控件即可,这个jsp文件放在upload/目录下,所以action里使用了../。
upload.jsp:
<%@ page language="java" import="java.util.*" pageEncoding="gbk"%>
<html>
<head>
</head>
<body>
<!-- multipart/form-data是不对字符编码,在使用包含文件上传控件的表单时,必须使用该值。 -->
<form action="../upload.action" method="post" enctype="multipart/form-data">
<!-- <input type="text" name="title">-->
<input type="file" name="upload"/>
<input type="submit" value="上传">
</form>
</body>
</html>
struts2.xml部分代码,这里的
<param name="savePath">/upload</param>
是一个常量,action加载时会通过setSavePath(String savePath)方法传给action,它代表了保存在哪个目录下,该目录要存在才行。
struts2.xml
<action name="upload" class="upload.Upload">
<param name="savePath">/upload</param>
<result>
/uploadsuccess.jsp
</result>
</action>
Upload.java是上传的action,表单的文件"upload"会通过set方法传给private File upload,private String uploadContentType,private String uploadFileName三个对象赋值,分别是文件、文件类型(比如:image/jpeg)、文件名(包含扩展名)。
Upload.java
package upload;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionSupport;
public class Upload extends ActionSupport {
// 封装上传文件域的属性
private File upload;
// 封装上传文件类型的属性
private String uploadContentType;
// 封装上传文件名的属性
private String uploadFileName;
// 接受依赖注入的属性
private String 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;
}
public String getSavePath() {
return savePath;
}
public void setSavePath(String savePath) {
this.savePath = savePath;
}
public String execute() {
System.out.println("filename:" + getUploadContentType());
FileOutputStream fos = null;
FileInputStream fis = null;
try {
// 建立文件输出流
String outPath = ServletActionContext.getServletContext() //这个方法可以把相对途经转成绝对途径
.getRealPath(getSavePath() + "\\" + getUploadFileName());
System.out.println(outPath);
fos = new FileOutputStream(outPath);
// 建立文件上传流
fis = new FileInputStream(getUpload());
byte[] buffer = new byte[1024];
int len = 0;
while ((len = fis.read(buffer)) > 0) {
fos.write(buffer, 0, len);
}
} catch (Exception e) {
System.out.println("文件上传失败");
e.printStackTrace();
} finally {
try {
fis.close();
fos.close();
} catch (IOException e) {
}
}
return SUCCESS;
}
}
三.高级配置
Struts2有一个叫fileUploadl拦截器,可以对文件类型,文件大小进行过滤。
使用方法:在struts.xml里upload的action里增加拦截器的引用,并通过param配置过滤参数:
<action name="upload" class="upload.Upload">
<interceptor-ref name="fileUpload">
<!-- 允许的文件类型 -->
<param name="allowTypes">image/bmp,image/jpg,image/png,image/gif,image/jpeg</param>
<!-- 允许上传的文件大小,单位为字节 -->
<param name="maximumSize">10240</param>
<param name=""></param>
</interceptor-ref>
<interceptor-ref name="defaultStack"></interceptor-ref>
<param name="savePath">/upload</param>
<result>
/loginsuccess.jsp
</result>
<result name="input">/upload/upload.jsp</result>
</action>
注意:defaultStack这个拦截器是默认每个action都有的,如果没有这个拦截器的话参数无法传给action。当我们给action自定义拦截器的时候这个defaultStack不会被添加,所以我们必须手动添加<interceptor-ref name="defaultStack"></interceptor-ref>到所有的拦截器后面
当上传的文件被拦截时,拦截器会调用addFieldError方法添加一个错误信息并返回"input",所以struts.xml对应的action里必须有一个名为input的result。
前台的upload.jsp页面应该添加一句<s:fielderror></s:fielderror>来显示拦截器返回的错误信息。(使用这个标签应该在jsp开头增加<%@ taglib prefix="s" uri="/struts-tags"%>)