Struts2学习手册之文件上传基础教程

 更新时间:2018年05月02日 11:17:02   作者:果冻想  
Struts2提供的文件上传下载机制十分简便,使得我们写很少的代码,下面这篇文章主要给大家介绍了关于Struts2学习手册之文件上传的相关资料,文中通过示例代码介绍的非常详细,需要的朋友可以参考下

前言

我们在开发Web应用时,肯定要为用户提供上传的功能,比如用户上传一张图像作为头像等。为了能上传文件,我们必须将表单的method设置为POST,将enctype设置为multipart/form-data。只有在这种情况下,浏览器才会把用户选择文件的二进制数据发送给服务器。这篇文章就对Struts2框架中的上传功能进行详细的总结,下面话不多说了,来一起看看详细的介绍吧。

Struts2的文件上传

Struts2并未提供自己的请求解析器,也就是说,Struts2不会自己去处理multipart/form-data的请求,它需要调用其它上传框架来解析二进制请求数据,但Struts2在原有的上传解析器基础上做了进一步封装,更进一步简化了文件上传。

在Struts2的default.properties配置文件中,可以看到这样的配置代码:

### Parser to handle HTTP POST requests, encoded using the MIME-type multipart/form-data
# struts.multipart.parser=cos
# struts.multipart.parser=pell
# struts.multipart.parser=jakarta-stream
struts.multipart.parser=jakarta
# uses javax.servlet.context.tempdir by default
struts.multipart.saveDir=
struts.multipart.maxSize=2097152

上述代码主要用于配置Struts2上传文件时的上传解析器。Struts2的封装隔离了底层文件上传组件的区别,开发者只要在此配置文件上传所使用的解析器,就可以轻松地在不同的文件上传框架之间切换。

Struts2默认使用jakarta上传解析器,当然了,如果你不喜欢,你也可以换成别的。下面就通过代码来实现一个简单的基于Struts2的文件上传功能。

实现文件上传的Action

前台页面:

<form action="upload" method="post" enctype="multipart/form-data">
 Title:<input type="text" name="title"><br>
 File:<input type="file" name="upload"><br>
 <input type="submit" value="submit">
</form>

Action类:

public class UploadAction extends ActionSupport
{
 private String title;
 private File upload;
 private String uploadContentType;
 private String uploadFileName;
 private String savePath;

 public void setSavePath(String value)
 {
  this.savePath = value;
 }

 private String getSavePath()
 {
  String realPath = ServletActionContext.getServletContext().getRealPath("/WEB-INF/" + savePath);
  return realPath;
 }

 public void setTitle(String value)
 {
  this.title = value;
 }

 public String getTitle()
 {
  return title;
 }

 public void setUpload(File value)
 {
  this.upload = value;
 }

 public File getUpload()
 {
  return upload;
 }

 public void setUploadContentType(String value)
 {
  this.uploadContentType = value;
 }

 public String getFileContentType()
 {
  return uploadContentType;
 }

 public void setUploadFileName(String value)
 {
  this.uploadFileName = value;
 }

 public String getUploadFileName()
 {
  return uploadFileName;
 }

 @Override
 public String execute() throws Exception
 {
  FileOutputStream fos = new FileOutputStream(getSavePath() + "\\" + getUploadFileName());
  FileInputStream fis = new FileInputStream(getUpload());
  byte[] buffer = new byte[1024];
  int len = 0;
  while ((len = fis.read(buffer)) > 0)
  {
   fos.write(buffer, 0, len);
  }
  fis.close();
  fos.close();
  return SUCCESS;
 }
}

struts.xml配置文件:

<package name="upload" extends="struts-default">
 <action name="upload" class="com.jellythink.practise.UploadAction">
  <param name="savePath">/upload</param>
  <result name="success">/success.jsp</result>
  <result name="input">/index.jsp</result>
 </action>
</package>

对于Action类中,包含了两个特别的属性:

  • uploadContentType
  • uploadFileName

这两个属性分别用于封装上传文件的文件名、上传文件的文件类型。对于Struts2来说,如果Form表单中包含一个name属性为xxx的文件域,则对应的Action需要使用三个属性来封装该文件域的信息:

  • 类型为File的xxx属性封装了该文件域对应的文件内容;
  • 类型为String的xxxFileName属性封装了该文件域对应的文件的文件名;
  • 类型为String的xxxContentType属性封装了该文件域对应的文件的文件类型。

通过上面的开发过程,可以看出通过Struts2实现文件上传确实是一件简单的事情。我们需要做的事情就是将文件域与Action中一个类型为File的属性关联,就可以轻松访问到上传文件的文件内容,至于Struts2如何使用Multipart解析器,对开发者完全透明。

手动实现文件过滤

很多时候,Web应用不允许用户自由上传,我们需要对用户上传的文件类型,文件大小进行限制,因此必须在文件上传过程中进行文件过滤。下面就先手动实现上传文件过滤。

在struts.xml中配置一个新的参数,表示支持的上传类型:

<param name="allowTypes">image/png,image/gif,image/jpeg</param>

在Action中添加验证函数:

// 进行验证
@Override
public void validate()
{
 String filterResult = filterType(getAllowTypes().split(","));
 if (filterResult != null)
 {
  addFieldError("upload", "您要上传的文件类型不正确!");
 }
}

