Struts2单文件上传原理及示例-白红宇

Struts2单文件上传原理及示例

阅读量：6583 次

发布时间：2019-06-24

本文共 6338 字，大约阅读时间需要 21 分钟。

一、文件上传的原理

表单元素的enctype属性指定的是表单数据的编码方式，该属性有3个值：

1、application/x-www-form-urlencoded：这是默认编码方式，它只处理表单域里的value属性值，采用这种编码方式的表单会将表单域的值处理成URL编码方式。

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

3、text/plain：这种方式主要适用于直接通过表单发送邮件的方式。文件上传是web应用经常用到的一个知识。原理是，通过为表单元素设置

enctype=”multipart/form-data”属性，让表单提交的数据以二进制编码的方式提交，在接收此请求的Servlet中用二进制流来获取内容，就可以取得上传文件的内容，从而实现文件的上传。

在Java领域中，有两个常用的文件上传项目：一个是Apache组织Jakarta的Common-FileUpload组件 (http://commons.apache.org/fileupload/)，另一个是Oreilly组织的COS框架(http://www.servlets.com/cos/)。利用这两个框架都能很方便的实现文件的上传。

二、Struts2的文件上传

Struts2并未提供自己的请求解析器，也就是就Struts2不会自己去处理multipart/form-data的请求，它需要调用其他请求解析器，将HTTP请求中的表单域解析出来。但Struts2在原有的上传解析器基础上做了进一步封装，更进一步简化了文件上传。Struts2默认使用的是Jakarta的Common-FileUpload框架来上传文件，因此，要在web应用中增加两个Jar文件：commons-fileupload-1.2.jar和commons-io-1.3.1.jar。它在原上传框架上做了进一步封装，简化了文件上传的代码实现，取消了不同上传框架上的编程差异。如果要改成其它的文件上传框架，可以修改struts.multipart.parser常量的值为cos/pell，默认值是jakata。并在classpath中增加相应上传组件的类库。

以下是如何利用Struts如何实现单文件上传的示例：

1、首先是创建一个FileUpload.jsp页面（此页面特殊之处只是把表单的enctype属性设置为multipart/form-data。）。

1 <%@ page language="java" contentType="text/html; charset=UTF-8"%> 2  3  4     Struts2 File Upload 5  6  7     
     
       8         文件标题：
      
      
 9         选择文件：
      
      
10        
             11     
     
12 13

2、创建处理上传请求的Action类

1 package org.qiujy.web.struts2; 2 import java.io.BufferedInputStream; 3 import java.io.BufferedOutputStream; 4 import java.io.File; 5 import java.io.FileInputStream; 6 import java.io.FileOutputStream; 7 import java.io.InputStream; 8 import java.io.OutputStream; 9 import org.apache.struts2.ServletActionContext;10 import com.opensymphony.xwork2.ActionSupport;11 publicclass FileUploadAction extends ActionSupport {12     privatestaticfinalintBUFFER_SIZE = 16 * 1024;13     // 文件标题14     private String title;15     // 上传文件域对象16     private File upload;17     // 上传文件名18     private String uploadFileName;19     // 上传文件类型20     private String uploadContentType;21     // 保存文件的目录路径(通过依赖注入)22     private String savePath;23     //以下省略getter和setter......24     //自己封装的一个把源文件对象复制成目标文件对象25     privatestaticvoid copy(File src, File dst) {26         InputStream in = null;27         OutputStream out = null;28         try {29             in = new BufferedInputStream(new FileInputStream(src), BUFFER_SIZE);30             out = new BufferedOutputStream(new FileOutputStream(dst),31                     BUFFER_SIZE);32             byte[] buffer = newbyte[BUFFER_SIZE];33             int len = 0;34             while ((len = in.read(buffer)) > 0) {35                 out.write(buffer, 0, len);36             }37         } catch (Exception e) {38             e.printStackTrace();39         } finally {40             if (null != in) {41                 try {42                     in.close();43                 } catch (IOException e) {44                     e.printStackTrace();45                 }46             }47             if (null != out) {48                 try {49                     out.close();50                 } catch (IOException e) {51                     e.printStackTrace();52                 }53             }54         }55     }56     @Override57     public String execute() throws Exception {58         //根据服务器的文件保存地址和原文件名创建目录文件全路径59         String dstPath = ServletActionContext.getServletContext()60                                 .getRealPath(this.getSavePath())61                                 + "\" + this.getUploadFileName();62        63         System.out.println("上传的文件的类型："+ this.getUploadContentType());64        65         File dstFile = new File(dstPath);66         copy(this.upload, dstFile);67         returnSUCCESS;68     }69 }

上面这个Action类中，提供了title和upload两个属性来分别对应页面的两个表单域属性，用来封装表单域的请求参数。但是，值得注意的是，此Action中还有两个属性：uploadFileName和uploadContentType，这两个属性分别用于封装上传文件的文件名、文件类型。这是Struts2设计的独到之处：Strut2的Action类直接通过File类型属性直接封装了上传文件的文件内容，但这个File属性无法获取上传文件的文件名和文件类型，所以Struts2就直接将文件域中包含的上传文件名和文件类型的信息封装到uploadFileName和uploadContentType属性中，也就是说Struts2针对表单中名为xxx的文件域，在对应的Action类中使用3个属性来封装该文件域信息：

1、类型为File的xxx属性：用来封装页面文件域对应的文件内容。

2、类型为String的xxxFileName属性：用来封装该文件域对应的文件的文件名。

3、类型为String的xxxContentType属性：用来封装该文件域应用的文件的文件类型。

另外，在这个Action类中还有一个savePath属性，它的值是通过配置文件（Struts.XML中的参数节点的设置）来动态设置的，这也是Strut2设计中的一个依赖注入特性的使用。

3、在Struts.xml中的配置文件的情况

1  4 
     
       5     
      
        6         
       
         8       
         9             
        /upload10             
        
         /showupload.jsp
        11         
       12     
      13

在这个文件中跟以前配置唯一不同的是给action配置了一个<param …/>元素，用来为该Action的savePath属性动态注入值。

web.xml中的配置跟以前的应用一样。说明一点：好多网络文章说Struts2上传时要在web.xml中配置一个名为 ActionContextUp的过滤器，说是有一些莫名的错误，可是是我用了Struts2新版本2.0.9GA版，测了n次，没出现什么问题，所以没配置。

4、运行项目进行调试

运行前要在根目录下建立一个Upload文件夹，如果不建可在项目中的代码中添加创建文件夹的代码。用于存放上传后的文件。

5、文件类型及错误输出

Struts2提供了一个文件上传的拦截器(名为fileUpload)，通过配置这个拦截器能轻松地实现文件类型的过滤。在上例中，若要配置上传的文件只能是一些普通的图片文件格式：image/bmp、image/png、image/gif、image/jpeg、image/jpg等，则可在struts.xml文件中按如下方式配置：

1  4 
      
        5     
        6     
       
         7         
        
          9             
         
          10               
          11               
          12     　　　　　　image/bmp,image/png,image/gif,image/jpeg,image/jpg13 ,image/x-png, image/pjpeg14               15               
          16               
          10240017            
         18            
         19             
         20             
         /upload21             
         
          /index.jsp
         22             
         
          /showupload.jsp
         23         
        24     
       25

如果文件上传失败后，会跳转到input节点中对应的index.jsp页面，在index.jsp页面中添加一个 <s:fielderror/>标签，用于将错误信息显示在index.jsp页面中。然后进行运行调试。最后发现效果不是太友好，则可以利用Struts2的国际化标准来将错误进行重新定义。

新建一个国际化资源文件，Struts.propertites，然后补充资源文件中的内容如下所示：

#更改上传文件类型不允许的提示信息struts.messages.error.content.type.not.allowed=文件上传失败：你要上传的文件类型不允许#更改上传文件太大的提示信息struts.messages.error.file.too.large=文件上传失败：你要上传的文件太大#文件上传其它错误信息struts.messages.error.uploading=文件上传失败：发生内部错误

另外，在控制台会看一些消息例如：

Unable to find 'struts.multipart.saveDir' property setting. Defaulting to javax.servlet.context.tempdirRemoving file upload D:\tomcat6.0.13\work\Catalina\localhost\fileload_struts2\upload__4b616fd1_115a3d5d9dc__7fff_00000005.

第一个说是找不以struts.multipart.saveDir，即没有指定临时文件夹，这个很好解决，只需指定一个struts.multipart.saveDir常量值为某个目录来解决。

第二个说正在删除一个临时文件，这个临时文件是上传过程中产生的，属正常。

转载于:https://www.cnblogs.com/pzfdStudy/p/5409014.html

你可能感兴趣的文章