基于 Struts2 的单文件和多文件上传

文件的上传下载是 Web 开发中老生常谈的功能，基于 Struts2 框架对于实现这一功能，更是能够给我们带来很多的便利。Struts2 已经有默认的 upload 拦截器。我们只需要写参数，它就会自动帮我们封装好。这篇我们就先来看一下基于 Struts2 的单文件和多文件上传。

一、 单文件上传

1.1 导 jar 包

commons-fileupload-1.3.jar

commons-io-2.0.1.jar

commons-logging-1.1.3.jar

freemarker-2.3.19.jar

ognl-3.0.6.jar

struts2-core-2.3.15.3.jar

xwork-core-2.3.15.3.jar

1.2 web.xml 配置 Struts2 核心过滤器

 <filter>
     <filter-name>struts2</filter-name>
     <filter-class>
          org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter
     </filter-class>
 </filter>

 <filter-mapping>
     <filter-name>struts2</filter-name>
     <url-pattern>/*</url-pattern>
 </filter-mapping>

1.3 JSP 文件上传页（注意 file 的 name 属性一定要与 Action 里面的 File 类型属性名一致）

 <!-- 文件上传的必要前提：
     1.请求方式必须是post
     2.enctype属性的取值必须是multipart/form-data
     3.提供一个文件选择域 文件上传
  -->

 <s:form  action="upload.action" enctype="multipart/form-data">

      <s:file  name="myfile"  label="请选择文件"></s:file>
      <s:submit value  ="提交"></s:submit>

 </s:form>

1.4 实现文件上传的 UploadAction

 package com.fhcq.action;

 import java.io.File;
 import javax.servlet.ServletContext;
 import org.apache.commons.io.FileUtils;
 import org.apache.struts2.ServletActionContext;
 import com.opensymphony.xwork2.ActionSupport;

 public class UploadAction extends ActionSupport  {

 	//表单上提供的字段
 	private File myfile;
 	//struts2在文件上传时提供的属性
 	private String myfileFileName;//上传的文件名。上传字段名称+FileName  注意大小写
 	private String myfileContentType;//上传文件的MIME类型。上传字段名称+ContentType 注意大小写
 	public String upload (){

 		//1.拿到ServletContext
 		ServletContext servletContext = ServletActionContext.getServletContext();
 		//2.调用realPath方法，获取根据一个虚拟目录得到的真实目录
 		String realPath = servletContext.getRealPath("/WEB-INF/file");
 	        //3.如果这个真实的目录不存在，需要创建
 		File file = new File(realPath );
 		if(!file.exists()){
 			file.mkdirs();
 		}
 		//4.把文件存过去
 		//拷贝：把文件的临时文件复制到指定的位置。注意：临时文件还在
 		//FileUtils.copyFile(myfile, new File(file,myfileFileName));

 		//剪切：把临时文件剪切指定的位置，并且给他重命名。 注意：临时文件没有了
 		myfile.renameTo(new File(file,myfileFileName));
 		return SUCCESS;
 	}

 	public File getMyfile() {
 		return myfile;
 	}

 	public void setMyfile(File myfile) {
 		this.myfile = myfile;
 	}

 	public String getMyfileFileName() {
 		return myfileFileName;
 	}

 	public void setMyfileFileName(String myfileFileName) {
 		this.myfileFileName = myfileFileName;
 	}

 	public String getMyfileContentType() {
 		return myfileContentType;
 	}

 	public void setMyfileContentType(String myfileContentType) {
 		this.myfileContentType = myfileContentType;
 	}

 }

1.5 配置 struts.xml（注意：修改文件上传的总的大小。）

 <struts>
      <!--constant修改struts2的默认配置值  -->
      <!--修改struct2称为开发模式，修改配置之后会自动加载  -->
      <constant name="struts.devMode" value="true" />
      <!-- 限制上传文件的大小，第一种方式：通过修改struts2的常量。
 		在default.properties中配的struts.multipart.maxSize=2097152-->
      <constant name="struts.multipart.maxSize" value="4097152" />

      <package name="p1"  extends="struts-default">

 	  <action  name ="upload" class = "com.fhcq.action.UploadAction" method="upload">

           <!-- 第二种方式:通过给fileUpload的拦截器注入参数的形式，控制上传文件的大小
           无法使用   <param name="fileUpload.maximumSize">31457280</param>-->
 	     <interceptor-ref name="defaultStack">
 	        <!-- 限制上传文件的扩展名。如果有多个，使用逗号分隔
 	        <param name="fileUpload.allowedExtensions">jpg,png,bmp</param>-->
 	        <!-- 限制上传文件的MIME类型。 如果有多个，使用逗号分隔 -->
                 <param name="fileUpload.allowedTypes">image/jpg,image/pjpeg,image/png
                 </param>
 	     </interceptor-ref>
 	     <result>/index.jsp</result>
 	     <result name="input" type="redirect">/upload.jsp</result>
 	  </action>

       </package>

 </struts>

1.6 配置 fileupload_message.properties，放置在 src 下用来显示错误的资源文件信息

 struts.messages.error.content.type.not.allowed=\u4E0A\u4F20\u6587\u4EF6\u7684\u7C7B\u578B\u4E0D\u662F\u88AB\u652F\u6301\u7684: {0} "{1}" "{2}" {3}

二、 多文件上传

在以上单文件上传的基础上，修改内容如下：

2.1 JSP 文件上传页（注意 file 的 name 属性一定要与 Action 里面的 File 类型属性名一致）

 <!-- 文件上传的必要前提：
     1.请求方式必须是post
     2.enctype属性的取值必须是multipart/form-data
     3.提供一个文件选择域
 -->

 <s:form  action="upload.action" enctype="multipart/form-data">

      <s:file  name="myfile"  label="请选择文件"></s:file>
      <s:file  name="myfile"  label="请选择文件"></s:file>
      <s:submit value  ="提交"></s:submit>

 </s:form>

2.2 实现文件上传的 UploadAction

 package com.fhcq.action;

 import java.io.File;

 import javax.servlet.ServletContext;

 import org.apache.struts2.ServletActionContext;

 import com.opensymphony.xwork2.ActionSupport;

 public class UploadAction extends ActionSupport  {

 	//表单上提供的字段
 	private File[]   myfile;
 	//struts2在文件上传时提供的属性
 	private String[] myfileFileName;上传的文件名。上传字段名称+FileName  注意大小写
 	private String[] myfileContentType;//上传文件的MIME类型。上传字段名称+ContentType 注意大小写

 	public String upload (){

 		//1.拿到ServletContext
 		ServletContext servletContext = ServletActionContext.getServletContext();
 		//2.调用realPath方法，获取根据一个虚拟目录得到的真实目录
 		String realPath = servletContext.getRealPath("/WEB-INF/files");
 		//3.如果这个真实的目录不存在，需要创建
 		File file = new File(realPath );
 		if(!file.exists()){
 			file.mkdirs();
 		}
 		//4.把文件存过去
 		//剪切：把临时文件剪切指定的位置，并且给他重命名。 注意：临时文件没有了
 		for(int i=0;i<myfile.length;i++){
 			myfile[i].renameTo(new File(file,myfileFileName[i]));
 		}

 		return SUCCESS;
 	}

 	public File[] getMyfile() {
 		return myfile;
 	}

 	public void setMyfile(File[] myfile) {
 		this.myfile = myfile;
 	}

 	public String[] getMyfileFileName() {
 		return myfileFileName;
 	}

 	public void setMyfileFileName(String[] myfileFileName) {
 		this.myfileFileName = myfileFileName;
 	}

 	public String[] getMyfileContentType() {
 		return myfileContentType;
 	}

 	public void setMyfileContentType(String[] myfileContentType) {
 		this.myfileContentType = myfileContentType;
 	}

 }