public String filterType(String[] types)
{
 String fileType = getFileContentType();
 for (String type : types)
 {
  if (type.equals(fileType))
  {
   return null;
  }
 }
 return ERROR;
}

这只是实现了类型的判断,然后在根据File类的length()方法,来实现大小的验证。但是好麻烦,接下来就说一种更简单的说法。

拦截器实现文件过滤

Struts2提供了一个文件上传的拦截器,通过配置拦截器可以更轻松地实现文件过滤。Struts2中文件上传的拦截器fileUpload,为了让该拦截器起作用,只需要在该Action中配置该拦截器引用即可。

配置fileUpload拦截器时,可以为其指定两个参数:

  • allowedTypes:该参数指定允许上传的文件类型,多个文件类型之间以英文逗号隔开
  • maximumSize:该参数指定允许上传的文件大小,单位是字节
<!-- 配置fileUpload拦截器 -->
<interceptor-ref name="fileUpload">
 <param name="allowedTypes">image/png,image/gif,image/jpeg</param>
 <param name="maximumSize">20000000</param>
</interceptor-ref>

<!-- 配置系统默认的拦截器 -->
<interceptor-ref name="defaultStack" />
<result name="success">/success.jsp</result>
<result name="input">/index.jsp</result>

这样子,修改配置就可以搞定的事情,比写一坨代码真的轻松多了。

配置错误信息

对于上传出现错误的情况,系统默认都是提示英文的错误信息,但是为了输出国际化的提示信息,这就需要在国际化的资源配置文件中增加以下两个key的消息定义:

  • struts.messages.error.content.type.not.allowed=上传文件类型不正确,请重新上传
  • struts.messages.error.file.too.large=您上传的文件太大,请重新上传

接下来就可以使用<s:fielderror/>来输出错误信息了。

文件上传的常量配置

在文章的开始,我们说到default.properties中的配置,其中有一个struts.multipart.saveDir配置,那么该配置项的具体作用是什么呢?

在Struts2执行文件上传的过程中,需要指定一个临时文件夹,用来存放上传过程中产生的临时文件;如果没有指定临时文件夹,系统默认使用javax.servlet.context.tempdir,在Tomcat安装路径下的work/Catalina/localhost/路径下。而这个struts.multipart.saveDir就是配置临时文件的存放位置的。所以在开发的过程中,一定要注意该目录是否有读写权限哦。

还有一个struts.multipart.maxSize配置,该配置表示上传文件的大小,如果同时指定了这个配置和fileUpload拦截器的maximumSize属性,则先和struts.multipart.maxSize配置的比较,再和fileUpload拦截器的maximumSize属性比较,如果文件大小超过了struts.multipart.maxSize配置的,则会出现异常,并不会将Result转到input,这个一定要注意。

总结

这篇文章详细的总结了Struts2中的文件上传,内容有点多,基本都是手册上的内容,也罢,就当手册了。

好了,以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对脚本之家的支持。

相关文章

  • Java并发编程之显示锁ReentrantLock和ReadWriteLock读写锁

    Java并发编程之显示锁ReentrantLock和ReadWriteLock读写锁

    这篇文章主要介绍了Java并发编程之显示锁ReentrantLock和ReadWriteLock读写锁,本文讲解了ReentrantLock概况、Lock接口、Lock使用、轮询锁的和定时锁、公平性、可中断获锁获取操作等内容,需要的朋友可以参考下
    2015-04-04
  • spring boot mybatis日志输出到控制台的方法实践

    spring boot mybatis日志输出到控制台的方法实践

    在开发过程中我们往往需要打印出SQL语句,这样就方便我们监控问题,本文主要介绍了spring boot mybatis日志输出到控制台的方法实践,具有一定的参考价值,感兴趣的可以了解一下
    2024-05-05
  • spring boot+vue 的前后端分离与合并方案实例详解

    spring boot+vue 的前后端分离与合并方案实例详解

    这篇文章主要介绍了spring boot+vue 的前后端分离与合并方案实例详解,需要的朋友可以参考下
    2017-11-11
  • IDEA设置允许一个类并行的方法

    IDEA设置允许一个类并行的方法

    这篇文章主要介绍了IDEA设置允许一个类并行的方法,本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-04-04
  • 解决@Api注解不展示controller内容的问题

    解决@Api注解不展示controller内容的问题

    这篇文章主要介绍了解决@Api注解不展示controller内容的问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教。
    2022-01-01
  • springboot打印接口调用日志的实例

    springboot打印接口调用日志的实例

    这篇文章主要介绍了springboot打印接口调用日志的实例,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-09-09
  • SpringBoot 2 统一异常处理过程解析

    SpringBoot 2 统一异常处理过程解析

    这篇文章主要介绍了SpringBoot 2 统一异常处理过程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2019-09-09
  • java代码规范review异常事故记录

    java代码规范review异常事故记录

    这篇文章主要为大家介绍了java代码规范关于异常review代码发生异常的事故记录,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2022-06-06
  • Java练习之潜艇小游戏的实现

    Java练习之潜艇小游戏的实现

    这篇文章主要和大家分享一个Java小练习——利用Java编写一个潜艇小游戏,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2022-03-03
  • 在Java 8中将List转换为Map对象方法

    在Java 8中将List转换为Map对象方法

    这篇文章主要介绍了在Java 8中将List转换为Map对象方法,非常不错,具有一定的参考借鉴价值,需要的朋友可以参考下
    2018-11-11

最新评论