Struts2框架实现文件上传

Struts2 专栏收录该内容
4 篇文章 0 订阅

Struts2框架实现文件上传

  • 开发环境
  • 系统:Windows10 版本1709
  • JDK:1.8.0_161 32位
  • IDE: Spring Tool Suite 3.7.3 32位
  • Struts2版本:2.3.24
  • 服务器版本:apache-tomcat-7.0.52

单文件的上传

环境搭建

  • 导入必要的jar包

必须有commons-fileupload-1.3.1.jar包. 在开发Struts2框架必备的13个jar包中,包含了此jar包.

  • 在web.xml中配置核心的过滤器

    <filter>
        <filter-name>struts</filter-name>
        <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
    </filter>
    
    <filter-mapping>
      <filter-name>struts</filter-name>
      <url-pattern>/*</url-pattern>        
    </filter-mapping>  
    

  • 在src目录下创建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">
    

文件上传的浏览器的三要素

  • 表单的提交方式必须为post

  • 表单中必须有一个<\input type="file">

  • 表单设置enctype="multipart/form-data"

    创建一个upload.jsp页面

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
    <form action="${pageContext.request.contextPath}/up" method="post" enctype="multipart/form-data">
        <input type="file" name="upload">
        <input type="summit" value="上传">
    </form>
</body>
</html>

文件上传的服务器端

创建一个UploadAction的java类

public class UploadAction {

    private File upload;//定义一个File ,变量名要与jsp中的input标签的name一致
    private String uploadContentType;//上传文件的mimeType类型
    private String uploadFileName;//上传文件的名称

    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 void uploadFile(){
        try {
            //在WebContent下新建一个upload的文件夹,获取其在服务器的绝对磁盘路径
            String path = ServletActionContext.getServletContext().getRealPath("/upload");

            //创建一个服务器端的文件
            File dest = new File(path,uploadFileName);

            //完成文件上传的操作
            FileUtils.copyFile(upload, dest);

        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

在struts.xml中进行如下的配置

<struts>
    <!--配置开发者模式,可以显示更加详细的错误信息 -->
    <constant name="struts.devMode" value="true"></constant>
    <constant name="struts.multipart.maxSize" value="20971520"></constant>
    <package name="upload_demo" extends="struts-default" namespace="/" >
        <!-- <interceptors>
            <interceptor-stack name="myStack">
                <interceptor-ref name="fileUpload">
                    设置上传文件允许的后缀名,多个使用逗号隔开 
                    <param name="allowedExtensions">avi,txt</param>
                </interceptor-ref>
                配置了其他的拦截器,就需要手动导入默认的拦截器
                <interceptor-ref name="defaultStack"></interceptor-ref>
            </interceptor-stack>
        </interceptors> -->
        <action class="com.thc.action.UploadAction" method="uploadFile" name="up">
            <result name="input">/error.jsp</result>
            <interceptor-ref name="fileUpload">
                <param name="maximumSize"></param><!-- 设置每一个action允许的上传文件的大小 -->
                <param name="allowedTypes"></param><!--设置上传允许的文件的mimeType类型,多个使用逗号分开-->
                <param name="allowedExtensions">bmp,txt</param><!-- 设置上传文件允许的后缀名,多个使用逗号分开 -->
            </interceptor-ref>
            <interceptor-ref name="defaultStack"></interceptor-ref>
        </action>
    </package>
</struts>

使用Struts2框架实现文件上传.在页面的<input type="file" name="upload">name属性的名字,必须与文件上传的Java类中定义的File类型变量的名字一样.

文件类型和文件名称的变量名也必须为name之后的拼接

注意上传的文件是个临时文件,服务器重启后,文件就不存在了. 要想永久的保存,需要指定一个本地硬盘的目录.

文件上传出现的问题以及解决方案

文件的大小问题

如果上传一个较大的文件,控制台会报空指针异常.这个空指针的异常信息不够详细.

把当前的文件上传的java类继承ActionSupport类底层会去调用保存错误信息的方法. 并且在struts.xml文件中,开启开发者模式.

<constant name="struts.devMode" value="true"></constant>

再次上传一个较大的文件,会发现这次在报的错误不再是空指针异常. 控制台报错信息如下:

[http-bio-8080-exec-10] ERROR org.apache.struts2.dispatcher.Dispatcher - Could not find action or result
/strust2_fileupload/up
com.opensymphony.xwork2.config.ConfigurationException: No result defined for action com.thc.action.UploadAction and result input

这是说当前的文件上传的java类没有配置result 的input视图.

这是因为Struts底层的拦截器如果出现问题,那么就会把错误信息存储到action中, workflow的拦截器负责控制跳转到指定的input视图.

在struts.xml中的\ 标签中配置\名为input的视图 ,标签体为error.jsp

<struts>
    <!--配置开发者模式,可以显示更加详细的错误信息 -->
    <constant name="struts.devMode" value="true"></constant>
    <package name="upload_demo" extends="struts-default" namespace="/" >
        <action name="up" class="com.thc.action.UploadAction" method="uploadFile">
        <result name="input">/error.jsp</result>
        </action>
    </package>
</struts>

在WebContent下新建一个error.jsp页面

在jsp页面的顶部导入struts2框架的标签

<%@taglib prefix="s" uri="/struts-tags" %>

在页面中写上struts的标签<s:actionerror/><s:fielderror/> 用来显示提示错误信息

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
    <%@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>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>错误信息显示页面</title>
</head>
<body>
    <h3>文件上传错误信息显示页面</h3>
    <s:actionerror/>
    <s:fielderror/>
</body>
</html>

以上的操作做完了之后, 再次上传一个较大的文件.会在浏览器上看到如下的错误提示信息

Request exceeded allowed size limit! Max size allowed is: 2,097,152 but request was: 1,346,882,290!

提示是说,请求超出了最大的允许界限

原因是在struts2框架default.properties配置文件中,定义了默认的文件上传大小为2097152字节(byte)为2M.

在struts.xml的配置文件中,修改这个常量的大小.

<constant name="struts.multipart.maxSize" value="20971520"></constant>

修改为20M. 再次上传一个小于20M的文件后,就不会报错了. 这个文件大小的范围,依据实际的需求而设定.

以上的改变常量方法是对所有的action生效,要想仅仅使一个action生效,设置上传文件的大小,需要在<action>标签中设置

查看FileUploadInterceptor这个拦截器的源码

发现有如下的属性:

    protected Long maximumSize;
    protected Set<String> allowedTypesSet = Collections.emptySet();
    protected Set<String> allowedExtensionsSet = Collections.emptySet();

分别代表的是设置文件的最大大小,设置运行的文件类型,设置文件运行的后缀名.

有如下的set方法,设置参数.

 /**
     * Sets the allowed extensions
     *
     * @param allowedExtensions A comma-delimited list of extensions
     */
    public void setAllowedExtensions(String allowedExtensions) {
        allowedExtensionsSet = TextParseUtil.commaDelimitedStringToSet(allowedExtensions);
    }

    /**
     * Sets the allowed mimetypes
     *
     * @param allowedTypes A comma-delimited list of types
     */
    public void setAllowedTypes(String allowedTypes) {
        allowedTypesSet = TextParseUtil.commaDelimitedStringToSet(allowedTypes);
    }

    /**
     * Sets the maximum size of an uploaded file
     *
     * @param maximumSize The maximum size in bytes
     */
    public void setMaximumSize(Long maximumSize) {
        this.maximumSize = maximumSize;
    }

