jsp檔案上傳大多採用採用開源項目來簡化處理,這裡列出常用的兩個jar包的實現,並進行比較,說明他們的優缺點和應該注意的問題。
Commons FileUpload,可以在http://jakarta.apache.org/commons/fileupload/下載,這個包需要Commons IO的支援,可以在http://jakarta.apache.org/commons/io/下載
com.oreilly.servlet,可以在http://www.servlets.com/cos/下載
Commons FileUpload提供三種檔案上傳處理方式,DiskFileUpload、ServletFileUpload和PortletFileUpload三種方式,其中DiskFileUpload已經在javadoc下已經被標記為到期的方法,建議用ServletFileUpload代替,而PortletFileUpload需要配合portlet-api來使用,所以這裡我們只介紹ServletFileUpload,並且這個也是最常用的。
com.oreilly.servlet也提供了三種檔案上傳的處理方式,MultipartWrapper、MultipartRequest和MultipartParser三種方式,其中MultipartWrapper和MultipartRequest的用法基本相同,並且沒有MultipartRequest提供的操作多,所以這裡介紹MultipartRequest,MultipartParser和前兩者有些不同,可以用來處理某些特殊情況,例如表單中有兩個同名的檔案上傳選擇框。
我們暫時稱三面三種檔案上傳方式分別為:ServletFileUpload方式(MultipartTestServlet)、MultipartRequest方式(MultipartTestServlet2)、MultipartParser方式(MultipartTestServlet3)
代碼如下:
test
MultipartTestServlet.java
package com.bug.servlet;
import java.io.File;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileUpload;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.RequestContext;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
import org.apache.commons.fileupload.servlet.ServletRequestContext;
public class MultipartTestServlet extends HttpServlet {
public MultipartTestServlet() {
super();
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
request.setCharacterEncoding("gbk");
RequestContext requestContext = new ServletRequestContext(request);
if(FileUpload.isMultipartContent(requestContext)){
DiskFileItemFactory factory = new DiskFileItemFactory();
factory.setRepository(new File("c:/tmp/"));
ServletFileUpload upload = new ServletFileUpload(factory);
//upload.setHeaderEncoding("gbk");
upload.setSizeMax(2000000);
List items = new ArrayList();
try {
items = upload.parseRequest(request);
} catch (FileUploadException e1) {
System.out.println("檔案上傳發生錯誤" + e1.getMessage());
}
Iterator it = items.iterator();
while(it.hasNext()){
FileItem fileItem = (FileItem) it.next();
if(fileItem.isFormField()){
System.out.println(fileItem.getFieldName() + " " + fileItem.getName() + " " + new String(fileItem.getString().getBytes("iso8859-1"), "gbk"));
}else{
System.out.println(fileItem.getFieldName() + " " +
fileItem.getName() + " " +
fileItem.isInMemory() + " " +
fileItem.getContentType() + " " +
fileItem.getSize());
if(fileItem.getName()!=null && fileItem.getSize()!=0){
File fullFile = new File(fileItem.getName());
File newFile = new File("c:/temp/" + fullFile.getName());
try {
fileItem.write(newFile);
} catch (Exception e) {
e.printStackTrace();
}
}else{
System.out.println("檔案沒有選擇 或 檔案內容為空白");
}
}
}
}
}
}
MultipartTestServlet2.java
package com.bug.servlet;
import java.io.IOException;
import java.util.Enumeration;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import com.oreilly.servlet.MultipartRequest;
import com.oreilly.servlet.multipart.DefaultFileRenamePolicy;
public class MultipartTestServlet2 extends HttpServlet {
public MultipartTestServlet2() {
super();
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
//request.setCharacterEncoding("gbk"); 不起作用
System.out.println("start ");
MultipartRequest multi = new MultipartRequest(request, "c:/tmp/", 2*1024*1024, "gbk", new DefaultFileRenamePolicy());
System.out.println("start ");
Enumeration filesName = multi.getFileNames();
Enumeration paramsName = multi.getParameterNames();
while(paramsName.hasMoreElements()){
String paramName = (String) paramsName.nextElement();
System.out.println(multi.getParameter(paramName));
}
while(filesName.hasMoreElements()){
String fileName = (String) filesName.nextElement();
System.out.println(multi.getFilesystemName(fileName) + " " +
multi.getOriginalFileName(fileName) + " " +
multi.getContentType(fileName) + " ");
if(multi.getFilesystemName(fileName)!=null && !multi.getFilesystemName(fileName).equals(""))
System.out.println(multi.getFile(fileName).toURI());
}
}
}
MultipartTestServlet3.java
package com.bug.servlet;
import java.io.File;
import java.io.IOException;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import com.oreilly.servlet.multipart.FilePart;
import com.oreilly.servlet.multipart.MultipartParser;
import com.oreilly.servlet.multipart.ParamPart;
import com.oreilly.servlet.multipart.Part;
public class MultipartTestServlet3 extends HttpServlet {
public MultipartTestServlet3() {
super();
}
public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
MultipartParser mp = new MultipartParser(request, 2*1024*1024, false, false, "gbk");
Part part;
while ((part = mp.readNextPart()) != null) {
String name = part.getName();
if (part.isParam()) {
ParamPart paramPart = (ParamPart) part;
String value = paramPart.getStringValue();
System.out.println("param: name=" + name + "; value=" + value);
}
else if (part.isFile()) {
// it's a file part
FilePart filePart = (FilePart) part;
String fileName = filePart.getFileName();
if (fileName != null) {
long size = filePart.writeTo(new File("c:/tmp/"));
System.out.println("file: name=" + name + "; fileName=" + fileName +
", filePath=" + filePart.getFilePath() +
", contentType=" + filePart.getContentType() +
", size=" + size);
}
else {
System.out.println("file: name=" + name + "; EMPTY");
}
System.out.flush();
}
}
}
}
web.xml中加入
MultipartTestServlet
com.bug.servlet.MultipartTestServlet
MultipartTestServlet2
com.bug.servlet.MultipartTestServlet2
MultipartTestServlet3
com.bug.servlet.MultipartTestServlet3
MultipartTestServlet
/MultipartTestServlet
MultipartTestServlet2
/MultipartTestServlet2
MultipartTestServlet3
/MultipartTestServlet3
問題1、中文問題:
三種凡是都可以通過自己的方法來設定encoding為gbk開處理和解決中文問題,包括初始化的時候傳入gbk作為參數,或是是初始化後通過setEncoding的方式來實現。
另外ServletFileUpload方式也可以通過request.setCharacterEncoding("gbk");的方式來實現,而其它兩種方式不支援這種方式。
問題2、檔案大小限制
ServletFileUpload方式可以設定檔案大小限制,也可以不用設定,例子中的upload.setSizeMax(2000000)就可以注釋掉。如果設定upload.setSizeMax(-1),表明不限制上傳的大小。文檔中沒有指明預設的限制的多少,我在不設定的情況下上傳了一個9M的東西,可以上傳,估計預設是不限制大小的。
而MultipartRequest方式和MultipartParser方式是必須設定檔案的上傳檔案的大小限制的,如果不設定,預設是1M的大小限制。
問題3、檔案上傳發生錯誤
如果檔案上傳過程中發生任何錯誤,或者是檔案的大小超出了範圍,系統都將拋出錯誤。
ServletFileUpload方式在upload.parseRequest(request)時拋出錯誤
MultipartRequest方式在new MultipartRequest(。。。)時拋出錯誤
MultipartParser方式在new MultipartParser(。。。)時拋出錯誤
問題4、上傳同名檔案時,他們儲存到臨時目錄是的衝突問題
ServletFileUpload方式,不會有衝突,系統會把上傳得檔案按照一定的規則重新命名,保證不會衝突
MultipartParser方式,會產生衝突,系統會把檔案按照上傳時的檔案名稱,儲存到臨時目錄下,如果兩個用會同時上傳檔案名稱相同的檔案,那麼就可能會產生衝突,一方把另一方的臨時檔案給替換了。
MultipartRequest方式,在初始化時如果提供了一個名稱轉換策略,就不會有衝突,如果不提桶,就會有衝突。在上面的例子中我們提供了一個new DefaultFileRenamePolicy()保證了檔案名稱不會有衝突發生。
問題5:表單中有兩個同名的檔案上傳選擇框,就像我們例子中的myfile一樣,每個表單中有兩個name=“myfile”的上傳框
ServletFileUpload方式,可以處理,可以分別得到他們各自的檔案,
MultipartRequest方式,不可以處理,會發生衝突,會有一個上傳框的檔案覆蓋了另外一個。
MultipartParser方式,可以處理,可以分別得到他們各自的檔案,
備忘:
代碼比較亂,主要是為了說明他們間的區別。他們的詳細地使用說明還是要參考他的javadoc和domo