快捷導(dǎo)航

Struts2 控制文件上傳下載功能實例代碼

更新時間：2017年05月23日 14:53:15 作者：Walker_YAM

這篇文章主要介紹了Struts2 控制文件上傳下載功能實例代碼,非常不錯，具有參考借鑒價值，需要的朋友可以參考下

之前介紹servlet3.0新特性的時候有提到過servlet API提供了一個part類來實現(xiàn)對文件的上傳和保存，Struts其實是在其基礎(chǔ)上做了進一步的封裝，更加簡單易用。至于文件下載，Struts貫徹AOP 思想，在下載之前提供對用戶權(quán)限控制的API。

下面我們將詳細(xì)介紹上傳和下載的相關(guān)內(nèi)容。

一、Struts文件上傳機制

想要實現(xiàn)文件上傳功能，頁面的表單的method屬性必須被指定為post，還有enctype屬性必須為multipart/form-data，該值表示上傳的內(nèi)容將會以二進制的形式被上傳到服務(wù)器，至于該屬性的其他值的作用及他們之間的區(qū)別，請查看之前文章：servlet3.0新特性。下面給出表現(xiàn)層頁面代碼：

 <body>
  <s:form method="post" enctype="multipart/form-data" action="/upload">
   <s:file name="ufile" label="瀏覽"/>
   <s:submit value="上傳"/>
  </s:form>
 </body>

實際上在Struts的文件上傳中，它使用三個Action屬性來描述被上傳的文件。commons-fileupload-1.3.2.jar和commons-io-2.2.jar這兩個包就是用于輔助表單上傳的內(nèi)容賦值到action屬性中，所以在使用Struts的文件上傳之前應(yīng)當(dāng)先包含著兩個包到項目中。下面給出upload對應(yīng)的action：

public class UploadFile extends ActionSupport {
  //封裝的上傳文件的文件內(nèi)容
  private File ufile;
  //封裝的上傳文件的文件名
  private String ufileFileName;
  //封裝的上傳文件的文件類型
  private String ufileContentType;
  ....省去getter，setter方法

  public String execute() throws IOException {
    FileInputStream fin = new FileInputStream(ufile);
    FileOutputStream fos = new FileOutputStream("F:\\360\\"+ufileFileName);
    byte[] buffer = new byte[1024];
    int len;
    while((len = fin.read(buffer))>0){
      fos.write(buffer,0,len);
    }
    return SUCCESS;
  }
}

先不看execute方法，在該action中，我們可以看到有三個屬性。ufile封裝了上傳的文件的二進制內(nèi)容，ufileFileName（xxxFileName）封裝了該文件的文件名，ufileContentType（xxxContentType）封裝了該文件的類型。他們的值是我們不必關(guān)心的，框架會根據(jù)表單上傳的文件對他們進行賦值，只需要遵守他的命名規(guī)則即可。

execute方法主要是完成將上傳的文件保存到硬盤上，代碼也比較簡單，讀取屬性ufile中的內(nèi)容，寫入磁盤指定位置。下面我們看看運行的結(jié)果截圖：

至此我們就完成了對上傳文件的獲取保存，總體上看來，實際上還是使用了三個action實例屬性對上傳文件相關(guān)信息的封裝。一個屬性封裝的是該上傳文件的二進制內(nèi)容，一個屬性封裝該文件的文件名稱，一個屬性封裝的是該文件的文件類型。實際上把控好這三個屬性，基本可以完成對該上傳文件的所有操作。下面我們看文件下載。

二、Struts文件下載機制

廣義上的文件下載，其實可以使用a標(biāo)簽鏈接到對應(yīng)資源完成對資源的下載，但是在瀏覽器中使用這種方式會導(dǎo)致瀏覽器直接打開該資源文件而非彈出下載框指定下載位置。Struts下載機制通過配置result元素的type屬性為stream來實現(xiàn)的。在類型為stream的result元素中可以配置一些參數(shù)，這些參數(shù)主要有以下一些：

contentType：指定被下載文件的文件類型

inputName：指定被下載文件的輸入流入口

contentDisposition：指定下載文件的文件名

bufferSize：指定下載文件的緩沖大小

具體的應(yīng)用我們從代碼示例中體會：

//直接訪問的action
 <body>
   <a href="/download" rel="external nofollow" >下載資源</a>
 </body>
public class DownloadFile extends ActionSupport {
  private String inputPath;
  public void setInputPath(String s){
    this.inputPath = s;
  }
  public String getInputPath(){
    return this.inputPath;
  }
  public InputStream getTarFile(){
    return ServletActionContext.getServletContext().getResourceAsStream(inputPath);
  }
  @Override
  public String execute(){
    return SUCCESS;
  }
}
//download的action配置
    <action name="download" class="MyPackage.DownloadFile">
      <param name="inputPath">/m.jpg</param>
      <result type="stream">
        <param name="inputName">tarFile</param>
        <param name="contentType">image/jpg</param>
        <param name="contentDisposition">attachment;filename="walker.jpg"</param>
      </result>
    </action>

首先解析下Struts.xml中有關(guān)action的配置代碼，第一個param元素為action中的屬性inputPath動態(tài)賦值，該參數(shù)的值指定了將要被下載的文件資源位置，我們此處指定的web應(yīng)用根目錄下的一張圖片。

接下來就是配置的結(jié)果類型result，該元素的默認(rèn)type屬性為dispather表示分發(fā)的意思，而我們此處的stream表示流的意思，它將返回給瀏覽器一個InputStream（被下載文件的入口）。其中它配置了inputName，該參數(shù)的值對應(yīng)于action中g(shù)etXXXX方法，當(dāng)接受到請求的時候，框架會通過該參數(shù)匹配調(diào)用action中的getXXXX方法，該方法會根據(jù)指定資源路徑返回該文件的入口InputStream，交給瀏覽器。

我們也看到contentType參數(shù)指定了該文件的類型，和互聯(lián)網(wǎng)MIME標(biāo)準(zhǔn)中的規(guī)定類型一致，例如：text/plain代表純文本，text/xml表示XML，image/gif代表GIF圖片，image/jpeg代表JPG圖片等。

contentDisposition參數(shù)表示被下載文件在保存時候的文件名，它有兩個屬性值。第一個屬性值可以是inline或者attachment，它指定瀏覽器是直接打開還是下載，filename指定了下載或者打開文件的名稱。下面看上述代碼的運行結(jié)果截圖：