Struts2入门(11):文件上传与单文件/多文件上传示例

本文详细介绍Struts2框架下的文件上传实现方法,包括单文件和多文件上传的配置及处理流程,涵盖基于拦截器的文件校验和手动校验过程。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

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类型值可以参考:

单文件上传实例(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>














评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值