文件上传1————>struts2

太过爱你忘了你带给我的痛 2022-06-13 14:23 179阅读 0赞

## 实现原理 ##

Struts 2是通过Commons FileUpload**文件上传**。Commons FileUpload通过将HTTP的数据保存到临时文件夹，然后Struts使用fileUpload拦截器将文件绑定到Action的实例中。从而我们就能够以本地文件方式的操作浏览器上传的文件。

## 具体实现 ##

前段时间Apache发布了Struts 2.0.6 GA，所以本文的实现是以该版本的Struts作为框架的。以下是例子所依赖类包的列表：

![依赖类包的列表][r_img1.gif]   
*清单1 依赖类包的列表*

首先，创建**文件上传**页面FileUpload.jsp，内容如下：

<% @ page language = " java "  contentType = " text/html; charset=utf-8 "  pageEncoding = " utf-8 "  %>   
 <% @ taglib prefix = " s "  uri = " /struts-tags "   %>   
  
 <! DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" >   
 < html  xmlns ="http://www.w3.org/1999/xhtml" >   
 < head >   
     < title > Struts 2 File Upload </ title >   
 </ head >   
 < body >   
     < s:form  action ="fileUpload"  method ="POST"  enctype ="multipart/form-data" >   
         < s:file  name ="myFile"  label ="Image File"  />   
         < s:textfield  name ="caption"  label ="Caption"  />           
         < s:submit  />   
     </ s:form >   
 </ body >   
 </ html >

*清单2 FileUpload.jsp*

在FileUpload.jsp中，先将表单的提交方式设为POST，然后将enctype设为multipart/form-data，这并没有什么特别之处。接下来，<s:file/>标志将**文件上传**控件绑定到Action的myFile属性。

其次是FileUploadAction.java代码：

