• Struts2单文件上传原理及示例


    一、文件上传的原理

       表单元素的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 <html>
     3 <head>
     4     <title>Struts2 File Upload</title>
     5 </head>
     6 <body>
     7     <form action="fileUpload.action" method="POST" enctype="multipart/form-data">
     8         文件标题:<input type="text" name="title" size="50"/><br/>
     9         选择文件:<input type="file" name="upload" size="50"/><br/>
    10        <input type="submit" value=" 上传 "/>       
    11     </form>
    12 </body>
    13 </html>

         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     @Override
    57     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 <!DOCTYPE struts PUBLIC
     2         "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
     3         "http://struts.apache.org/dtds/struts-2.0.dtd">
     4 <struts>
     5     <package name ="fileUploadDemo" extends ="struts-default">
     6         <action name ="fileUpload"
     7 class ="org.qiujy.web.struts2.FileUploadAction">
     8       <!-- 动态设置Action中的savePath属性的值 -->
     9             <param name="savePath">/upload</param>
    10             <result name ="success">/showupload.jsp</result>
    11         </action >
    12     </package >
    13 </struts>
           在这个文件中跟以前配置唯一不同的是给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 <!DOCTYPE struts PUBLIC
     2         "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
     3         "http://struts.apache.org/dtds/struts-2.0.dtd">
     4 <struts>
     5     <constant name="struts.custom.i18n.resources" value="messages"/>
     6     <package name="fileUploadDemo" extends="struts-default">
     7         <action name="fileUpload"
     8             class="org.qiujy.web.struts2.FileUploadAction">
     9             <interceptor-ref name="fileUpload">
    10               <!-- 配置允许上传的文件类型,多个用","分隔 -->
    11               <param name="allowedTypes">
    12           image/bmp,image/png,image/gif,image/jpeg,image/jpg
    13 ,image/x-png, image/pjpeg
    14               </param>
    15               <!-- 配置允许上传的文件大小,单位字节 -->
    16               <param name="maximumSize">102400</param>
    17            </interceptor-ref>
    18            <interceptor-ref name="defaultStack" />
    19             <!-- 动态设置Action中的savePath属性的值 -->
    20             <param name="savePath">/upload</param>
    21             <result name="input">/index.jsp</result>
    22             <result name="success">/showupload.jsp</result>
    23         </action>
    24     </package>
    25 </struts>

     如果文件上传失败后,会跳转到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.tempdir
    Removing file upload D:	omcat6.0.13workCatalinalocalhostfileload_struts2upload__4b616fd1_115a3d5d9dc__7fff_00000005.

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

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

     

         

        

       

  • 相关阅读:
    Javascript笔记09:Javascript的下拉式导航菜单
    Javascript笔记08:Javascript的if...else语句
    Android(java)学习笔记84:SQLiteDatabase的query方法参数
    Android(java)学习笔记83:各种边距设置
    Android(java)学习笔记82:利用SpannableString设置复合文本
    PHP笔记06:http响应中的状态码
    html笔记04:在html之中导入css两种常见方法
    POJ 3307 Smart Sister
    ZOJ 2872 Binary Partitions
    HDU 4685 Prince and Princess
  • 原文地址:https://www.cnblogs.com/pzfdStudy/p/5409014.html
Copyright © 2020-2023  润新知