Struts2入门（11）：文件上传与单文件/多文件上传示例

来源：互联网发布：java递归算法详解编辑：程序博客网时间：2024/06/05 03:21

Struts2 文件上传

Struts2 框架提供了基于表单提交的文件上传，这个功能是以 fileupload 拦截器的方式实现的，该验校器默认使用的是Jakarta 的Common-FileUpload的文件上传框架；

当文件上传时，会被临时储存在一个临时目录里，对应的Action用于处理或移动到一个永久的目录中，以确保数据不丢失；

该拦截器是 defalut Stack 的一部分，并不需要特别的配置，除非需要对上传文件的大小（默认2MB）、文件类型（默认允许所有类型）,文件永久储存目录（可以在Action中设置，但是为了提高代码的可维护性，一般在配置文件中设置）进行配置时，才须要配置该拦截器；

注意在Action设置文件永久储存的目录时，需要检查该目录对于 Struts 是否访问权限；

单文件上传实例(1)-使用拦截器进行文件验校

upload.jsp ：表单提交JSP页面

<%@ page language="java" contentType="text/html; charset=ISO-8859-1" pageEncoding="ISO-8859-1"%>
<%@ taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"  "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>File Upload</title>
</head>
<body>
   <!--文件上传表单-->
   <form action="upload" method="post" enctype="multipart/form-data">
      <label>choose file</label>
      <input type="file" name="uploadfile" />
      <input type="submit" value="Upload"/>
   </form>
    
</body>
</html>

UploadFileAction.jsp : 处理文件上传Action

该 Action 私有域命名的注意点：

[upload file name parameter] ：上传的文件变量，注意要和表单文件类型提交的name保持一致（示例中为"uploadfile"）;
[upload file name parameter]ContentType：上传文件的文件类型（示例中为"uploadfileContentType"）;
[upload file name parameter]FileName - 上传的文件的名称（示例中为"uploadfileName"）;

Struts 的文件上传时依赖 fileupload 拦截器工作的，文件相关变量的命名必须按照以上规范；

package upload;
import java.io.File;
import org.apache.commons.io.FileUtils;
import java.io.IOException; 
​
public class UploadFileAction{
   private File uploadfile;                  //上传文件
   private String uploadfileContentType;     //上传文件类型
   private String uploadfileFileName;        //上传文件名
   private String savePath;                  //上传文件永久储存路径
​
   public String execute(){
      try{
          //将文件复制到永久储存目录
         File saveFile  = new File(savePath, uploadfileFileName);
         FileUtils.copyFile(uploadFile, saveFile);
      }catch(IOException e){
         e.printStackTrace();
         return "error";
      }
      return "success";
   }
  //省略get、set方法
}

对于用户上传的文件，可能存在文件名重复的问题，可以使用 java.util.UUID 工具来生成唯一的文件名；

structs.xml ：配置文件，配置Action映射和 fileupload 拦截器参数

手动设置 fileupload 拦截器的上传文件大小，文件类型和永久储存路径，其中fileupload可配置2个参数如下：

allowTypes：文件类型限制，多个类型之间使用 "," 隔开；
maximumSize：文件大小限制，单位byte；

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" "http://struts.apache.org/dtds/struts-2.3.dtd">
<struts>
   <constant name="struts.devMode" value="true" />
​
   <package name="upload" extends="struts-default" >
       <action name="upload" class="upload.uploadFileAction">
            <!--动态配置文件上传永久储存路径-->
           <param name="savePath">/uploadFiles</param>
           <interceptor-ref name="defaultStack"/>
           <!--配置文件上传的大小限制为10M 、文件类型限制为jpeg，gif-->
           <interceptor-ref name="fileUpload">
               <param name="allowedTypes">image/jpeg,image/gif</param>
               <param name="maximumSize">1000</param>
           </interceptor-ref>
           
           <result name="success">/success.jsp</result>
           <result name="error">/error.jsp</result>
       </action>
   </package>
    
</struts>

其中文件类型限制时，使用的是标准的MIME类型，完整的MIME类型值可以参考：

http://www.w3school.com.cn/media/media_mimeref.asp

单文件上传实例(2)-手动编写文件验校过程

另外一种文件上传的验校方式，是直接在Action中编写验校过程，该过程可以实现更加灵活的文件验校方式，以下示例中，对上传的文件类型，大小进行验证，验证失败后返回 upload.jsp ,并显示验证失败信息；

upload.jsp : 同上

