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>
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中還有兩個屬性: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>
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
- </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>
運行調試:
結果:
顯然,這樣的提示不太友好,應用使用國際化信息。在國際化資源文件中添加如下三句:
#更改上傳文件類型不允許的提示信息
struts.messages.error.content.type.not.allowed=文件上傳失敗:你要上傳的文件類型不允許
#更改上傳文件太大的提示信息
struts.messages.error.file.too.large=文件上傳失敗:你要上傳的文件太大
#文件上傳其它錯誤信息
struts.messages.error.uploading=文件上傳失敗:發生內部錯誤
別忘了要用native2ascii.exe進行編碼轉換哦。再運行調試:
另外,在控制檯會看到一條消息:
Unable to find 'struts.multipart.saveDir' property setting. Defaulting to javax.servlet.context.tempdir
Removing file upload D:\tomcat6.0.13\work\Catalina\localhost\fileload_struts2\upload__4b616fd1_115a3d5d9dc__7fff_00000005.tmp
第一個說是找不以struts.multipart.saveDir,即沒有指定臨時文件夾,這個很好解決,只需指定一個struts.multipart.saveDir常量值爲某個目錄來解決。第二個說正在刪除一個臨時文件,這個臨時文件是上傳過程中產生的,屬正常。
4. 多文件上傳:
Struts2也可以很方便地實現多文件上傳。
在輸入表單域增加多個文件域:multifileupload.jsp
- <%@ page language="java" contentType="text/html; charset=UTF-8"%>
- <%@ taglib uri="/struts-tags" prefix="s" %>
- <html>
- <head>
- <title>多文件上傳</title>
- </head>
- <body>
- <font color="red"><s:fielderror/></font>
- <form action="multiFileUpload.action" method="POST" enctype="multipart/form-data">
- 文件標題:<input type="text" name="title" size="50" value="${param.title }"/><br/>
- <!-- 設置二個文件域,名字相同 -->
- 選擇第一個文件:<input type="file" name="upload" size="50"/><br/>
- 選擇第二個文件:<input type="file" name="upload" size="50"/><br/>
- <input type="submit" value=" 上傳 "/>
- </form>
- </body>
- </html>
- 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.IOException;
- import java.io.InputStream;
- import java.io.OutputStream;
- import org.apache.struts2.ServletActionContext;
- import com.opensymphony.xwork2.ActionSupport;
- /**
- *處理多文件上傳的Action類
- *
- *@authorqiujy
- *@version1.0
- */
- publicclass MultiFileUploadAction extends ActionSupport {
- privatestaticfinalintBUFFER_SIZE = 16 * 1024;
- // 文件標題
- private String title;
- // 用File數組來封裝多個上傳文件域對象
- private File[] upload;
- // 用String數組來封裝多個上傳文件名
- private String[] uploadFileName;
- // 用String數組來封裝多個上傳文件類型
- 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 {
- File[] srcFiles = this.getUpload();
- // 處理每個要上傳的文件
- for (int i = 0; i < srcFiles.length; i++) {
- // 根據服務器的文件保存地址和原文件名創建目錄文件全路徑
- String dstPath = ServletActionContext.getServletContext()
- .getRealPath(this.getSavePath())
- + "\\" + this.getUploadFileName()[i];
- File dstFile = new File(dstPath);
- this.copy(srcFiles[i], dstFile);
- }
- returnSUCCESS;
- }
- }
5. Struts2的文件下載:
文件下載相對簡單一些,一般只需在頁面上提供一個超鏈接,該鏈接的href屬性等於要下載文件的文件名就行了。但當文件名有中文時,就會導致失敗;或者要在用戶下載前進行權限判斷,這時用Struts2提供的文件下載功能就能簡單的解決這些問題。
common-fileupload是jakarta項目組開發的一個功能很強大的上傳文件組件
下面先介紹上傳文件到服務器(多文件上傳):
import javax.servlet.*;
import javax.servlet.http.*;
import java.io.*;
import java.util.*;
import java.util.regex.*;
import org.apache.commons.fileupload.*;
public class upload extends HttpServlet {
private static final String CONTENT_TYPE = "text/html; charset=GB2312";
//Process the HTTP Post request
public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.setContentType(CONTENT_TYPE);
PrintWriter out=response.getWriter();
try {
DiskFileUpload fu = new DiskFileUpload();
// 設置允許用戶上傳文件大小,單位:字節,這裏設爲2m
fu.setSizeMax(2*1024*1024);
// 設置最多隻允許在內存中存儲的數據,單位:字節
fu.setSizeThreshold(4096);
// 設置一旦文件大小超過getSizeThreshold()的值時數據存放在硬盤的目錄
fu.setRepositoryPath("c://windows//temp");
//開始讀取上傳信息
List fileItems = fu.parseRequest(request);
// 依次處理每個上傳的文件
Iterator iter = fileItems.iterator();
//正則匹配,過濾路徑取文件名
String regExp=".+////(.+)$";
//過濾掉的文件類型
String[] errorType={".exe",".com",".cgi",".asp"};
Pattern p = Pattern.compile(regExp);
while (iter.hasNext()) {
FileItem item = (FileItem)iter.next();
//忽略其他不是文件域的所有表單信息
if (!item.isFormField()) {
String name = item.getName();
long size = item.getSize();
if((name==null||name.equals("")) && size==0)
continue;
Matcher m = p.matcher(name);
boolean result = m.find();
if (result){
for (int temp=0;temp<ERRORTYPE.LENGTH;TEMP++){
if (m.group(1).endsWith(errorType[temp])){
throw new IOException(name+": wrong type");
}
}
try{
//保存上傳的文件到指定的目錄
//在下文中上傳文件至數據庫時,將對這裏改寫
item.write(new File("d://" + m.group(1)));
out.print(name+" "+size+"");
}
catch(Exception e){
out.println(e);
}
}
else
{
throw new IOException("fail to upload");
}
}
}
}
catch (IOException e){
out.println(e);
}
catch (FileUploadException e){
out.println(e);
}
}
}
現在介紹上傳文件到服務器,下面只寫出相關代碼:
以sql2000爲例,表結構如下:
字段名:name filecode
類型: varchar image
數據庫插入代碼爲:PreparedStatement pstmt=conn.prepareStatement("insert into test values(?,?)");
代碼如下:
。。。。。。
try{
這段代碼如果不去掉,將一同寫入到服務器中
//item.write(new File("d://" + m.group(1)));
int byteread=0;
//讀取輸入流,也就是上傳的文件內容
InputStream inStream=item.getInputStream();
pstmt.setString(1,m.group(1));
pstmt.setBinaryStream(2,inStream,(int)size);
pstmt.executeUpdate();
inStream.close();
out.println(name+" "+size+" ");
}
。。。。。。
這樣就實現了上傳文件至數據庫
String realpath = ServletActionContext.getServletContext().getRealPath("/upload") ;//獲取服務器路徑
String[] targetFileName = uploadFileName;
for (int i = 0; i < upload.length; i++) {
File target = new File(realpath, targetFileName[i]);
FileUtils.copyFile(upload[i], target);
//這是一個文件複製類copyFile()裏面就是IO操作,如果你不用這個類也可以自己寫一個IO複製文件的類
}
其中private File[] upload;// 實際上傳文件
private String[] uploadContentType; // 文件的內容類型
private String[] uploadFileName; // 上傳文件名
這三個參數必須這樣命名,因爲文件上傳控件默認是封裝了這3個參數的,且在action裏面他們應有get,set方法
public static synchronized void upload(HttpServletRequest request) {
path = request.getRealPath(request.getContextPath());
try {
DefaultFileItemFactory factory = new DefaultFileItemFactory();
DiskFileUpload up = new DiskFileUpload(factory);
List<FileItem> ls = up.parseRequest(request);
for (FileItem fileItem : ls) {
if (fileItem.isFormField()) {
String FieldName = fileItem.getFieldName();
// getName()返回的是文件名字 普通域沒有文件 返回NULL
// String Name = fileItem.getName();
String Content = fileItem.getString("utf-8");
request.setAttribute(FieldName, Content);
} else {
String nm = fileItem.getName().substring(
fileItem.getName().lastIndexOf("\\") + 1);
File mkr = new File(path, nm);
if (mkr.createNewFile()) {
path = path + File.separator + nm;
fileItem.write(mkr);// 非常方便的方法
}
}
}
} catch (Exception e) {
e.printStackTrace();
}
}