Struts2文件的上傳和下載
++YONG原創，轉載請註明
1. 文件上傳的原理：
表單元素的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/)。利用這兩個框架都能很方便的實現文件的上傳。
2. 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中增加相應上傳組件的類庫。
2.1. 步驟一：創建帶上傳表單域的頁面
|
<%@ page language="java" contentType="text/html; charset=UTF-8"%>
<html>
<head>
<title>Struts2 File Upload</title>
</head>
<body>
<form action="fileUpload.action" method="POST" enctype="multipart/form-data">
文件標題：<input type="text" name="title" size="50"/><br/>
選擇文件：<input type="file" name="upload" size="50"/><br/>
<input type="submit" value=" 上傳 "/>
</form>
</body>
</html>
|
此頁面特殊之處只是把表單的enctype屬性設置爲multipart/form-data。
2.2. 步驟二：創建處理上傳請求的Action類
|
package org.qiujy.web.struts2;
import java.io.BufferedInputStream;
import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.InputStream;
import java.io.OutputStream;
import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionSupport;
/**
*處理文件上傳的Action類
*@authorqiujy
*@version1.0
*/
publicclass FileUploadAction extends ActionSupport {
privatestaticfinalintBUFFER_SIZE = 16 * 1024;
// 文件標題
private String title;
// 上傳文件域對象
private File upload;
// 上傳文件名
private String uploadFileName;
// 上傳文件類型
private String uploadContentType;
// 保存文件的目錄路徑(通過依賴注入)
private String savePath;
//以下省略getter和setter......
//自己封裝的一個把源文件對象複製成目標文件對象
privatestaticvoid copy(File src, File dst) {
InputStream in = null;
OutputStream out = null;
try {
in = new BufferedInputStream(new FileInputStream(src), BUFFER_SIZE);
out = new BufferedOutputStream(new FileOutputStream(dst),
BUFFER_SIZE);
byte[] buffer = newbyte[BUFFER_SIZE];
int len = 0;
while ((len = in.read(buffer)) > 0) {
out.write(buffer, 0, len);
}
} catch (Exception e) {
e.printStackTrace();
} finally {
if (null != in) {
try {
in.close();
} catch (IOException e) {
e.printStackTrace();
}
}
if (null != out) {
try {
out.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
}
@Override
public String execute() throws Exception {
//根據服務器的文件保存地址和原文件名創建目錄文件全路徑
String dstPath = ServletActionContext.getServletContext()
.getRealPath(this.getSavePath())
+ "\\" + this.getUploadFileName();
System.out.println("上傳的文件的類型："+ this.getUploadContentType());
File dstFile = new File(dstPath);
copy(this.upload, dstFile);
returnSUCCESS;
}
}
|
上面這個Action類中，提供了title和upload兩個屬性來分別對應頁面的兩個表單域屬性，用來封裝表單域的請求參數。
但是，值得注意的是，此Action中還有兩個屬性：uploadFileName和uploadContentType，這兩個屬性分別用於封裝上傳文件的文件名、文件類型。這是Struts2設計的獨到之處：Strut2的Action類直接通過File類型屬性直接封裝了上傳文件的文件內容，但這個File屬性無法獲取上傳文件的文件名和文件類型，所以Struts2就直接將文件域中包含的上傳文件名和文件類型的信息封裝到uploadFileName和uploadContentType屬性中，也就是說Struts2針對表單中名爲xxx的文件域，在對應的Action類中使用3個屬性來封裝該文件域信息：
l 類型爲File的xxx屬性：用來封裝頁面文件域對應的文件內容。
l 類型爲String的xxxFileName屬性：用來封裝該文件域對應的文件的文件名。
l 類型爲String的xxxContentType屬性：用來封裝該文件域應用的文件的文件類型。
另外，在這個Action類中還有一個savePath屬性，它的值是通過配置文件來動態設置的，這也是Strut2設計中的一個依賴注入特性的使用。
2.3. 步驟三：配置
struts.xml文件：
|
<!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 ="org.qiujy.web.struts2.FileUploadAction">
<!-- 動態設置Action中的savePath屬性的值 -->
<param name="savePath">/upload</param>
<result name ="success">/showupload.jsp</result>
</action >
</package >
</struts>
|
在這個文件中跟以前配置唯一不同的是給action配置了一個<param …/>元素，用來爲該Action的savePath屬性動態注入值。
web.xml中的配置跟以前的應用一樣。說明一點：好多網絡文章說Struts2上傳時要在web.xml中配置一個名爲ActionContextUp的過濾器，說是有一些莫名的錯誤，可是是我用了Struts2新版本2.0.9GA版，測了n次，沒出現什麼問題，所以沒配置。
2.4. 運行調試：
運行前要在根目錄下創建一個名爲upload的文件夾，用來存放上傳後的文件。
上傳結果：
3. 文件類型及錯誤輸出：
Struts2提供了一個文件上傳的攔截器(名爲fileUpload)，通過配置這個攔截器能輕鬆地實現文件類型的過濾。
在上例中，若要配置上傳的文件只能是一些普通的圖片文件格式：image/bmp、image/png、image/gif、image/jpeg、image/jpg等，則可在struts.xml文件中按如下方式配置：
|
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<constant name="struts.custom.i18n.resources" value="messages"/>
<package name="fileUploadDemo" extends="struts-default">
<action name="fileUpload"
class="org.qiujy.web.struts2.FileUploadAction">
<interceptor-ref name="fileUpload">
<!-- 配置允許上傳的文件類型，多個用","分隔 -->
<param name="allowedTypes">
image/bmp,image/png,image/gif,image/jpeg,image/jpg
,image/x-png, image/pjpeg<o:p></o:p> </param>
<!-- 配置允許上傳的文件大小，單位字節 -->
<param name="maximumSize">102400</param>
</interceptor-ref>
<interceptor-ref name="defaultStack" />
<!-- 動態設置Action中的savePath屬性的值 -->
<param name="savePath">/upload</param>
<result name="input">/index.jsp</result>
<result name="success">/showupload.jsp</result>
</action>
</package>
</struts>
|
如果上傳文件失敗，系統返回到input對應的頁面，要在input對應的頁面輸出文件過濾失敗信息，可以在input對應的頁面中增加 <s:fielderror/>來顯示錯誤信息。
運行調試：
結果：
顯然，這樣的提示不太友好，應用使用國際化信息。在國際化資源文件中添加如下三句：
|
#更改上傳文件類型不允許的提示信息
struts.messages.error.content.type.not.allowed=文件上傳失敗：你要上傳的文件類型不允許
#更改上傳文件太大的提示信息
struts.messages.error.file.too.large=文件上傳失敗：你要上傳的文件太大
# |