上传文件允许的后缀名

在如下的struts.xml中,配置如下:

<action name="up" class="com.thc.action.UploadAction" method="uploadFile">
        <result name="input">/error.jsp</result>
        <interceptor-ref name="fileUpload">
            <!--设置上传文件允许的后缀名,多个使用逗号隔开  -->
            <param name="allowedExtensions">avi,txt</param>
        </interceptor-ref>
        <!-- 配置了其他的拦截器,就需要手动导入默认的拦截器 -->
        <interceptor-ref name="defaultStack"></interceptor-ref>
</action>

设置了只允许上传后缀名为avi,txt结尾的文件

实验上传一个.doc后缀名的文件

浏览器上会有如下的报错信息 :提示了doc后缀名是不允许的.

File extension not allowed: upload "测试.doc" "upload_7cd79feb_ad18_40cb_a401_f74b2d2f27a1_00000000.tmp" application/msword

多文件的上传

新建一个multipload.jsp的页面

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
    <h2>多文件的上传</h2>
    <form action="${pageContext.request.contextPath}/multiup" method="post" enctype="multipart/form-data">
    <input type="file" name="upload"><br/>
    <input type="file" name="upload"><br/>
    <input type="file" name="upload">
    <input type="submit" value="上传">
    </form>
</body>
</html>

设置了三个文件上传框

新建一个MultiUploadAction

在原来的属性中,把FIle设置为List集合,或者是数组.

以下为设置了数组.遍历每一个数组的元素.通过索引获取数组的文件名和文件.

public class MultiUploadAction extends ActionSupport {

