摘要：本文介紹了JavaBean實(shí)現(xiàn)多個(gè)文件上傳的兩種方法，分別是使用http協(xié)議和ftp協(xié)議實(shí)現(xiàn)。首先講述了http協(xié)議傳送多個(gè)文件的基本格式和實(shí)現(xiàn)上傳的詳細(xì)過(guò)程，之后簡(jiǎn)單介紹了使用ftpclient 類(lèi)實(shí)現(xiàn)了ftp方式的上傳，最后對(duì)這兩種方法進(jìn)行了比較。
關(guān)鍵字：JavaBean 、http 、ftp 、ftpclient
JavaBean是一種基于Java的軟件組件。JSP對(duì)于在Web 應(yīng)用中集成JavaBean組件提供了完善的支持。這種支持不僅能縮短開(kāi)發(fā)時(shí)間（可以直接利用經(jīng)測(cè)試和可信任的已有組件，避免了重復(fù)開(kāi)發(fā)），也為JSP應(yīng)用帶來(lái)了更多的可伸縮性。
文件的上傳功能在基于B/S的開(kāi)發(fā)模式中非常普遍。同其他開(kāi)發(fā)工具相比較，JSP對(duì)文件的上傳支持并不是很完美，它既不象ASP那樣一定需要使用組件來(lái)完成，也不像PHP那樣直接提供了文件上載的支持。JSP實(shí)現(xiàn)文件上傳的實(shí)現(xiàn)方式是這樣的：使用ServletRequest類(lèi)的getInputStream()方法獲得一個(gè)客戶端向服務(wù)器發(fā)出的數(shù)據(jù)流，然后處理這個(gè)數(shù)據(jù)流，從中分析、得到文件上傳中傳遞到服務(wù)器的各個(gè)參數(shù)和數(shù)據(jù)，然后將其中的文件數(shù)據(jù)存儲(chǔ)為一個(gè)文件或插入到數(shù)據(jù)庫(kù)中。通常JSP頁(yè)面中不處理文件的上傳功能，而是把這些功能放到Servlet 或JavaBean中去實(shí)現(xiàn)。使用Servlet完成文件上傳的例子在一些JSP的相關(guān)書(shū)籍中都有所介紹，我這里介紹使用JeanBean是如何完成文件上傳的。JSP中實(shí)現(xiàn)文件的上傳可以采用兩種方式即采用HTTP協(xié)議和FTP協(xié)議實(shí)現(xiàn)，二者在傳輸?shù)脑砩洗嬖诤艽蟮牟町悺Ｒ韵聦⒔Y(jié)合源代碼對(duì)它們的實(shí)現(xiàn)做簡(jiǎn)單介紹，相信讀者會(huì)從中有所收獲。以下程序已經(jīng)調(diào)試通過(guò)。調(diào)試的環(huán)境：window 2000 server+Apache +tomcat4.0，JavaBean調(diào)試環(huán)境：JDK1.4+Editplus。
在JSP中使用JavaBean實(shí)現(xiàn)基于Web的文件上傳功能一般需要三種文件結(jié)合完成。這三種文件分別是提供界面的HTML頁(yè)面文件、完成調(diào)用實(shí)現(xiàn)上傳功能的JavaBean的JSP文件和實(shí)現(xiàn)JavaBean的Java的類(lèi)文件。以下我將重點(diǎn)講述采用HTTP協(xié)議和FTP協(xié)議實(shí)現(xiàn)文件上傳功能的JavaBean部分。
1 采用HTTP協(xié)議實(shí)現(xiàn)多個(gè)文件的上傳
在過(guò)去的Html中，表單不能實(shí)現(xiàn)文件的上傳，這多少限制了一些網(wǎng)頁(yè)的功能。RFC1867規(guī)范（即Html中實(shí)現(xiàn)基于表單的文件上傳）對(duì)表單作出了擴(kuò)展，增加了一個(gè)表單元素〈input type＝file>。通過(guò)使用這個(gè)元素，瀏覽器會(huì)自動(dòng)生成一個(gè)輸入框和一個(gè)按鈕，輸入框可供用戶填寫(xiě)本地的文件名和路徑名，按鈕可以讓瀏覽器打開(kāi)一個(gè)文件選擇框供用戶選擇文件。具體的表單實(shí)現(xiàn)如下：
當(dāng)選擇了粘貼文件后就直接輸入本地文件的絕對(duì)路徑，表單的action屬性值是*.jsp，這意味著請(qǐng)求（包括上載的文件）將發(fā)送給*..jsp文件。在這個(gè)過(guò)程中實(shí)際上就實(shí)現(xiàn)了HTTP方式的文件上載。文件從客戶端到服務(wù)器的上載是由HTTP協(xié)議的通用網(wǎng)關(guān)界面(CGI)支持的。這種上載方式要求瀏覽器和WEBServer兩方面都能夠支持Rfc1867。JavaBean 通過(guò)ServletRequest類(lèi)的getInputStream()方法獲得一個(gè)客戶端向服務(wù)器發(fā)出的數(shù)據(jù)流、分析上傳的文件格式，根據(jù)分析結(jié)果將多個(gè)文件依次輸出服務(wù)器端的目標(biāo)文件中。本例中的JavaBeande的功能是由testUpload類(lèi)具體實(shí)現(xiàn)。TestUpload類(lèi)的框架如下：
public class testUpload
{
public testUpload(){……}
public final void initialize(ServletConfig config) throws ServletException
{ m_application = config.getServletContext(); }
public void upload() throws testUploadException, IOException, ServletException
{………}
private void getDataSection(){………}
private void getDataHeader(){………}
public int save (String destPathName)
throws SmartUploadException, IOException, ServletException
{………}
……
}
通過(guò)initialize（）方法初始化Servlet的運(yùn)行環(huán)境。使用upload()方法獲得輸入流，并分析上傳文件的格式，并將各個(gè)上傳文件的屬性賦給多個(gè)File類(lèi)實(shí)例處理，這些File類(lèi)實(shí)例由Files類(lèi)管理。File類(lèi)根據(jù)各文件的屬性調(diào)用它的save ()方法將多個(gè)文件依次輸出服務(wù)器端的目標(biāo)文件中。其中upload()方法是關(guān)鍵，用于分析http1.1協(xié)議傳送文件的格式。經(jīng)過(guò)測(cè)試，我們得出傳輸流文件的格式，這對(duì)理解upload()方法很有用。例如，上傳我的文檔 t.txt文件。格式如下：
//文件分隔符
-----------------------------7d226137250336
//文件信息頭
Content-Disposition: form-data; name="FILE1"; filename="C:Documents and SettingsAdministrator.TIMBER-4O6B0ZZ0My Documents t.sql"
Content-Type: text/plain
//源文件內(nèi)容
create table info(
content image null);
//下一個(gè)文件的分隔符
-----------------------------7d226137250336
Content-Disposition: form-data; name="FILE2"; filename=""
Content-Type: application/octet-stream
-----------------------------7d226137250336
從以上文件我們可以看出，HTTP協(xié)議在上傳多個(gè)文件時(shí)，是將文件全部放到輸入流并以一定的分隔符來(lái)區(qū)分的。實(shí)際上upload()方法就是要分析上面的文件，確定分隔符的內(nèi)容、各個(gè)文件的內(nèi)容格式、文件的完整路徑名稱(chēng)、及其文件的實(shí)際數(shù)據(jù)的始末位置。這里需要說(shuō)明的一點(diǎn)是分隔符是隨機(jī)的，它是傳輸流文件的第一個(gè)回車(chē)符之前的所有字符。
Upload()方法的實(shí)現(xiàn)流程是：首先將輸入流文件輸出到字節(jié)數(shù)組m_binArray中，通過(guò)下面的代碼實(shí)現(xiàn)。
m_totalBytes=1024；totalRead=0；
for(; totalRead < m_totalBytes; totalRead += readBytes)
try
{ m_request.getInputStream();
readBytes = m_request.getInputStream().read(m_binArray, totalRead, m_totalBytes - totalRead);
}catch(Exception e){ throw new SmartUploadException("Unable to upload.");}
這里采用了循環(huán)中多字節(jié)讀取方法，以上循環(huán)不斷地讀取數(shù)據(jù)直到數(shù)組填滿為止。如果一個(gè)文件可以完全得到，則文件的所有字節(jié)也就可以全部得到。但是因?yàn)榫W(wǎng)絡(luò)速度通常比CPU慢得多，所以程序很容易在所有的數(shù)據(jù)到來(lái)之前就清空網(wǎng)絡(luò)緩沖區(qū)。實(shí)際上，多字節(jié)讀取方法在試圖從暫時(shí)為空但是開(kāi)放的網(wǎng)絡(luò)緩存區(qū)讀取數(shù)據(jù)時(shí)，該方法會(huì)返回0，這表示沒(méi)有數(shù)據(jù)存在但網(wǎng)絡(luò)流沒(méi)有關(guān)閉。這種情況下，單字節(jié)方法將阻止運(yùn)行程序的執(zhí)行，所以多字節(jié)的行為優(yōu)于單字節(jié)read()方法的行為。接下來(lái)將分析字節(jié)數(shù)組m_binArray。首先找到分隔符；使用getDataHeader()方法返回文件信息頭的值，從中確定源文件的完整路徑名、源文件的擴(kuò)展名和源文件文件內(nèi)容格式；使用getDataSection()方法返回文件的內(nèi)容數(shù)據(jù)，并記錄文件數(shù)據(jù)在字節(jié)數(shù)組中的起止位置。然后生成一個(gè)File類(lèi)實(shí)例，并將文件的完整路徑名、源文件的擴(kuò)展名、源文件文件內(nèi)容格式和文件的內(nèi)容數(shù)據(jù)的起止位置放到File類(lèi)實(shí)例的屬性中。找到下一個(gè)分隔符，繼續(xù)重復(fù)上述過(guò)程，直至分析完畢。
2 采用FTP協(xié)議實(shí)現(xiàn)多個(gè)文件的上傳
FTP協(xié)議是Internet上用來(lái)傳送文件的協(xié)議，規(guī)定了Internet上文件互相傳送的標(biāo)準(zhǔn)。在java中實(shí)現(xiàn)這一功能是借助FtpClient類(lèi)完成的。具體實(shí)現(xiàn)過(guò)程：首先與FTP服務(wù)器建立連接；初始化文件的傳輸方式，包括ASCII和BINARY兩種方式；將文件輸出到文件輸入流FileInputStream中；FileInputStream中的數(shù)據(jù)讀入字節(jié)數(shù)組中；字節(jié)數(shù)組中的數(shù)據(jù)寫(xiě)入輸出流TelnetOutputStream（利用write方法將數(shù)據(jù)寫(xiě)入到一個(gè)網(wǎng)絡(luò)鏈接上）。這樣和源文件同名的一個(gè)文件就復(fù)制到了服務(wù)器端。本例的JavaBean中通過(guò)connectServer()、upload()和closeConnect()三個(gè)方法完成文件上傳過(guò)程。主要實(shí)現(xiàn)如下：
public class ftpUpload
{ String filename;String filename1;FtpClient ftpClient;
public void connectServer(string server,string user,string password,string path)
{
//server：FTP服務(wù)器的IP地址；user:登錄FTP服務(wù)器的用戶名
//password：登錄FTP服務(wù)器的用戶名的口令；path：FTP服務(wù)器上的路徑
try{ ftpClient=new FtpClient();
ftpClient.openServer(server);
ftpClient.login(user, password);
System.out.println("login success!");
if (path.length()!=0) ftpClient.cd(path);
ftpClient.binary(); }catch (IOException ex) {System.out.println(ex);}
}
public void closeConnect()
{try{ ftpClient.closeServer();
}catch (IOException ex) {System.out.println(ex);}
}
public void upload()
{ filename1=findFileName(filename);
//從filename中分析出文件的名稱(chēng)，作為目標(biāo)文件的名稱(chēng),具體方法實(shí)現(xiàn)未給出
try {
TelnetOutputStream os=ftpClient.put(filename1);
java.io.File file_in=new java.io.File(filename);
FileInputStream is=new FileInputStream(file_in);
byte[] bytes=new byte[1024];
int c;
while ((c=is.read(bytes))!=-1){ os.write(bytes,0,c); }
is.close(); os.close();
} catch (IOException ex) {System.out.println(ex);}
}
}
connectServer()完成與FTP服務(wù)器建立連接的功能，使用FtpClient的openServer(string server)方法打開(kāi)遠(yuǎn)程FTP服務(wù)器,然后使用FtpClient的login(user, password)方法登錄服務(wù)器。登錄遠(yuǎn)程FTP服務(wù)器有兩種方式，一種是注冊(cè)用戶登錄，另一種是以匿名方式登錄。前者要求用戶首先注冊(cè)為服務(wù)器的客戶，服務(wù)器會(huì)給客戶一個(gè)登錄賬號(hào)和密碼，依據(jù)賬號(hào)和密碼連結(jié)到服務(wù)器上。后者要求用戶不用注冊(cè)而使用特殊的用戶名"annoymous"和"guest"有限制的訪問(wèn)遠(yuǎn)程主機(jī)的公開(kāi)文件，現(xiàn)在許多系統(tǒng)要求用戶將Email地址作為口令。出于安全的目的，大部分匿名FTP主機(jī)一般只允許遠(yuǎn)程用戶下載文件，而不允許上傳，這將依賴(lài)于FTP服務(wù)器的設(shè)置。用戶可根據(jù)實(shí)際情況選擇使用兩種方式。登錄完成后使用FtpClient的binary()方法初始化傳輸方式為字節(jié)方式。upload()完成文件的上傳功能。創(chuàng)建源文件的文件輸入流FileInputStream,將輸入流寫(xiě)入到字節(jié)數(shù)組中，利用TelnetOutputStream的write方法將字節(jié)數(shù)組中的數(shù)據(jù)寫(xiě)入到一個(gè)網(wǎng)絡(luò)鏈接上。由于TelnetOutputStream打開(kāi)的是FTP服務(wù)器上的一個(gè)文件，所以數(shù)據(jù)寫(xiě)入到了目標(biāo)文件中，這樣就完成了文件上傳。closeConnect()要求與服務(wù)器斷開(kāi)連接。
以上只是單個(gè)文件上傳的過(guò)程，如果是多個(gè)文件可以多次調(diào)用此上傳過(guò)程。由以上兩種方式我們可以看出采用FTP協(xié)議實(shí)現(xiàn)多個(gè)文件的上傳比較簡(jiǎn)單，容易實(shí)現(xiàn)。利用FTP協(xié)議上傳文件一般是編寫(xiě)的客戶端的程序，服務(wù)器端的安全設(shè)置會(huì)比較復(fù)雜；而利用HTTP協(xié)議上傳文件則是服務(wù)器端的應(yīng)用程序，相對(duì)來(lái)說(shuō)安全設(shè)置會(huì)比較簡(jiǎn)單。并且通過(guò)測(cè)試發(fā)現(xiàn)FTP上傳方式在傳輸大文件時(shí)速度是HTTP上傳方式的幾十倍甚至幾百倍，但在傳輸小于1M的文件時(shí)卻比HTTP上傳方式稍慢一些。所以說(shuō)兩種傳輸方式各有優(yōu)勢(shì)，請(qǐng)讀者根據(jù)自身情況量力而行。如果有什么問(wèn)題或者是需要其他部分的源碼，請(qǐng)與我聯(lián)系！
================================UPLOAD.HTML=======================================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>文件上傳</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body>
<p> </p>
<p align="center">上傳文件選擇</p>
<FORM METHOD="POST" ACTION="upload.jsp"
ENCTYPE="multipart/form-data">
<input type="hidden" name="TEST" value="good">
<table width="75%" border="1" align="center">
<tr>
<td><div align="center">1、
<input type="FILE" name="FILE1" size="30">
</div></td>
</tr>
<tr>
<td><div align="center">2、
<input type="FILE" name="FILE2" size="30">
</div></td>
</tr>
<tr>
<td><div align="center">3、
<input type="FILE" name="FILE3" size="30">
</div></td>
</tr>
<tr>
<td><div align="center">4、
<input type="FILE" name="FILE4" size="30">
</div></td>
</tr>
<tr>
<td><div align="center">
<input type="submit" name="Submit" value="上傳它！">
</div></td>
</tr>
</table>
</FORM>
</body>
</html>
================================END=======================================
================================upload.jsp================================
<%@ page contentType="text/html;charset=gb2312"%>
<%@ page import="com.jspsmart.upload.*"%>
<%@ page import="java.util.*"%>
<html>
<head>
<title>文件上傳處理頁(yè)面</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body>
<%
// 新建一個(gè)SmartUpload對(duì)象
SmartUpload su = new SmartUpload();
// 上傳初始化
su.initialize(pageContext);
// 設(shè)定上傳限制
// 1.限制每個(gè)上傳文件的最大長(zhǎng)度。
// su.setMaxFileSize(10000);
// 2.限制總上傳數(shù)據(jù)的長(zhǎng)度。
// su.setTotalMaxFileSize(20000);
// 3.設(shè)定允許上傳的文件（通過(guò)擴(kuò)展名限制）,僅允許doc,txt文件。
// su.setAllowedFilesList("doc,txt");
// 4.設(shè)定禁止上傳的文件（通過(guò)擴(kuò)展名限制）,禁止上傳帶有exe,bat,jsp,htm,html擴(kuò)展名的文件和沒(méi)有擴(kuò)展名的文件。
// su.setDeniedFilesList("exe,bat,jsp,htm,html,,");
// 上傳文件
su.upload();
// 將上傳文件全部保存到指定目錄
int count = su.save("/upload");
out.println(count+"個(gè)文件上傳成功！<br>");
// 利用Request對(duì)象獲取參數(shù)之值
out.println("TEST="+su.getRequest().getParameter("TEST")+"<BR><BR>");
// 逐一提取上傳文件信息，同時(shí)可保存文件。
for (int i=0;i<su.getFiles().getCount();i++)
{
com.jspsmart.upload.File file = su.getFiles().getFile(i);
// 若文件不存在則繼續(xù)
if (file.isMissing()) continue;
// 顯示當(dāng)前文件信息
out.println("<TABLE BORDER=1>");
out.println("<TR><TD>表單項(xiàng)名（FieldName）</TD><TD>"+ file.getFieldName() + "</TD></TR>");
out.println("<TR><TD>文件長(zhǎng)度（Size）</TD><TD>" + file.getSize() + "</TD></TR>");
out.println("<TR><TD>文件名（FileName）</TD><TD>" + file.getFileName() + "</TD></TR>");
out.println("<TR><TD>文件擴(kuò)展名（FileExt）</TD><TD>" + file.getFileExt() + "</TD></TR>");
out.println("<TR><TD>文件全名（FilePathName）</TD><TD>"+ file.getFilePathName() + "</TD></TR>");
out.println("</TABLE><BR>");
// 將文件另存
// file.saveAs("/upload/" + myFile.getFileName());
// 另存到以WEB應(yīng)用程序的根目錄為文件根目錄的目錄下
// file.saveAs("/upload/" + myFile.getFileName(), su.SAVE_VIRTUAL);
// 另存到操作系統(tǒng)的根目錄為文件根目錄的目錄下
// file.saveAs("c:\\temp\\" + myFile.getFileName(), su.SAVE_PHYSICAL);
}
%>
</body>
</html>
================================END=======================================
================================download.html=============================
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>下載</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body>
<a href="download.jsp">點(diǎn)擊下載</a>
</body>
</html>
================================END=======================================
================================download.jsp==============================
<%@ page contentType="text/html;charset=gb2312"%>
<%@ page import="com.jspsmart.upload.*"%>
<%
//新建一個(gè)SmartUpload對(duì)象
SmartUpload su=new SmartUpload();
// 初始化
su.initialize(pageContext);
// 設(shè)定contentDisposition為null以禁止瀏覽器自動(dòng)打開(kāi)文件，
//保證點(diǎn)擊鏈接后是下載文件。若不設(shè)定，則下載的文件擴(kuò)展名為
//doc時(shí)，瀏覽器將自動(dòng)用word打開(kāi)它。擴(kuò)展名為pdf時(shí)，
//瀏覽器將用acrobat打開(kāi)。
su.setContentDisposition(null);
// 下載文件
su.downloadFile("/upload/mobile.txt");
%>
================================END=======================================
一、安裝篇
jspSmartUpload是由www.jspsmart.com網(wǎng)站開(kāi)發(fā)的一個(gè)可免費(fèi)使用的全功能的文件上傳下載組件，適于嵌入執(zhí)行上傳下載操作的JSP文件中。該組件有以下幾個(gè)特點(diǎn)：
1、使用簡(jiǎn)單。在JSP文件中僅僅書(shū)寫(xiě)三五行JAVA代碼就可以搞定文件的上傳或下載，方便。
2、能全程控制上傳。利用jspSmartUpload組件提供的對(duì)象及其操作方法，可以獲得全部上傳文件的信息（包括文件名，大小，類(lèi)型，擴(kuò)展名，文件數(shù)據(jù)等），方便存取。
3、能對(duì)上傳的文件在大小、類(lèi)型等方面做出限制。如此可以濾掉不符合要求的文件。
4、下載靈活。僅寫(xiě)兩行代碼，就能把Web服務(wù)器變成文件服務(wù)器。不管文件在Web服務(wù)器的目錄下或在其它任何目錄下，都可以利用jspSmartUpload進(jìn)行下載。
5、能將文件上傳到數(shù)據(jù)庫(kù)中，也能將數(shù)據(jù)庫(kù)中的數(shù)據(jù)下載下來(lái)。這種功能針對(duì)的是MYSQL數(shù)據(jù)庫(kù)，因?yàn)椴痪哂型ㄓ眯裕员疚牟粶?zhǔn)備舉例介紹這種用法。
jspSmartUpload組件可以從www.jspsmart.com網(wǎng)站上自由下載，壓縮包的名字是jspSmartUpload.zip。下載后，用WinZip或WinRAR將其解壓到Tomcat的webapps目錄下（本文以Tomcat服務(wù)器為例進(jìn)行介紹）。解壓后，將webapps/jspsmartupload目錄下的子目錄Web-inf名字改為全大寫(xiě)的WEB-INF，這樣一改jspSmartUpload類(lèi)才能使用。因?yàn)門(mén)omcat對(duì)文件名大小寫(xiě)敏感，它要求Web應(yīng)用程序相關(guān)的類(lèi)所在目錄為WEB-INF，且必須是大寫(xiě)。接著重新啟動(dòng)Tomcat，這樣就可以在JSP文件中使用jspSmartUpload組件了。
注意，按上述方法安裝后，只有webapps/jspsmartupload目錄下的程序可以使用jspSmartUpload組件，如果想讓Tomcat服務(wù)器的所有Web應(yīng)用程序都能用它，必須做如下工作：
1．進(jìn)入命令行狀態(tài)，將目錄切換到Tomcat的webapps/jspsmartupload/WEB-INF目錄下。
2．運(yùn)行JAR打包命令：jar cvf jspSmartUpload.jar com
（也可以打開(kāi)資源管理器，切換到當(dāng)前目錄，用WinZip將com目錄下的所有文件壓縮成jspSmartUpload.zip，然后將jspSmartUpload.zip換名為jspSmartUpload.jar文件即可。）
3．將jspSmartUpload.jar拷貝到Tomcat的shared/lib目錄下。
二、相關(guān)類(lèi)說(shuō)明篇
㈠ File類(lèi)
這個(gè)類(lèi)包裝了一個(gè)上傳文件的所有信息。通過(guò)它，可以得到上傳文件的文件名、文件大小、擴(kuò)展名、文件數(shù)據(jù)等信息。
File類(lèi)主要提供以下方法：
1、saveAs作用：將文件換名另存。
原型：
public void saveAs(java.lang.String destFilePathName)
或
public void saveAs(java.lang.String destFilePathName, int optionSaveAs)
其中，destFilePathName是另存的文件名，optionSaveAs是另存的選項(xiàng)，該選項(xiàng)有三個(gè)值，分別是SAVEAS_PHYSICAL,SAVEAS_VIRTUAL，SAVEAS_AUTO。SAVEAS_PHYSICAL表明以操作系統(tǒng)的根目錄為文件根目錄另存文件，SAVEAS_VIRTUAL表明以Web應(yīng)用程序的根目錄為文件根目錄另存文件，SAVEAS_AUTO則表示讓組件決定，當(dāng)Web應(yīng)用程序的根目錄存在另存文件的目錄時(shí)，它會(huì)選擇SAVEAS_VIRTUAL，否則會(huì)選擇SAVEAS_PHYSICAL。
例如，saveAs("/upload/sample.zip",SAVEAS_PHYSICAL)執(zhí)行后若Web服務(wù)器安裝在C盤(pán)，則另存的文件名實(shí)際是c:\upload\sample.zip。而saveAs("/upload/sample.zip",SAVEAS_VIRTUAL)執(zhí)行后若Web應(yīng)用程序的根目錄是webapps/jspsmartupload，則另存的文件名實(shí)際是webapps/jspsmartupload/upload/sample.zip。saveAs("/upload/sample.zip",SAVEAS_AUTO)執(zhí)行時(shí)若Web應(yīng)用程序根目錄下存在upload目錄，則其效果同saveAs("/upload/sample.zip",SAVEAS_VIRTUAL)，否則同saveAs("/upload/sample.zip",SAVEAS_PHYSICAL)。
建議：對(duì)于Web程序的開(kāi)發(fā)來(lái)說(shuō)，最好使用SAVEAS_VIRTUAL，以便移植。
2、isMissing
作用：這個(gè)方法用于判斷用戶是否選擇了文件，也即對(duì)應(yīng)的表單項(xiàng)是否有值。選擇了文件時(shí)，它返回false。未選文件時(shí)，它返回true。
原型：public boolean isMissing()
3、getFieldName
作用：取HTML表單中對(duì)應(yīng)于此上傳文件的表單項(xiàng)的名字。
原型：public String getFieldName()
4、getFileName
作用：取文件名（不含目錄信息）
原型：public String getFileName()
5、getFilePathName
作用：取文件全名（帶目錄）
原型：public String getFilePathName
6、getFileExt
作用：取文件擴(kuò)展名（后綴）
原型：public String getFileExt()
7、getSize
作用：取文件長(zhǎng)度（以字節(jié)計(jì)）
原型：public int getSize()
8、getBinaryData
作用：取文件數(shù)據(jù)中指定位移處的一個(gè)字節(jié)，用于檢測(cè)文件等處理。
原型：public byte getBinaryData(int index)。其中，index表示位移，其值在0到getSize()-1之間。
㈡ Files類(lèi)
這個(gè)類(lèi)表示所有上傳文件的集合，通過(guò)它可以得到上傳文件的數(shù)目、大小等信息。有以下方法：
1、getCount
作用：取得上傳文件的數(shù)目。
原型：public int getCount()
2、getFile
作用：取得指定位移處的文件對(duì)象File（這是com.jspsmart.upload.File，不是java.io.File，注意區(qū)分）。
原型：public File getFile(int index)。其中，index為指定位移，其值在0到getCount()-1之間。
3、getSize
作用：取得上傳文件的總長(zhǎng)度，可用于限制一次性上傳的數(shù)據(jù)量大小。
原型：public long getSize()
4、getCollection
作用：將所有上傳文件對(duì)象以Collection的形式返回，以便其它應(yīng)用程序引用，瀏覽上傳文件信息。
原型：public Collection getCollection()
5、getEnumeration
作用：將所有上傳文件對(duì)象以Enumeration（枚舉）的形式返回，以便其它應(yīng)用程序?yàn)g覽上傳文件信息。
原型：public Enumeration getEnumeration()
㈢ Request類(lèi)
這個(gè)類(lèi)的功能等同于JSP內(nèi)置的對(duì)象request。只所以提供這個(gè)類(lèi)，是因?yàn)閷?duì)于文件上傳表單，通過(guò)request對(duì)象無(wú)法獲得表單項(xiàng)的值，必須通過(guò)jspSmartUpload組件提供的Request對(duì)象來(lái)獲取。該類(lèi)提供如下方法：
1、getParameter
作用：獲取指定參數(shù)之值。當(dāng)參數(shù)不存在時(shí)，返回值為null。
原型：public String getParameter(String name)。其中，name為參數(shù)的名字。
2、getParameterValues
作用：當(dāng)一個(gè)參數(shù)可以有多個(gè)值時(shí)，用此方法來(lái)取其值。它返回的是一個(gè)字符串?dāng)?shù)組。當(dāng)參數(shù)不存在時(shí)，返回值為null。
原型：public String[] getParameterValues(String name)。其中，name為參數(shù)的名字。
3、getParameterNames
作用：取得Request對(duì)象中所有參數(shù)的名字，用于遍歷所有參數(shù)。它返回的是一個(gè)枚舉型的對(duì)象。
原型：public Enumeration getParameterNames()
㈣ SmartUpload類(lèi)這個(gè)類(lèi)完成上傳下載工作。
A．上傳與下載共用的方法：
只有一個(gè)：initialize。
作用：執(zhí)行上傳下載的初始化工作，必須第一個(gè)執(zhí)行。
原型：有多個(gè)，主要使用下面這個(gè)：
public final void initialize(javax.servlet.jsp.PageContext pageContext)
其中，pageContext為JSP頁(yè)面內(nèi)置對(duì)象（頁(yè)面上下文）。
B．上傳文件使用的方法：
1、upload
作用：上傳文件數(shù)據(jù)。對(duì)于上傳操作，第一步執(zhí)行initialize方法，第二步就要執(zhí)行這個(gè)方法。
原型：public void upload()
2、save
作用：將全部上傳文件保存到指定目錄下，并返回保存的文件個(gè)數(shù)。
原型：public int save(String destPathName)
和public int save(String destPathName,int option)
其中，destPathName為文件保存目錄，option為保存選項(xiàng)，它有三個(gè)值，分別是SAVE_PHYSICAL,SAVE_VIRTUAL和SAVE_AUTO。（同F(xiàn)ile類(lèi)的saveAs方法的選項(xiàng)之值類(lèi)似）SAVE_PHYSICAL指示組件將文件保存到以操作系統(tǒng)根目錄為文件根目錄的目錄下，SAVE_VIRTUAL指示組件將文件保存到以Web應(yīng)用程序根目錄為文件根目錄的目錄下，而SAVE_AUTO則表示由組件自動(dòng)選擇。
注：save(destPathName)作用等同于save(destPathName,SAVE_AUTO)。
3、getSize
作用：取上傳文件數(shù)據(jù)的總長(zhǎng)度
原型：public int getSize()
4、getFiles
作用：取全部上傳文件，以Files對(duì)象形式返回，可以利用Files類(lèi)的操作方法來(lái)獲得上傳文件的數(shù)目等信息。
原型：public Files getFiles()
5、getRequest
作用：取得Request對(duì)象，以便由此對(duì)象獲得上傳表單參數(shù)之值。
原型：public Request getRequest()
6、setAllowedFilesList
作用：設(shè)定允許上傳帶有指定擴(kuò)展名的文件，當(dāng)上傳過(guò)程中有文件名不允許時(shí)，組件將拋出異常。
原型：public void setAllowedFilesList(String allowedFilesList)
其中，allowedFilesList為允許上傳的文件擴(kuò)展名列表，各個(gè)擴(kuò)展名之間以逗號(hào)分隔。如果想允許上傳那些沒(méi)有擴(kuò)展名的文件，可以用兩個(gè)逗號(hào)表示。例如：setAllowedFilesList("doc,txt,,")將允許上傳帶doc和txt擴(kuò)展名的文件以及沒(méi)有擴(kuò)展名的文件。
7、setDeniedFilesList
作用：用于限制上傳那些帶有指定擴(kuò)展名的文件。若有文件擴(kuò)展名被限制，則上傳時(shí)組件將拋出異常。
原型：public void setDeniedFilesList(String deniedFilesList)
其中，deniedFilesList為禁止上傳的文件擴(kuò)展名列表，各個(gè)擴(kuò)展名之間以逗號(hào)分隔。如果想禁止上傳那些沒(méi)有擴(kuò)展名的文件，可以用兩個(gè)逗號(hào)來(lái)表示。例如：setDeniedFilesList("exe,bat,,")將禁止上傳帶exe和bat擴(kuò)展名的文件以及沒(méi)有擴(kuò)展名的文件。
8、setMaxFileSize
作用：設(shè)定每個(gè)文件允許上傳的最大長(zhǎng)度。
原型：public void setMaxFileSize(long maxFileSize)
其中，maxFileSize為為每個(gè)文件允許上傳的最大長(zhǎng)度，當(dāng)文件超出此長(zhǎng)度時(shí)，將不被上傳。
9、setTotalMaxFileSize
作用：設(shè)定允許上傳的文件的總長(zhǎng)度，用于限制一次性上傳的數(shù)據(jù)量大小。
原型：public void setTotalMaxFileSize(long totalMaxFileSize)
其中，totalMaxFileSize為允許上傳的文件的總長(zhǎng)度。
1、setContentDisposition
作用：將數(shù)據(jù)追加到MIME文件頭的CONTENT-DISPOSITION域。jspSmartUpload組件會(huì)在返回下載的信息時(shí)自動(dòng)填寫(xiě)MIME文件頭的CONTENT-DISPOSITION域，如果用戶需要添加額外信息，請(qǐng)用此方法。
原型：public void setContentDisposition(String contentDisposition)
其中，contentDisposition為要添加的數(shù)據(jù)。如果contentDisposition為null，則組件將自動(dòng)添加"attachment;"，以表明將下載的文件作為附件，結(jié)果是IE瀏覽器將會(huì)提示另存文件，而不是自動(dòng)打開(kāi)這個(gè)文件（IE瀏覽器一般根據(jù)下載的文件擴(kuò)展名決定執(zhí)行什么操作，擴(kuò)展名為doc的將用word程序打開(kāi)，擴(kuò)展名為pdf的將用acrobat程序打開(kāi)，等等）。
2、downloadFile
作用：下載文件。
原型：共有以下三個(gè)原型可用，第一個(gè)最常用，后兩個(gè)用于特殊情況下的文件下載（如更改內(nèi)容類(lèi)型，更改另存的文件名）。
① public void downloadFile(String sourceFilePathName)
其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）
② public void downloadFile(String sourceFilePathName,String contentType)
其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）,contentType為內(nèi)容類(lèi)型（MIME格式的文件類(lèi)型信息，可被瀏覽器識(shí)別）。
③ public void downloadFile(String sourceFilePathName,String contentType,String destFileName)
其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）,contentType為內(nèi)容類(lèi)型（MIME格式的文件類(lèi)型信息，可被瀏覽器識(shí)別）,destFileName為下載后默認(rèn)的另存文件名。
三、文件上傳篇
㈠ 表單要求
對(duì)于上傳文件的FORM表單，有兩個(gè)要求：
1、METHOD應(yīng)用POST，即METHOD="POST"。
2、增加屬性：ENCTYPE="multipart/form-data"
下面是一個(gè)用于上傳文件的FORM表單的例子：
<FORM METHOD="POST" ENCTYPE="multipart/form-data"
ACTION="/jspSmartUpload/upload.jsp">
<INPUT TYPE="FILE" NAME="MYFILE">
<INPUT TYPE="SUBMIT">
</FORM>
㈡ 上傳的例子
1、上傳頁(yè)面upload.html
本頁(yè)面提供表單，讓用戶選擇要上傳的文件，點(diǎn)擊"上傳"按鈕執(zhí)行上傳操作。
頁(yè)面源碼如下：
<!--
文件名：upload.html
作 者：縱橫軟件制作中心雨亦奇(zhsoft88@sohu.com)
-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>文件上傳</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body>
<p> </p>
<p align="center">上傳文件選擇</p>
<FORM METHOD="POST" ACTION="jsp/do_upload.jsp"
ENCTYPE="multipart/form-data">
<input type="hidden" name="TEST" value="good">
<table width="75%" border="1" align="center">
<tr>
<td><div align="center">1、
<input type="FILE" name="FILE1" size="30">
</div></td>
</tr>
<tr>
<td><div align="center">2、
<input type="FILE" name="FILE2" size="30">
</div></td>
</tr>
<tr>
<td><div align="center">3、
<input type="FILE" name="FILE3" size="30">
</div></td>
</tr>
<tr>
<td><div align="center">4、
<input type="FILE" name="FILE4" size="30">
</div></td>
</tr>
<tr>
<td><div align="center">
<input type="submit" name="Submit" value="上傳它！">
</div></td>
</tr>
</table>
</FORM>
</body>
</html>
2、上傳處理頁(yè)面do_upload.jsp
本頁(yè)面執(zhí)行文件上傳操作。頁(yè)面源碼中詳細(xì)介紹了上傳方法的用法，在此不贅述了。
頁(yè)面源碼如下：
<%--
文件名：do_upload.jsp
作 者：縱橫軟件制作中心雨亦奇(zhsoft88@sohu.com)
--%>
<%@ page contentType="text/html; charset=gb2312" language="java"
import="java.util.*,com.jspsmart.upload.*" errorPage="" %>
<html>
<head>
<title>文件上傳處理頁(yè)面</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body>
<%
// 新建一個(gè)SmartUpload對(duì)象
SmartUpload su = new SmartUpload();
// 上傳初始化
su.initialize(pageContext);
// 設(shè)定上傳限制
// 1.限制每個(gè)上傳文件的最大長(zhǎng)度。
// su.setMaxFileSize(10000);
// 2.限制總上傳數(shù)據(jù)的長(zhǎng)度。
// su.setTotalMaxFileSize(20000);
// 3.設(shè)定允許上傳的文件（通過(guò)擴(kuò)展名限制）,僅允許doc,txt文件。
// su.setAllowedFilesList("doc,txt");
// 4.設(shè)定禁止上傳的文件（通過(guò)擴(kuò)展名限制）,禁止上傳帶有exe,bat,
jsp,htm,html擴(kuò)展名的文件和沒(méi)有擴(kuò)展名的文件。
// su.setDeniedFilesList("exe,bat,jsp,htm,html,,");
// 上傳文件
su.upload();
// 將上傳文件全部保存到指定目錄
int count = su.save("/upload");
out.println(count+"個(gè)文件上傳成功！<br>");
// 利用Request對(duì)象獲取參數(shù)之值
out.println("TEST="+su.getRequest().getParameter("TEST")
+"<BR><BR>");
// 逐一提取上傳文件信息，同時(shí)可保存文件。
for (int i=0;i<su.getFiles().getCount();i++)
{
com.jspsmart.upload.File file = su.getFiles().getFile(i);
// 若文件不存在則繼續(xù)
if (file.isMissing()) continue;
// 顯示當(dāng)前文件信息
out.println("<TABLE BORDER=1>");
out.println("<TR><TD>表單項(xiàng)名（FieldName）</TD><TD>"
+ file.getFieldName() + "</TD></TR>");
out.println("<TR><TD>文件長(zhǎng)度（Size）</TD><TD>" +
file.getSize() + "</TD></TR>");
out.println("<TR><TD>文件名（FileName）</TD><TD>"
+ file.getFileName() + "</TD></TR>");
out.println("<TR><TD>文件擴(kuò)展名（FileExt）</TD><TD>"
+ file.getFileExt() + "</TD></TR>");
out.println("<TR><TD>文件全名（FilePathName）</TD><TD>"
+ file.getFilePathName() + "</TD></TR>");
out.println("</TABLE><BR>");
// 將文件另存
// file.saveAs("/upload/" + myFile.getFileName());
// 另存到以WEB應(yīng)用程序的根目錄為文件根目錄的目錄下
// file.saveAs("/upload/" + myFile.getFileName(),
su.SAVE_VIRTUAL);
// 另存到操作系統(tǒng)的根目錄為文件根目錄的目錄下
// file.saveAs("c:\\temp\\" + myFile.getFileName(),
su.SAVE_PHYSICAL);
}
%>
</body>
</html>
四、文件下載篇
1、下載鏈接頁(yè)面download.html
頁(yè)面源碼如下：
<!--
文件名：download.html
作 者：縱橫軟件制作中心雨亦奇(zhsoft88@sohu.com)
-->
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>下載</title>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
</head>
<body>
<a href="jsp/do_download.jsp">點(diǎn)擊下載</a>
</body>
</html>
2、下載處理頁(yè)面do_download.jsp do_download.jsp展示了如何利用jspSmartUpload組件來(lái)下載文件，從下面的源碼中就可以看到，下載何其簡(jiǎn)單。
源碼如下：
<%@ page contentType="text/html;charset=gb2312"
import="com.jspsmart.upload.*" %><%
// 新建一個(gè)SmartUpload對(duì)象
SmartUpload su = new SmartUpload();
// 初始化
su.initialize(pageContext);
// 設(shè)定contentDisposition為null以禁止瀏覽器自動(dòng)打開(kāi)文件，
//保證點(diǎn)擊鏈接后是下載文件。若不設(shè)定，則下載的文件擴(kuò)展名為
//doc時(shí)，瀏覽器將自動(dòng)用word打開(kāi)它。擴(kuò)展名為pdf時(shí)，
//瀏覽器將用acrobat打開(kāi)。
su.setContentDisposition(null);
// 下載文件
su.downloadFile("/upload/如何賺取我的第一桶金.doc");
%>
注意，執(zhí)行下載的頁(yè)面，在Java腳本范圍外（即<% ... %>之外），不要包含HTML代碼、空格、回車(chē)或換行等字符，有的話將不能正確下載。不信的話，可以在上述源碼中%><%之間加入一個(gè)換行符，再下載一下，保證出錯(cuò)。因?yàn)樗绊懥朔祷亟o瀏覽器的數(shù)據(jù)流，導(dǎo)致解析出錯(cuò)。
3、如何下載中文文件
jspSmartUpload雖然能下載文件，但對(duì)中文支持不足。若下載的文件名中有漢字，則瀏覽器在提示另存的文件名時(shí)，顯示的是一堆亂碼，很掃人興。上面的例子就是這樣。（這個(gè)問(wèn)題也是眾多下載組件所存在的問(wèn)題，很少有人解決，搜索不到相關(guān)資料，可嘆！）
為了給jspSmartUpload組件增加下載中文文件的支持，我對(duì)該組件進(jìn)行了研究，發(fā)現(xiàn)對(duì)返回給瀏覽器的另存文件名進(jìn)行UTF-8編碼后，瀏覽器便能正確顯示中文名字了。這是一個(gè)令人高興的發(fā)現(xiàn)。于是我對(duì)jspSmartUpload組件的SmartUpload類(lèi)做了升級(jí)處理，增加了toUtf8String這個(gè)方法，改動(dòng)部分源碼如下：
public void downloadFile(String s, String s1, String s2, int i)
throws ServletException, IOException, SmartUploadException
{
if(s == null)
throw new IllegalArgumentException("File ''" + s +
"'' not found (1040).");
if(s.equals(""))
throw new IllegalArgumentException("File ''" + s +
"'' not found (1040).");
if(!isVirtual(s) && m_denyPhysicalPath)
throw new SecurityException("Physical path is
denied (1035).");
if(isVirtual(s))
s = m_application.getRealPath(s);
java.io.File file = new java.io.File(s);
FileInputStream fileinputstream = new FileInputStream(file);
long l = file.length();
boolean flag = false;
int k = 0;
byte abyte0[] = new byte[i];
if(s1 == null)
m_response.setContentType("application/x-msdownload");
else
if(s1.length() == 0)
m_response.setContentType("application/x-msdownload");
else
m_response.setContentType(s1);
m_response.setContentLength((int)l);
m_contentDisposition = m_contentDisposition != null ?
m_contentDisposition : "attachment;";
if(s2 == null)
m_response.setHeader("Content-Disposition",
m_contentDisposition + " filename=" +
toUtf8String(getFileName(s)));
else
if(s2.length() == 0)
m_response.setHeader("Content-Disposition",
m_contentDisposition);
else
m_response.setHeader("Content-Disposition",
m_contentDisposition + " filename=" + toUtf8String(s2));
while((long)k < l)
{
int j = fileinputstream.read(abyte0, 0, i);
k += j;
m_response.getOutputStream().write(abyte0, 0, j);
}
fileinputstream.close();
}
/**
* 將文件名中的漢字轉(zhuǎn)為UTF8編碼的串,以便下載時(shí)能正確顯示另存的文件名.
* 縱橫軟件制作中心雨亦奇2003.08.01
* @param s 原文件名
* @return 重新編碼后的文件名
*/
public static String toUtf8String(String s) {
StringBuffer sb = new StringBuffer();
for (int i=0;i<s.length();i++) {
char c = s.charAt(i);
if (c >= 0 && c <= 255) {
sb.append(c);
} else {
byte[] b;
try {
b = Character.toString(c).getBytes("utf-8");
} catch (Exception ex) {
System.out.println(ex);
b = new byte[0];
}
for (int j = 0; j < b.length; j++) {
int k = b[j];
if (k < 0) k += 256;
sb.append("%" + Integer.toHexString(k).
toUpperCase());
}
}
}
return sb.toString();
}
注意源碼中粗體部分，原jspSmartUpload組件對(duì)返回的文件未作任何處理，現(xiàn)在做了編碼的轉(zhuǎn)換工作，將文件名轉(zhuǎn)換為UTF-8形式的編碼形式。UTF-8編碼對(duì)英文未作任何處理，對(duì)中文則需要轉(zhuǎn)換為%XX的形式。toUtf8String方法中，直接利用Java語(yǔ)言提供的編碼轉(zhuǎn)換方法獲得漢字字符的UTF-8編碼，之后將其轉(zhuǎn)換為%XX的形式。
將源碼編譯后打包成jspSmartUpload.jar，拷貝到Tomcat的shared/lib目錄下（可為所有WEB應(yīng)用程序所共享），然后重啟Tomcat服務(wù)器就可以正常下載含有中文名字的文件了。另，toUtf8String方法也可用于轉(zhuǎn)換含有中文的超級(jí)鏈接，以保證鏈接的有效，因?yàn)橛械腤EB服務(wù)器不支持中文鏈接。
小結(jié)：jspSmartUpload組件是應(yīng)用JSP進(jìn)行B/S程序開(kāi)發(fā)過(guò)程中經(jīng)常使用的上傳下載組件，它使用簡(jiǎn)單，方便。現(xiàn)在我又為其加上了下載中文名字的文件的支持，真?zhèn)€是如虎添翼，必將贏得更多開(kāi)發(fā)者的青睞。