基于 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;
	}

}