Struts2之实现文件上传与下载

在电脑前坐了一天，看看这个看看那个，也没什么意思，就翻一翻以前培训时的课件，整理整理全当做复习了。

当我们用struts2进行文件上传时，首先要将from表单的enctype属性进行重新设置。那么该属性的取值就是决定表单数据的编码方式。一般有三个属性取值：

application/x-www-form-urlencoded：默认的编码方式，它只处理表单域里的value属性，采用这种编码方式的表单会将表单域的值处理成URL编码方式。这种方式按ISO-8859-1的编码方式将表单上传到服务器，但是这种方式是上传不了文件的。那么如果我们上传的含有文件域则采用下面的方式（multipart/form-data）。

multipart/form-data：这种编码方式会以二进制流的方式来处理表单数据，这种编码方式会把文件域指定文件的内容也封装到请求参数里。（进行文件上传时采用这种方式）

text/plain：这种编码方式当表单的action属性为mailto:URL的形式时比较方便，这种方式主要用于直接通过表单发送邮件的方式。（这种方式已经不再采用了）
注：
如果要实现文件的上传，则表单的method属性必须设置成：post提交方式。
如果要实现文件的上传，表单的enctype属性必须设置成：multipart/form-data。
一旦设置了表单的enctype="multipart/form-data" (即：<form action="" method="post" enctype="multipart/form-data">)属性，就无法通过HttpServletRequest对象的getParameter()方法获取请求参数值。（就是说除了文件域以外其他的普通表单域(如：文本框、单选框、复选框、文本域等)则取不到）

对于Java应用而言，比较常用的上传框架有两个：common-fileupload和cos，这两个框架都是负责解析出HttpServletRequest请求中的所有域。通过上传框架获得了文件域对应的文件内容，就可以通过IO流将文件内容写入服务器的任意位置。在项目开发中一般使用common-fileupload框架较多，当然针对不同的需求使用不同的上传框架，使用该框架一般需要使用如下两个jar文件：
commons-fileupload-1.2.1.jar    commons-io-1.3.2.jar

Struts2并未提供自己的请求解析器，因此Struts2并不会自己去处理multipart/form-data的请求，它需要调用其他请求解析器(如：common-fileupload或cos)，将HTTP请求中的表单域解析出来，但是Struts2在原有的上传解析器基础上做了进一步封装，更进一步简化了文件上传。查看一下xml文件就能找到Strus2对应的文件上传拦截器，当然并不需要我们自己去配置，struts2已经为我们配完了，直接用就可以了。
根据实际情况定到底要选择哪个上传控件，到default.properties属性文件中去查看struts2支持哪些上传控件，自己配一下就可以了，但是别忘记拷Jar包。
Struts2默认使用Jakarata的Common-FileUpload框架实现文件上传，如果使用其它两个框架则只需要修改struts.multipart.parser常量，同时在Web工程中增加相应的上传框架的jar文件即可。
那么，我们做一下struts2的默认的上传方式的配置：

 

第一步：在WEB-INF/lib下加入commons-fileupload-1.2.1.jar、commons-io-1.3.2.jar。这两个文件可以从http://commons.apache.org/下载。

 

第二步：把form表的enctype设置为：“multipart/form-data“，如下：

<form enctype="multipart/form-data" action="${pageContext.request.contextPath}/xxx.action" method="post">
        书名：<input type="text" name="bookname"><br>
        作者：<input type="text" name="author"><br>
        图片：<input type="file" name=" uploadImage "><br>
       <input type="submit" value="提交"/>
</form>

 

 

第三步：在Action类中添加以下属性，属性红色部分对应于表单中文件字段的名称：

public class UploadAction{
  private File uploadImage; //文件
  private String uploadImageContentType;//文件的类型
  private String uploadImageFileName;//文件的名称
  private String bookname;//书名
  private String author;//作者
  private String savePath;//文件的保存位置
  //属性的getter/setter方法
  public String upload() throws Exception{
             //实现上传代码，I/O操作完成
  return "uploadSuccess";
  }
}

 

 

注：一个表单里的文件域对应Action中三个属性，分别是文件，文件名，文件类型，命名是固定的，文件名必须表单中的文件域名称相同（uploadImage），文件名为：文件+FileName，文件类型：文件+ContentType。

 

第四步：将我们的上传Action配置到struts.xml中。

 

<action name="upload" class="com.gqy.UploadAction">
      <param name="savePath">/uploadFile</param>
      <result>/success.jsp</result>
</action>

 

注：
指定上传文件的在服务器上的保存目录，需要在UploadAction中为定义savePath变量并为其添加相应的setter和getter方法，便于Struts2将/uploadFile值赋给savePath属性，即要想在UploadAction中使用savePath变量必须在UploadAction定义。

手动配置文件过滤类型

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

 

 

手动配置文件大小限制

<param name="maximumSize" >1048576</param>

 

 

使用Struts2的文件上传拦截器实现文件过滤

Struts2提供了一个文件上传的拦截器—fileUpload，通过配置该拦截器可以方便实现上传文件的过滤。
配置fileUpload拦截器时，可以为其指定两个参数：
 allowedTypes：指定允许上传的文件类型，多个文件类型之间以英文逗号(,)隔开。
 maximumSize：指定允许上传的文件大小，单位是字节。