    private File[] upload;//定义一个File ,变量名要与jsp中的input标签的name一致
    private String[] uploadContentType;//上传文件的mimeType类型
    private String[] uploadFileName;//上传文件的名称

    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 void uploadFile(){
        //在WebContent下新建一个upload的文件夹,获取其在服务器的绝对磁盘路径
        String path = ServletActionContext.getServletContext().getRealPath("/upload");
        try {
            for (int i = 0; i < upload.length; i++) {
                //创建一个服务器端的文件
                File dest = new File(path,uploadFileName[i]);
                //完成文件上传的操作
                FileUtils.copyFile(upload[i], dest);
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

以下是List集合的方式

通过list.size()来控制集合的遍历,通过get(index)来获取集合的每一个元素

public class MultiUploadAction extends ActionSupport {

    private List<File> upload;//定义一个File ,变量名要与jsp中的input标签的name一致
    private List<String> uploadContentType;//上传文件的mimeType类型
    private List<String> uploadFileName;//上传文件的名称

    public List<File> getUpload() {
        return upload;
    }
    public void setUpload(List<File> upload) {
        this.upload = upload;
    }
    public List<String> getUploadContentType() {
        return uploadContentType;
    }
    public void setUploadContentType(List<String> uploadContentType) {
        this.uploadContentType = uploadContentType;
    }
    public List<String> getUploadFileName() {
        return uploadFileName;
    }
    public void setUploadFileName(List<String> uploadFileName) {
        this.uploadFileName = uploadFileName;
    }

    public void uploadFile(){
        //在WebContent下新建一个upload的文件夹,获取其在服务器的绝对磁盘路径
        String path = ServletActionContext.getServletContext().getRealPath("/upload");
        try {
            for (int i = 0; i < upload.size(); i++) {
                //创建一个服务器端的文件
                File dest = new File(path,uploadFileName.get(i));
                //完成文件上传的操作
                FileUtils.copyFile(upload.get(i), dest);
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

在配置文件中新建一个action的配置

<action name="multiup" class="com.thc.action.MultiUploadAction" method="uploadFile">
        <result name="input">/error.jsp</result>
</action>

多文件上传的测试

在服务器中部署项目,访问multipload.jsp页面

选择三个小于2M的文件进行选择文件上传测试.点击上传后,成功在服务器的upload文件夹下上传了文件

注解开发

注解配置文件上传

  • 注解的方式配置action类 单个的文件上传
  • 在class 上配置namespace 和parentPackage
  • 注意单文件的上传@ParentPackage的值为"upload_demo",因为在struts.xml设置了拦截器,起了包名为"upload_demo"
  • 在方法上配置@Action @InterceptorRef @Result
@Namespace("/")
@ParentPackage("upload_demo")
public class UploadAction extends ActionSupport {
    private File upload;//定义一个File ,变量名要与jsp中的input标签的name一致
    private String uploadContentType;//上传文件的mimeType类型
    private String uploadFileName;//上传文件的名称
    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;
    }

    @Action(value="up",interceptorRefs={@InterceptorRef("myStack")},results={@Result(name="input",location="/error.jsp")})
    public void uploadFile(){
        try {
            //在WebContent下新建一个upload的文件夹,获取其在服务器的绝对磁盘路径
            String path = ServletActionContext.getServletContext().getRealPath("/upload");
            //创建一个服务器端的文件
            File dest = new File(path,uploadFileName);
            //完成文件上传的操作
            FileUtils.copyFile(upload, dest);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}
  • 注解的方式的配置多文件的上传

    @Namespace("/")
    @ParentPackage("struts-default")
    public class MultiUploadAction extends ActionSupport {
    
      private List<File> upload;//定义一个File ,变量名要与jsp中的input标签的name一致
      private List<String> uploadContentType;//上传文件的mimeType类型
      private List<String> uploadFileName;//上传文件的名称
    
      public List<File> getUpload() {
          return upload;
      }
      public void setUpload(List<File> upload) {
          this.upload = upload;
      }
      public List<String> getUploadContentType() {
          return uploadContentType;
      }
      public void setUploadContentType(List<String> uploadContentType) {
          this.uploadContentType = uploadContentType;
      }
      public List<String> getUploadFileName() {
          return uploadFileName;
      }
      public void setUploadFileName(List<String> uploadFileName) {
          this.uploadFileName = uploadFileName;
      }
      @Action(value="multiup",results={@Result(name="input",location="/error.jsp")})
      public void uploadFile(){
          //在WebContent下新建一个upload的文件夹,获取其在服务器的绝对磁盘路径
          String path = ServletActionContext.getServletContext().getRealPath("/upload");
          try {
              for (int i = 0; i < upload.size(); i++) {
                  //创建一个服务器端的文件
                  File dest = new File(path,uploadFileName.get(i));
                  //完成文件上传的操作
                  FileUtils.copyFile(upload.get(i), dest);
              }
          } catch (IOException e) {
              e.printStackTrace();
          }
      }
    }
    

    ```

  • struts.xml中的内容如下

    <struts>
      <!--配置开发者模式,可以显示更加详细的错误信息 -->
      <constant name="struts.devMode" value="true"></constant>
      <constant name="struts.multipart.maxSize" value="20971520"></constant>
      <package name="upload_demo" extends="struts-default" namespace="/" >
          <interceptors>
              <interceptor-stack name="myStack">
                  <interceptor-ref name="fileUpload">
                      <!--设置上传文件允许的后缀名,多个使用逗号隔开  -->
                      <param name="allowedExtensions">avi,txt</param>
                  </interceptor-ref>
                  <!-- 配置了其他的拦截器,就需要手动导入默认的拦截器 -->
                  <interceptor-ref name="defaultStack"></interceptor-ref>
              </interceptor-stack>
          </interceptors>
      </package>
    </struts>
    

总结

  • 相比较于使用单纯的javaweb开发FileUpload来实现文件上传,使用Struts2框架的文件上传更加的简洁方便,相关的文件上传的控制也更加的方便.但需要对Struts2框架有所熟悉,才能灵活的运用Strust2的文件上传功能.
评论 5 您还未登录,请先 登录 后发表或查看评论
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值