![None.gif][] package  tutorial;  
![None.gif][]  
![None.gif][] import  java.io.BufferedInputStream;  
![None.gif][] import  java.io.BufferedOutputStream;  
![None.gif][] import  java.io.File;  
![None.gif][] import  java.io.FileInputStream;  
![None.gif][] import  java.io.FileOutputStream;  
![None.gif][] import  java.io.InputStream;  
![None.gif][] import  java.io.OutputStream;  
![None.gif][] import  java.util.Date;  
![None.gif][]  
![None.gif][] import  org.apache.**struts2**.ServletActionContext;  
![None.gif][]  
![None.gif][] import  com.opensymphony.xwork2.ActionSupport;  
![None.gif][]  
![ExpandedBlockStart.gif][] public  class  FileUploadAction  extends  ActionSupport  \{  
![InBlock.gif][]    privatestaticfinallong serialVersionUID = 572146812454l;  
![InBlock.gif][]    privatestaticfinalint BUFFER\_SIZE = 16\*1024;  
![InBlock.gif][]      
![InBlock.gif][]    private File myFile;  
![InBlock.gif][]    private String contentType;  
![InBlock.gif][]    private String fileName;  
![InBlock.gif][]    private String imageFileName;  
![InBlock.gif][]    private String caption;  
![InBlock.gif][]      
![ExpandedSubBlockStart.gif][]    publicvoid setMyFileContentType(String contentType) \{  
![InBlock.gif][]        this.contentType = contentType;  
![ExpandedSubBlockEnd.gif][]    \}  
![InBlock.gif][]      
![ExpandedSubBlockStart.gif][]    publicvoid setMyFileFileName(String fileName) \{  
![InBlock.gif][]        this.fileName = fileName;  
![ExpandedSubBlockEnd.gif][]    \}  
![InBlock.gif][]          
![ExpandedSubBlockStart.gif][]    publicvoid setMyFile(File myFile) \{  
![InBlock.gif][]        this.myFile = myFile;  
![ExpandedSubBlockEnd.gif][]    \}  
![InBlock.gif][]      
![ExpandedSubBlockStart.gif][]    public String getImageFileName() \{  
![InBlock.gif][]        return imageFileName;  
![ExpandedSubBlockEnd.gif][]    \}  
![InBlock.gif][]      
![ExpandedSubBlockStart.gif][]    public String getCaption() \{  
![InBlock.gif][]        return caption;  
![ExpandedSubBlockEnd.gif][]    \}  
![InBlock.gif][]  
![ExpandedSubBlockStart.gif][]    publicvoid setCaption(String caption) \{  
![InBlock.gif][]        this.caption = caption;  
![ExpandedSubBlockEnd.gif][]    \}  
![InBlock.gif][]      
![ExpandedSubBlockStart.gif][]    privatestaticvoid copy(File src, File dst) \{  
![ExpandedSubBlockStart.gif][]        try\{  
![InBlock.gif][]            InputStream in =null;  
![InBlock.gif][]            OutputStream out =null;  
![ExpandedSubBlockStart.gif][]            try\{                  
![InBlock.gif][]                in =new BufferedInputStream(new FileInputStream(src), BUFFER\_SIZE);  
![InBlock.gif][]                out =new BufferedOutputStream(new FileOutputStream(dst), BUFFER\_SIZE);  
![InBlock.gif][]                byte\[\] buffer =newbyte\[BUFFER\_SIZE\];  
![ExpandedSubBlockStart.gif][]                while(in.read(buffer) >0) \{  
![InBlock.gif][]                    out.write(buffer);  
![ExpandedSubBlockEnd.gif][]                \}  
![ExpandedSubBlockStart.gif][]            \}finally\{  
![ExpandedSubBlockStart.gif][]                if(null!= in) \{  
![InBlock.gif][]                    in.close();  
![ExpandedSubBlockEnd.gif][]                \}  
![ExpandedSubBlockStart.gif][]                if(null!= out) \{  
![InBlock.gif][]                    out.close();  
![ExpandedSubBlockEnd.gif][]                \}  
![ExpandedSubBlockEnd.gif][]            \}  
![ExpandedSubBlockStart.gif][]        \}catch(Exception e)\{  
![InBlock.gif][]            e.printStackTrace();  
![ExpandedSubBlockEnd.gif][]        \}  
![ExpandedSubBlockEnd.gif][]    \}  
![InBlock.gif][]      
![ExpandedSubBlockStart.gif][]    privatestatic String getExtention(String fileName) \{  
![InBlock.gif][]        int pos = fileName.lastIndexOf(".");  
![InBlock.gif][]        return fileName.substring(pos);  
![ExpandedSubBlockEnd.gif][]    \}  
![InBlock.gif][]  
![InBlock.gif][]    @Override  
![ExpandedSubBlockStart.gif][]    public String execute()    \{          
![InBlock.gif][]        imageFileName =new Date().getTime() \+ getExtention(fileName);  
![InBlock.gif][]        File imageFile =new File(ServletActionContext.getServletContext().getRealPath("/UploadImages") \+"/"\+ imageFileName);  
![InBlock.gif][]        copy(myFile, imageFile);  
![InBlock.gif][]        return SUCCESS;  
![ExpandedSubBlockEnd.gif][]    \}  
![InBlock.gif][]      
![ExpandedBlockEnd.gif][]\}

*清单3 tutorial/FileUploadAction.java*

在FileUploadAction中我分别写了setMyFileContentType、setMyFileFileName、setMyFile和setCaption四个Setter方法，后两者很容易明白，分别对应FileUpload.jsp中的<s:file/>和<s:textfield/>标志。但是前两者并没有显式地与任何的页面标志绑定，那么它们的值又是从何而来的呢？其实，<s:file/>标志不仅仅是绑定到myFile，还有myFileContentType（上传文件的MIME类型）和myFileFileName（上传文件的文件名，该文件名不包括文件的路径）。因此，<s:file name="xxx" />对应Action类里面的xxx、xxxContentType和xxxFileName三个属性。

FileUploadAction作用是将浏览器上传的文件拷贝到WEB应用程序的UploadImages文件夹下，新文件的名称是由系统时间与上传文件的后缀组成，该名称将被赋给imageFileName属性，以便上传成功的跳转页面使用。

下面我们就来看看上传成功的页面：

