?
?

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.html

?

<% @?page?language = " java " ?import = " java.util.* " ?contentType = " text/html;charset=gbk " ?pageEncoding = " gbk " %>
< html >
< body >
< form? action ="MultipartTestServlet" ?enctype ="multipart/form-data" ?method ="post" >
< input? type ="text" ?name ="username" ? />< br? />
< input? type ="file" ?name ="myfile" ? />< br />
< input? type ="file" ?name ="myfile" ? />< br />
< input? type ="submit" ? />
</ form >
< br />< br />< br />< br />
< form? action ="MultipartTestServlet2" ?enctype ="multipart/form-data" ?method ="post" >
< input? type ="text" ?name ="username" ? />< br? />
< input? type ="file" ?name ="myfile" ? />< br />
< input? type ="file" ?name ="myfile" ? />< br />
< input? type ="submit" ? />
</ form >
< br />< br />< br />< br />
< form? action ="MultipartTestServlet3" ?enctype ="multipart/form-data" ?method ="post" >
< input? type ="text" ?name ="username" ? />< br? />
< input? type ="file" ?name ="myfile" ? />< br />
< input? type ="file" ?name ="myfile" ? />< br />
< input? type ="submit" ? />
</ form >
</ body >
</ html >

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中加入

< servlet >
< servlet-name > MultipartTestServlet </ servlet-name >
< servlet-class > com.bug.servlet.MultipartTestServlet </ servlet-class >
</ servlet >
< servlet >
< servlet-name > MultipartTestServlet2 </ servlet-name >
< servlet-class > com.bug.servlet.MultipartTestServlet2 </ servlet-class >
</ servlet >
< servlet >
< servlet-name > MultipartTestServlet3 </ servlet-name >
< servlet-class > com.bug.servlet.MultipartTestServlet3 </ servlet-class >
</ servlet >
< servlet-mapping >
< servlet-name > MultipartTestServlet </ servlet-name >
< url-pattern > /MultipartTestServlet </ url-pattern >
</ servlet-mapping >
< servlet-mapping >
< servlet-name > MultipartTestServlet2 </ servlet-name >
< url-pattern > /MultipartTestServlet2 </ url-pattern >
</ servlet-mapping >
< servlet-mapping >
< servlet-name > MultipartTestServlet3 </ servlet-name >
< url-pattern > /MultipartTestServlet3 </ url-pattern >
</ servlet-mapping >

問題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。

參考：
1、http://www.servlets.com/cos/#classes
2、http://jakarta.apache.org/commons/fileupload/apidocs/index.html
3、http://jakarta.apache.org/commons/fileupload/using.html
4、http://www.onjava.com/pub/a/onjava/2003/06/25/commons.html?page=3