提示：通过配置fileUpload拦截器，可以轻松的实现文过滤，当文件过滤失败后，系统自动转入input逻辑视图，因此必须为该Action配置名为input的逻辑视图，除此之外，还必须显示地为该Action配置defaultStack的拦截器引用。

使用Struts2的拦截器实现文件过滤配置如下：

 

<action name="uploadFileAction" class="com.actions.UploadFileAction">
          <interceptor-ref name="defaultStack">
              <!-- 配置允许上传的文件类型，多个用","分隔 -->                 
              <param name="fileUpload.allowedTypes">                     
                    image/bmp,image/png,image/gif,image/jpeg,image/jpg 
                    ,image/x-png, image/pjpeg
              </param>                
              <!-- 配置允许上传的文件大小，单位字节,本例为：1MB -->
              <param name="fileUpload.maximumSize">1048576</param>
          </interceptor-ref>
          <result name="input">/jsp/oneFileFileupload.jsp</result>
          <result name="success">/jsp/result.jsp</result>
 </action>

 

当用户上传失败后，需要有一定的提示信息。在Struts2中，使用<s:fielderror/>标签即可将错误提示信息输出到页面中。
注：要想使用Struts2错误提示信息，则上传文件的Action类，必须继承ActionSupport，否则Struts2不会提供输出错误提示信息功能。

我们可以配置资源文件（.properties）来保存输出给用户的信息。

struts.messages.eror.file.too.large：当上传文件大小超过设定的值时，Struts2将输出该key对应的提示信息。
struts.messages.error.content.type.not.allowed：当上传文件类型不符合设定的值时，Struts2将输出该key对应的提示信息。
struts.messages.error.uploading：当上传文件时出现未知错误时，Struts2将输出该key对应的提示信息。

我们还要将资源文件配置到struts.xml文件中，接下来看看我们的资源文件，已经包含中文了，得把它进行一下转换再配置到工程中。
在struts.xml中设定资源文件：

      <constant name="struts.custom.i18n.resources" value="messages"/>或
<constant name="struts.custom.i18n.resources" value="messages_zh_CN"/>

用命令native2ascii  d:\messages.properties d:\messages_zh_CN.properties将原有的资源文件转换成支持中的。
注：保持国际化，资源文件的名称后缀为： *_zh_CN＋文件扩展名的形式。

对于多个文件上传的原理同上，但是需要注意的是，多个文件域的name属性名必须相同，而且在Action中应该使用File [] 或者List<File>来接收。

个人觉得用这样的方式进行多个文件上传不是很好。

 

Struts2进行文件下载

Struts2提供了stream结果类型，该结果类型专门用于支持文件下载的功能。当指定stream结果类型时，需要配置一个inputName参数，该参数指定了一个输入流，这个输入流是被下载文件的入口(即通过该入口才能实现文件以流的方式实现下载)。

实现文件下载的Action

public class FileDownloadAction implements Action{
   //该属性值在配置文件中指定，Struts2会自动进行注入（即赋值），需要为该属性提供setter和 getter方法
   private String inputPath;//指定要下载的文件的完整路径(路径名＋文件名)
   /*
     * 实现下载的Action类应该提供一个返回InputStream实例的方法，该方法对应在      
        <result.../>里的inputName属性值为targetFile
   */
   public InputStream getTargetFile() throws Exception{
      return  ServletActionContext.getServletContext().getResourceAsStream(inputPath);
   }
   //处理用户请求的execute方法，该方法返回success字符串
   public String execute() throws Exception{
      return "success";
   }
}

 

 

对应Action在struts.xml文件中的配置

 

<action name="download" class="com.FileDownloadAction">
   <!--指定被下载资源的位置-->
      <param name="inputPath">/uploadFile/demo.txt</param>
   <!--配置结果类型为stream的结果-->
   <result name="success" type="stream">
       <!--指定下载文件的文件类型-->
          <param name="contentType"></param>
       <!--指定下载文件的文件位置-->
          <param name="inputName">targetFile</param>
       <!--指定下载文件的下载方式及下载时的保存文件名，filename保存时的文件名必须有扩展名，扩展名指示了下载类型的图标-->
          <param name="contentDisposition">
                attachment;filename=Struts2.txt
          </param>
       <!--指定下载文件的缓冲区大小-->
          <param name="bufferSize">4096</param>
   </result>
</action>

 

 

Struts2实现的文件下载，对于本地下载是好使的，但是像迅雷这样的第三方下载软件是下不下来的。

在做文件上传和下载的时候一定要注意将中文文件名转码和编码。

评论

1 楼 alabowa 2015-11-24  

一旦设置了表单的enctype="multipart/form-data" (即：<form action="" method="post" enctype="multipart/form-data">)属性，就无法通过HttpServletRequest对象的getParameter()方法获取请求参数值。（就是说除了文件域以外其他的普通表单域(如：文本框、单选框、复选框、文本域等)则取不到）

那你的例子里  书名：<input type="text" name="bookname"><br> 
        作者：<input type="text" name="author"><br>
这两个值是什么获取到的？