<% @ page language = " java "  contentType = " text/html; charset=utf-8 "  pageEncoding = " utf-8 "  %>   
 <% @ taglib prefix = " s "  uri = " /struts-tags "   %>   
  
 <! DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" >   
 < html  xmlns ="http://www.w3.org/1999/xhtml" >   
 < head >   
     < title > Struts 2 File Upload </ title >   
 </ head >   
 < body >   
     < div  style ="padding: 3px; border: solid 1px \#cccccc; text-align: center" >   
         < img  src ='UploadImages/<s:property  value ="imageFileName"  /> ' />  
         < br  />   
         < s:property  value ="caption"  />   
     </ div >   
 </ body >   
 </ html >

*清单4 ShowUpload.jsp*

ShowUpload.jsp获得imageFileName，将其UploadImages组成URL，从而将上传的图像显示出来。

然后是Action的配置文件：

<? xml version="1.0" encoding="UTF-8" ?>   
  
 <! DOCTYPE struts PUBLIC  
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"  
    "http://struts.apache.org/dtds/struts-2.0.dtd" >   
  
 < struts >   
     < package  name ="fileUploadDemo"  extends ="struts-default" >   
         < action  name ="fileUpload"  class ="tutorial.FileUploadAction" >   
             < interceptor-ref  name ="fileUploadStack"  />   
             < result  name ="success" > /ShowUpload.jsp </ result >   
         </ action >   
     </ package >   
 </ struts >

*清单5 struts.xml*

fileUpload Action显式地应用fileUploadStack的拦截器。

最后是web.xml配置文件：

<? xml version="1.0" encoding="UTF-8" ?>   
 < web-app  id ="WebApp\_9"  version ="2.4"   
    xmlns ="http://java.sun.com/xml/ns/j2ee"   
    xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance"   
    xsi:schemaLocation ="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app\_2\_4.xsd" >   
  
     < display-name > Struts 2 Fileupload </ display-name >   
  
     < filter >   
         < filter-name > struts-cleanup </ filter-name >   
         < filter-class >   
            org.apache.**struts2**.dispatcher.ActionContextCleanUp  
         </ filter-class >   
     </ filter >   
      
     < filter >   
         < filter-name > **struts2** </ filter-name >   
         < filter-class >   
            org.apache.**struts2**.dispatcher.FilterDispatcher  
         </ filter-class >   
     </ filter >   
      
     < filter-mapping >   
         < filter-name > struts-cleanup </ filter-name >   
         < url-pattern > /\* </ url-pattern >   
     </ filter-mapping >   
  
     < filter-mapping >   
         < filter-name > **struts2** </ filter-name >   
         < url-pattern > /\* </ url-pattern >   
     </ filter-mapping >   
  
     < welcome-file-list >   
         < welcome-file > index.html </ welcome-file >   
     </ welcome-file-list >   
  
 </ web-app >

*清单6 WEB-INF/web.xml*