<%@ page language="java" contentType="text/html; charset=ISO-8859-1" pageEncoding="ISO-8859-1"%>
<%@ taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"  "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>File Upload</title>
</head>
<body>
   <!--文件上传表单-->
   <form action="upload" method="post" enctype="multipart/form-data">
      <label>choose file</label>
      <input type="file" name="uploadfile" />
      <input type="submit" value="Upload"/>
      <!--输出上传文件验校信息-->
      <s:fielderror name="uploadtype" />
      <s:fielderror name="uploadSize" />
   </form>
    
</body>
</html>

UploadFileAction.jsp

public class UploadFileAction extends ActionSupport{
    private File uploadfile;                  //上传文件
    private String uploadfileContentType;     //上传文件类型
    private String uploadfileFileName;        //上传文件名
    private String savePath;                  //上传文件永久储存路径
    
    private String allowTypes;   //上传文件限制类型
    private String maxmimumSize；  //上传文件限制大小
        
    public String execute(){
      try{
          //将文件复制到永久储存目录
         File saveFile  = new File(savePath, uploadfileFileName);
         FileUtils.copyFile(uploadFile, saveFile);
      }catch(IOException e){
         e.printStackTrace();
         return "error";
      }
      return "success";
   }
    
    //文件验证方法
    public void validate(){
        //验证类型
        String filterResult = filtyType(getAllowTypes(getAllowTypes().trim().split(",")));
        if(filterResult ！= null){
            addFieldError("uploadType","上传的文件类型不符合")；
        }
        //验证大小
        if(getMaxmuminSize() < uploadfile.length){
            addFieldError("uploadSize","上传的文件过大")
        }
    }
    private String filterTypes(String[] types){
        String fileType = getUploadContentType();
        for(String type : types)
            if(type.equlas(fileType))
                retrun null
        return ERROR;
    }
    //省略get，set
}

structs.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" "http://struts.apache.org/dtds/struts-2.3.dtd">
<struts>
   <constant name="struts.devMode" value="true" />
    
   <package name="upload" extends="struts-default" >
       <action name="upload" class="upload.uploadFileAction">
            <!--动态配置文件上传永久储存路径，类型限制，大小限制-->
           <param name="savePath">/uploadFiles</param>
           <param name="allowedTypes">image/jpeg,image/gif</param>
           <param name="maxmimumLength">10000</param>
         
           <result name="success">/success.jsp</result>
           <result name="error">/error.jsp</result>  <!--文件上传过程失败时，跳转到error页面-->
           <result name="input">/upload.jsp</result> <!--验证失败时，退回上传文件的JSP页面-->
       </action>
   </package>
    
</struts>

这种过程更加灵活，可以使用资源包配置文件灵活地配置验证失败的国际化文本；

多文件上传实例

类似单文件上传，多文件上传的验校过程也可以使用拦截器配置或 Action中手动配置，方法上是一样的，这里为了方便示例，省略了上传文件验校的过程；

upload.jsp ：表单提交JSP页面

<%@ page language="java" contentType="text/html; charset=ISO-8859-1" pageEncoding="ISO-8859-1"%>
<%@ taglib prefix="s" uri="/struts-tags"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"  "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Multiple File Upload</title>
</head>
<body>
   <!--文件上传表单-->
   <form action="upload" method="post" enctype="multipart/form-data">
      <label>choose file</label><br/>
      <input type="file" name="uploadfile" /><br/>
      <input type="file" name="uploadfile" /><br/>
      <input type="file" name="uploadfile" /><br/>
      <input type="submit" value="Upload"/>
   </form>
    
</body>
</html>

UploadFileAction.jsp : 处理文件上传Action

package upload;
import java.io.File;
import java.util.ArrayList;
import java.util.List;
import org.apache.commons.io.FileUtils;
import com.opensymphony.xwork2.ActionSupport;
​
public class UploadFileAction extends ActionSupport{
    
    private List<File> uploadfile = new ArrayList<File>();
    private List<String> uploadfileContentType = new ArrayList<String>();
    private List<String> uploadfileFileName = new ArrayList<String>();
    private String savePath;
​
    //省略get,set方法
    public String upload(){
        try{
            for (int i=0;i<uploadfile.size();i++) {
               File saveFile  = new File(savePath, getUploadfileFileName.get(i));
               FileUtils.copyFile(getUploadfile.get(i), saveFile);
            }
        }catch(Exception ex){
            return ERROR;   
        }
        return SUCCESS;
    }
    
}

struts.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" "http://struts.apache.org/dtds/struts-2.3.dtd">
<struts>
   <constant name="struts.devMode" value="true" />
    
   <package name="upload" extends="struts-default" >
       <action name="upload" class="upload.uploadFileAction">
           <param name="savePath">/uploadFiles</param>
           <result name="success">/success.jsp</result>
           <result name="error">/error.jsp</result> 
       </action>
   </package>
    
</struts>