发布运行应用程序，在浏览器地址栏中键入：[http://localhost:8080/**Struts2**\_Fileupload/FileUpload.jsp][http_localhost_8080_Struts2_Fileupload_FileUpload.jsp]，出现图示页面：

![r_img2.gif][]  
*清单7 FileUpload页面*

选择图片文件，填写Caption并按下Submit按钮提交，出现图示页面：

![r_img3.gif][]  
*清单8 上传成功页面*

## 更多配置 ##

在运行上述例子，如果您留心一点的话，应该会发现服务器控制台有如下输出：

Mar  20 ,   2007  4 : 08 : 43  PM org.apache.**struts2**.dispatcher.Dispatcher getSaveDir  
INFO: Unable to find 'struts.multipart.saveDir' property setting. Defaulting to javax.servlet.context.tempdir  
Mar  20 ,  2007  4 : 08 : 43  PM org.apache.**struts2**.interceptor.FileUploadInterceptor intercept  
INFO: Removing file myFile C:\\Program Files\\Tomcat  5.5 \\work\\Catalina\\localhost\\**Struts2**\_Fileupload\\upload\_251447c2\_1116e355841\_\_7ff7\_00000006.tmp

*清单9 服务器控制台输出*

上述信息告诉我们，struts.multipart.saveDir没有配置。struts.multipart.saveDir用于指定存放临时文件的文件夹，该配置写在struts.properties文件中。例如，如果在struts.properties文件加入如下代码：

struts.multipart.saveDir = /tmp

*清单10 struts配置*

这样上传的文件就会临时保存到你根目录下的tmp文件夹中（一般为c:\\tmp），如果此文件夹不存在，Struts 2会自动创建一个。

## 错误处理 ##

上述例子实现的图片上传的功能，所以应该阻止用户上传非图片类型的文件。在Struts 2中如何实现这点呢？其实这也很简单，对上述例子作如下修改即可。

首先修改FileUpload.jsp，在<body>与<s:form>之间加入“<s:fielderror />”，用于在页面上输出错误信息。

然后修改struts.xml文件，将Action fileUpload的定义改为如下所示：

< action  name ="fileUpload"  class ="tutorial.FileUploadAction" >   
             < interceptor-ref  name ="fileUpload" >   
                 < param  name ="allowedTypes" >   
                    image/bmp,image/png,image/gif,image/jpeg  
                 </ param >   
             </ interceptor-ref >   
             < interceptor-ref  name ="defaultStack"  />               
             < result  name ="input" > /FileUpload.jsp </ result >   
             < result  name ="success" > /ShowUpload.jsp </ result >   
         </ action >

*清单11 修改后的配置文件*

显而易见，起作用就是fileUpload拦截器的allowTypes参数。另外，配置还引入defaultStack它会帮我们添加验证等功能，所以在出错之后会跳转到名称为“input”的结果，也即是FileUpload.jsp。

发布运行应用程序，出错时，页面如下图所示：

![r_img4.gif][]  
*清单12 出错提示页面*

上面的出错提示是Struts 2默认的，大多数情况下，我们都需要自定义和国际化这些信息。通过在全局的国际资源文件中加入“struts.messages.error.content.type.not.allowed=The file you uploaded is not a image”，可以实现以上提及的需求。对此有疑问的朋友可以参考我之前的文章《[在Struts 2.0中国际化(i18n)您的应用程序][Struts 2.0_i18n]》。

实现之后的出错页面如下图所示：

![r_img5.gif][]  
*清单13 自定义出错提示页面*

同样的做法，你可以使用参数“maximumSize”来限制上传文件的大小，它对应的字符资源名为：“struts.messages.error.file.too.large”。

字符资源“struts.messages.error.uploading”用提示一般的上传出错信息。

## 多**文件上传** ##

与单**文件上传**相似，Struts 2实现多**文件上传**也很简单。你可以将多个<s:file />绑定Action的数组或列表。如下例所示。

< s:form  action ="doMultipleUploadUsingList"  method ="POST"  enctype ="multipart/form-data" >   
     < s:file  label ="File (1)"  name ="upload"  />   
     < s:file  label ="File (2)"  name ="upload"  />   
     < s:file  label ="FIle (3)"  name ="upload"  />   
     < s:submit  />   
 </ s:form >

*清单14 多**文件上传**JSP代码片段*

如果你希望绑定到数组，Action的代码应类似：

![None.gif][]      private  File\[\] uploads;  
![None.gif][]     private  String\[\] uploadFileNames;  
![None.gif][]     private  String\[\] uploadContentTypes;  
![None.gif][]  
![ExpandedBlockStart.gif][]     public  File\[\] getUpload()  \{ returnthis.uploads; \}   
![ExpandedBlockStart.gif][]     public  void  setUpload(File\[\] upload)  \{ this.uploads = upload; \}   
![None.gif][]  
![ExpandedBlockStart.gif][]     public  String\[\] getUploadFileName()  \{ returnthis.uploadFileNames; \}   
![ExpandedBlockStart.gif][]     public  void  setUploadFileName(String\[\] uploadFileName)  \{ this.uploadFileNames = uploadFileName; \}   
![None.gif][]  
![ExpandedBlockStart.gif][]     public  String\[\] getUploadContentType()  \{ returnthis.uploadContentTypes; \}   
![ExpandedBlockStart.gif][]     public  void  setUploadContentType(String\[\] uploadContentType)  \{ this.uploadContentTypes = uploadContentType; \}

*清单15 多**文件上传**数组绑定Action代码片段*

如果你想绑定到列表，则应类似：

![None.gif][]      private  List < File >  uploads  =  new  ArrayList < File > ();  
![None.gif][]     private  List < String >  uploadFileNames  =   new  ArrayList < String > ();  
![None.gif][]     private  List < String >  uploadContentTypes  =   new  ArrayList < String > ();  
![None.gif][]  
![ExpandedBlockStart.gif][]     public  List < File >  getUpload()  \{  
![InBlock.gif][]        returnthis.uploads;  
![ExpandedBlockEnd.gif][]    \}   
![ExpandedBlockStart.gif][]     public  void  setUpload(List < File >  uploads)  \{  
![InBlock.gif][]        this.uploads = uploads;  
![ExpandedBlockEnd.gif][]    \}   
![None.gif][]  
![ExpandedBlockStart.gif][]     public  List < String >  getUploadFileName()  \{  
![InBlock.gif][]        returnthis.uploadFileNames;  
![ExpandedBlockEnd.gif][]    \}   
![ExpandedBlockStart.gif][]     public  void  setUploadFileName(List < String >  uploadFileNames)  \{  
![InBlock.gif][]        this.uploadFileNames = uploadFileNames;  
![ExpandedBlockEnd.gif][]    \}   
![None.gif][]  
![ExpandedBlockStart.gif][]     public  List < String >  getUploadContentType()  \{  
![InBlock.gif][]        returnthis.uploadContentTypes;  
![ExpandedBlockEnd.gif][]    \}   
![ExpandedBlockStart.gif][]     public  void  setUploadContentType(List < String >  contentTypes)  \{  
![InBlock.gif][]        this.uploadContentTypes = contentTypes;  
![ExpandedBlockEnd.gif][]    \}

*清单16 多**文件上传**列表绑定Action代码片段*

## 总结 ##

在Struts 2中实现**文件上传**的确是轻而易举，您要做的只是使用<s:file />与Action的属性绑定。这又一次有力地证明了Struts 2的简单易用。

posted on 2007-03-21 00:48 [ Max][Max] 阅读(76209) [ 评论(140)][_140]   [编辑][Link 1]   [收藏][Link 2] 所属分类: [Struts 2.0系列][Struts 2.0]

![105124.html_webview_1][]

评论共2页: 1  [2][]  [下一页][2]

**评论:**

[\#][Link 3]  re: 在Struts 2中实现 **文件上传**\[未登录\]2007-08-09 11:44 | james

上传文件好像不能用modelDriven模式，感觉有点不太舒服   [回复][Link 4]   [更多评论][Link 5]

[\#][Link 6]  re: 在Struts 2中实现 **文件上传**2007-08-15 14:51 | baekham

**文件上传**fileUpload拦截器allowedTypes设置疑问?  
<interceptor-ref name="fileUpload" >  
<param name="allowedTypes">  
image/bmp,image/png,image/gif,image/jpeg  
</param>  
</interceptor-ref>  
为什么png、jpeg类型的图片不能上传,提示上传文件格式错误.   [回复][Link 4]   [更多评论][Link 7]

[\#][Link 8]  re: 在Struts 2中实现 **文件上传**2007-08-15 22:15 | [ 王佳][Link 9]

如果在一个信息编辑页面  
上传图片只是其中一个字段  
但图片已经上传  
而我只是需要修改其他信息的时候  
这个时候，修改就会不能通过。  
Content-Type not allowed: myFile "upload\_4e0e6f19\_113d55eebb4\_\_8000\_00000007.tmp" application/octet-stream  
  
请问：有什么好的解决办法？   [回复][Link 4]   [更多评论][Link 10]

[\#][Link 11]  re: 在Struts 2中实现 **文件上传**2007-08-16 13:32 | zhw

上传时指定文件大小后  
上传文件超过指定大小，就不能再次打开上传页面。报下面的错误：  
Struts Problem Report  
Struts has detected an unhandled exception:  
  
Messages: No result defined for action com.superweb.web.action.ResideAction and result input  
  
File: file:/D:/Eclipse/eclipse/workspace/SuperWeb/WebRoot/WEB-INF/classes/struts/struts\_reside.xml  
Line number: 25  
Column number: 70  
  
只能重新启动服务器  
我用的是spring2+hibernate3+ **struts2**  
请问：如何解决？  
dwr＋struts1.2可以实现上传进度条，请问在 **struts2**中如何实现的？  
   [回复][Link 4]   [更多评论][Link 12]

[\#][Link 13]  re: 在Struts 2中实现 **文件上传**2007-08-17 12:56 | babala

Max,  
在  
<param name="allowedTypes">  
image/png,image/bmp,image/gif,image/jpeg,image/jpg  
</param >中,只有bmp与gif格式可以上传,其他三个都说格式不正确,这是为什么?  
另外为什么不直接使用png,bmp,gif....这种格式,而要在前面加上个image?   [回复][Link 4]   [更多评论][Link 14]

[r_img1.gif]: /images/20220613/fd05afddf9884f43abf33b734bea17cd.png
[None.gif]: /images/20220613/f771cbaf82b7413982ca6b6c766f2f60.png
[ExpandedBlockStart.gif]: /images/20220613/fbeb499a439d4a9dbc858dc67cecab18.png
[InBlock.gif]: /images/20220613/3b4791ad8f124cc387c97a010a8693fe.png
[ExpandedSubBlockStart.gif]: /images/20220613/1b0dcb6e5d464dc38c1d28a5b239bfc6.png
[ExpandedSubBlockEnd.gif]: /images/20220613/bce3cc7dfb42440d99e74c825c83b18b.png
[ExpandedBlockEnd.gif]: /images/20220613/69bca0c02b9748c097a17df95d1e7728.png
[http_localhost_8080_Struts2_Fileupload_FileUpload.jsp]: http://localhost:8080/Struts2_Fileupload/FileUpload.jsp
[r_img2.gif]: /images/20220613/d6b9228105f14c6cbf7cec80d353eff1.png
[r_img3.gif]: /images/20220613/bc27e1f6814d440f9d74b81cd10eb6a6.png
[r_img4.gif]: /images/20220613/b1b8c97bd5e643d08db77386907116a8.png
[Struts 2.0_i18n]: http://www.blogjava.net/max/archive/2006/11/01/78536.html
[r_img5.gif]: /images/20220613/ec19f2fb40814d74adfdbdfed2d9d018.png
[Max]: http://www.blogjava.net/max/
[_140]: http://www.blogjava.net/max/archive/2007/03/21/105124.html#Post
[Link 1]: http://www.blogjava.net/max/admin/EditPosts.aspx?postid=105124
[Link 2]: http://www.blogjava.net/max/AddToFavorite.aspx?id=105124
[Struts 2.0]: http://www.blogjava.net/max/category/16130.html
[105124.html_webview_1]: /images/20220613/e7063b3f40a049afabda3aa5d7b14f6a.png
[2]: http://www.blogjava.net/max/archive/2007/03/21/105124.html?page=2#pagedcomment
[Link 3]: http://www.blogjava.net/max/archive/2007/03/21/105124.html#135430
[Link 4]: http://www.blogjava.net/max/archive/2007/03/21/105124.html#post
[Link 5]: http://www.blogjava.net/comment?author=james
[Link 6]: http://www.blogjava.net/max/archive/2007/03/21/105124.html#136906
[Link 7]: http://www.blogjava.net/comment?author=baekham
[Link 8]: http://www.blogjava.net/max/archive/2007/03/21/105124.html#137062
[Link 9]: http://lennon.wang.blog.163.com/
[Link 10]: http://www.blogjava.net/comment?author=%e7%8e%8b%e4%bd%b3
[Link 11]: http://www.blogjava.net/max/archive/2007/03/21/105124.html#137209
[Link 12]: http://www.blogjava.net/comment?author=zhw
[Link 13]: http://www.blogjava.net/max/archive/2007/03/21/105124.html#137510
[Link 14]: http://www.blogjava.net/comment?author=babala