[轉載]上傳下載全攻略jspSmartUpload

一、安裝篇

　　jspSmartUpload是由網站開發的一個可免費使用的全功能的檔案上傳下載元件，適於嵌入執行上傳下載操作的JSP檔案中。該元件有以下幾個特點：

1、使用簡單。在JSP檔案中僅僅書寫三五行JAVA程式碼就可以搞定檔案的上傳或下載，方便。

2、能全程控制上傳。利用jspSmartUpload元件提供的物件及其操作方法，可以獲得全部上傳檔案的資訊（包括檔名，大小，型別，副檔名，檔案資料等），方便存取。

3、能對上傳的檔案在大小、型別等方面做出限制。如此可以濾掉不符合要求的檔案。

4、下載靈活。僅寫兩行程式碼，就能把Web伺服器變成檔案伺服器。不管檔案在Web伺服器的目錄下或在其它任何目錄下，都可以利用jspSmartUpload進行下載。

5、能將檔案上傳到資料庫中，也能將資料庫中的資料下載下來。這種功能針對的是MYSQL資料庫，因為不具有通用性，所以本文不準備舉例介紹這種用法。[@more@]　　jspSmartUpload元件可以從網站上自由下載，壓縮包的名字是jspSmartUpload.zip。下載後，用WinZip或WinRAR將其解壓到Tomcat的webapps目錄下（本文以Tomcat伺服器為例進行介紹）。解壓後，將webapps/jspsmartupload目錄下的子目錄Web-inf名字改為全大寫的WEB-INF，這樣一改jspSmartUpload類才能使用。因為Tomcat對檔名大小寫敏感，它要求Web應用程式相關的類所在目錄為WEB-INF，且必須是大寫。接著重新啟動Tomcat，這樣就可以在JSP檔案中使用jspSmartUpload元件了。

　　注意，按上述方法安裝後，只有webapps/jspsmartupload目錄下的程式可以使用jspSmartUpload元件，如果想讓Tomcat伺服器的所有Web應用程式都能用它，必須做如下工作：

1．進入命令列狀態，將目錄切換到Tomcat的webapps/jspsmartupload/WEB-INF目錄下。

2．執行JAR打包命令：jar cvf jspSmartUpload.jar com

（也可以開啟資源管理器，切換到當前目錄，用WinZip將com目錄下的所有檔案壓縮成jspSmartUpload.zip，然後將jspSmartUpload.zip換名為jspSmartUpload.jar檔案即可。）

3．將jspSmartUpload.jar複製到Tomcat的shared/lib目錄下。

二、相關類說明篇

㈠ File類

　　這個類包裝了一個上傳檔案的所有資訊。透過它，可以得到上傳檔案的檔名、檔案大小、副檔名、檔案資料等資訊。

　　File類主要提供以下方法：

1、saveAs作用：將檔案換名另存。

原型：

public void saveAs(java.lang.String destFilePathName)

或

public void saveAs(java.lang.String destFilePathName, int optionSaveAs)

其中，destFilePathName是另存的檔名，optionSaveAs是另存的選項，該選項有三個值，分別是SAVEAS_PHYSICAL,SAVEAS_VIRTUAL，SAVEAS_AUTO。SAVEAS_PHYSICAL表明以作業系統的根目錄為檔案根目錄另存檔案，SAVEAS_VIRTUAL表明以Web應用程式的根目錄為檔案根目錄另存檔案，SAVEAS_AUTO則表示讓元件決定，當Web應用程式的根目錄存在另存檔案的目錄時，它會選擇SAVEAS_VIRTUAL，否則會選擇SAVEAS_PHYSICAL。

例如，saveAs("/upload/sample.zip",SAVEAS_PHYSICAL)執行後若Web伺服器安裝在C盤，則另存的檔名實際是c:uploadsample.zip。而saveAs("/upload/sample.zip",SAVEAS_VIRTUAL)執行後若Web應用程式的根目錄是webapps/jspsmartupload，則另存的檔名實際是webapps/jspsmartupload/upload/sample.zip。saveAs("/upload/sample.zip",SAVEAS_AUTO)執行時若Web應用程式根目錄下存在upload目錄，則其效果同saveAs("/upload/sample.zip",SAVEAS_VIRTUAL)，否則同saveAs("/upload/sample.zip",SAVEAS_PHYSICAL)。

建議：對於Web程式的開發來說，最好使用SAVEAS_VIRTUAL，以便移植。

2、isMissing

作用：這個方法用於判斷使用者是否選擇了檔案，也即對應的表單項是否有值。選擇了檔案時，它返回false。未選檔案時，它返回true。

原型：public boolean isMissing()

3、getFieldName

作用：取HTML表單中對應於此上傳檔案的表單項的名字。

原型：public String getFieldName()

4、getFileName

作用：取檔名（不含目錄資訊）

原型：public String getFileName()

5、getFilePathName

作用：取檔案全名（帶目錄）

原型：public String getFilePathName

6、getFileExt

作用：取副檔名（字尾）

原型：public String getFileExt()

7、getSize

作用：取檔案長度（以位元組計）

原型：public int getSize()

8、getBinaryData

作用：取檔案資料中指定位移處的一個位元組，用於檢測檔案等處理。

原型：public byte getBinaryData(int index)。其中，index表示位移，其值在0到getSize()-1之間。

㈡ Files類

　　這個類表示所有上傳檔案的集合，透過它可以得到上傳檔案的數目、大小等資訊。有以下方法：

1、getCount

作用：取得上傳檔案的數目。

原型：public int getCount()

2、getFile

作用：取得指定位移處的檔案物件File（這是com.jspsmart.upload.File，不是java.io.File，注意區分）。

原型：public File getFile(int index)。其中，index為指定位移，其值在0到getCount()-1之間。

3、getSize

作用：取得上傳檔案的總長度，可用於限制一次性上傳的資料量大小。

原型：public long getSize()

4、getCollection

作用：將所有上傳檔案物件以Collection的形式返回，以便其它應用程式引用，瀏覽上傳檔案資訊。

原型：public Collection getCollection()

5、getEnumeration

作用：將所有上傳檔案物件以Enumeration（列舉）的形式返回，以便其它應用程式瀏覽上傳檔案資訊。

原型：public Enumeration getEnumeration()

㈢ Request類

　　這個類的功能等同於JSP內建的物件request。只所以提供這個類，是因為對於檔案上傳表單，透過request物件無法獲得表單項的值，必須透過jspSmartUpload元件提供的Request物件來獲取。該類提供如下方法：

1、getParameter

作用：獲取指定引數之值。當引數不存在時，返回值為null。

原型：public String getParameter(String name)。其中，name為引數的名字。

2、getParameterValues

作用：當一個引數可以有多個值時，用此方法來取其值。它返回的是一個字串陣列。當引數不存在時，返回值為null。

原型：public String[] getParameterValues(String name)。其中，name為引數的名字。

3、getParameterNames

作用：取得Request物件中所有引數的名字，用於遍歷所有引數。它返回的是一個列舉型的物件。

原型：public Enumeration getParameterNames()

㈣ SmartUpload類這個類完成上傳下載工作。

A．上傳與下載共用的方法：

只有一個：initialize。

作用：執行上傳下載的初始化工作，必須第一個執行。

原型：有多個，主要使用下面這個：

public final void initialize(javax.servlet.jsp.PageContext pageContext)

其中，pageContext為JSP頁面內建物件（頁面上下文）。

B．上傳檔案使用的方法：

1、upload

作用：上傳檔案資料。對於上傳操作，第一步執行initialize方法，第二步就要執行這個方法。

原型：public void upload()

2、save

作用：將全部上傳檔案儲存到指定目錄下，並返回儲存的檔案個數。

原型：public int save(String destPathName)

和public int save(String destPathName,int option)

其中，destPathName為檔案儲存目錄，option為儲存選項，它有三個值，分別是SAVE_PHYSICAL,SAVE_VIRTUAL和SAVE_AUTO。（同File類的saveAs方法的選項之值類似）SAVE_PHYSICAL指示元件將檔案儲存到以作業系統根目錄為檔案根目錄的目錄下，SAVE_VIRTUAL指示元件將檔案儲存到以Web應用程式根目錄為檔案根目錄的目錄下，而SAVE_AUTO則表示由元件自動選擇。

注：save(destPathName)作用等同於save(destPathName,SAVE_AUTO)。

3、getSize

作用：取上傳檔案資料的總長度

原型：public int getSize()

4、getFiles

作用：取全部上傳檔案，以Files物件形式返回，可以利用Files類的操作方法來獲得上傳檔案的數目等資訊。

原型：public Files getFiles()

5、getRequest

作用：取得Request物件，以便由此物件獲得上傳表單引數之值。

原型：public Request getRequest()

6、setAllowedFilesList

作用：設定允許上傳帶有指定副檔名的檔案，當上傳過程中有檔名不允許時，元件將丟擲異常。

原型：public void setAllowedFilesList(String allowedFilesList)

其中，allowedFilesList為允許上傳的副檔名列表，各個副檔名之間以逗號分隔。如果想允許上傳那些沒有副檔名的檔案，可以用兩個逗號表示。例如：setAllowedFilesList("doc,txt,,")將允許上傳帶doc和txt副檔名的檔案以及沒有副檔名的檔案。

7、setDeniedFilesList

作用：用於限制上傳那些帶有指定副檔名的檔案。若有副檔名被限制，則上傳時元件將丟擲異常。

原型：public void setDeniedFilesList(String deniedFilesList)

其中，deniedFilesList為禁止上傳的副檔名列表，各個副檔名之間以逗號分隔。如果想禁止上傳那些沒有副檔名的檔案，可以用兩個逗號來表示。例如：setDeniedFilesList("exe,bat,,")將禁止上傳帶exe和bat副檔名的檔案以及沒有副檔名的檔案。

8、setMaxFileSize

作用：設定每個檔案允許上傳的最大長度。

原型：public void setMaxFileSize(long maxFileSize)

其中，maxFileSize為為每個檔案允許上傳的最大長度，當檔案超出此長度時，將不被上傳。

9、setTotalMaxFileSize

作用：設定允許上傳的檔案的總長度，用於限制一次性上傳的資料量大小。

原型：public void setTotalMaxFileSize(long totalMaxFileSize)

其中，totalMaxFileSize為允許上傳的檔案的總長度。



1、setContentDisposition

作用：將資料追加到MIME檔案頭的CONTENT-DISPOSITION域。jspSmartUpload元件會在返回下載的資訊時自動填寫MIME檔案頭的CONTENT-DISPOSITION域，如果使用者需要新增額外資訊，請用此方法。

原型：public void setContentDisposition(String contentDisposition)

其中，contentDisposition為要新增的資料。如果contentDisposition為null，則元件將自動新增"attachment;"，以表明將下載的檔案作為附件，結果是IE瀏覽器將會提示另存檔案，而不是自動開啟這個檔案（IE瀏覽器一般根據下載的副檔名決定執行什麼操作，副檔名為doc的將用word程式開啟，副檔名為pdf的將用acrobat程式開啟，等等）。

2、downloadFile

作用：下載檔案。

原型：共有以下三個原型可用，第一個最常用，後兩個用於特殊情況下的檔案下載（如更改內容型別，更改另存的檔名）。

① public void downloadFile(String sourceFilePathName)

其中，sourceFilePathName為要下載的檔名（帶目錄的檔案全名）

② public void downloadFile(String sourceFilePathName,String contentType)

其中，sourceFilePathName為要下載的檔名（帶目錄的檔案全名）,contentType為內容型別（MIME格式的檔案型別資訊，可被瀏覽器識別）。

③ public void downloadFile(String sourceFilePathName,String contentType,String destFileName)

其中，sourceFilePathName為要下載的檔名（帶目錄的檔案全名）,contentType為內容型別（MIME格式的檔案型別資訊，可被瀏覽器識別）,destFileName為下載後預設的另存檔名。

三、檔案上傳篇

㈠ 表單要求

對於上傳檔案的FORM表單，有兩個要求：

1、METHOD應用POST，即METHOD="POST"。

2、增加屬性：ENCTYPE="multipart/form-data"

下面是一個用於上傳檔案的FORM表單的例子：

ACTION="/jspSmartUpload/upload.jsp">






㈡ 上傳的例子

1、上傳頁面upload.html

本頁面提供表單，讓使用者選擇要上傳的檔案，點選"上傳"按鈕執行上傳操作。

頁面原始碼如下：

<!--
檔名：upload.html
作 者：縱橫軟體製作中心雨亦奇(zhsoft88@sohu.com)
--&gt

上傳檔案選擇

ENCTYPE="multipart/form-data">

1、

2、

3、

4、

2、上傳處理頁面do_upload.jsp

本頁面執行檔案上傳操作。頁面原始碼中詳細介紹了上傳方法的用法，在此不贅述了。

頁面原始碼如下：

檔名：do_upload.jsp
作 者：縱橫軟體製作中心雨亦奇(zhsoft88@sohu.com)
--%>
import="java.util.*,com.jspsmart.upload.*" errorPage="" %>







// 新建一個SmartUpload物件
SmartUpload su = new SmartUpload();
// 上傳初始化
su.initialize(pageContext);
// 設定上傳限制
// 1.限制每個上傳檔案的最大長度。
// su.setMaxFileSize(10000);
// 2.限制總上傳資料的長度。
// su.setTotalMaxFileSize(20000);
// 3.設定允許上傳的檔案（透過副檔名限制）,僅允許doc,txt檔案。
// su.setAllowedFilesList("doc,txt");
// 4.設定禁止上傳的檔案（透過副檔名限制）,禁止上傳帶有exe,bat,
jsp,htm,html副檔名的檔案和沒有副檔名的檔案。
// su.setDeniedFilesList("exe,bat,jsp,htm,html,,");
// 上傳檔案
su.upload();
// 將上傳檔案全部儲存到指定目錄
int count = su.save("/upload");
out.println(count+"個檔案上傳成功！
");

// 利用Request物件獲取引數之值
out.println("TEST="+su.getRequest().getParameter("TEST")
+"

");

// 逐一提取上傳檔案資訊，同時可儲存檔案。
for (int i=0;i{
com.jspsmart.upload.File file = su.getFiles().getFile(i);

// 若檔案不存在則繼續
if (file.isMissing()) continue;

// 顯示當前檔案資訊
out.println("");
out.println("");
out.println("");
out.println("");
out.println("");
out.println("");
out.println("

表單項名（FieldName）	" + file.getFieldName() + "
檔案長度（Size）	" + file.getSize() + "
檔名（FileName）	" + file.getFileName() + "
副檔名（FileExt）	" + file.getFileExt() + "
檔案全名（FilePathName）	" + file.getFilePathName() + "

");

// 將檔案另存
// file.saveAs("/upload/" + myFile.getFileName());
// 另存到以WEB應用程式的根目錄為檔案根目錄的目錄下
// file.saveAs("/upload/" + myFile.getFileName(),
su.SAVE_VIRTUAL);
// 另存到作業系統的根目錄為檔案根目錄的目錄下
// file.saveAs("c:temp" + myFile.getFileName(),
su.SAVE_PHYSICAL);

}
%>





四、檔案下載篇

1、下載連結頁面download.html

頁面原始碼如下：

<!--
檔名：download.html
作 者：縱橫軟體製作中心雨亦奇(zhsoft88@sohu.com)
--&gt







點選下載





2、下載處理頁面do_download.jsp do_download.jsp展示瞭如何利用jspSmartUpload元件來下載檔案，從下面的原始碼中就可以看到，下載何其簡單。

原始碼如下：

import="com.jspsmart.upload.*" %>// 新建一個SmartUpload物件
SmartUpload su = new SmartUpload();
// 初始化
su.initialize(pageContext);
// 設定contentDisposition為null以禁止瀏覽器自動開啟檔案，
//保證點選連結後是下載檔案。若不設定，則下載的副檔名為
//doc時，瀏覽器將自動用word開啟它。副檔名為pdf時，
//瀏覽器將用acrobat開啟。
su.setContentDisposition(null);
// 下載檔案
su.downloadFile("/upload/如何賺取我的第一桶金.doc");
%>



注意，執行下載的頁面，在Java指令碼範圍外（即之外），不要包含HTML程式碼、空格、回車或換行等字元，有的話將不能正確下載。不信的話，可以在上述原始碼中%>
3、如何下載中文檔案

jspSmartUpload雖然能下載檔案，但對中文支援不足。若下載的檔名中有漢字，則瀏覽器在提示另存的檔名時，顯示的是一堆亂碼，很掃人興。上面的例子就是這樣。（這個問題也是眾多下載元件所存在的問題，很少有人解決，搜尋不到相關資料，可嘆！）

為了給jspSmartUpload元件增加下載中文檔案的支援，我對該元件進行了研究，發現對返回給瀏覽器的另存檔名進行UTF-8編碼後，瀏覽器便能正確顯示中文名字了。這是一個令人高興的發現。於是我對jspSmartUpload元件的SmartUpload類做了升級處理，增加了toUtf8String這個方法，改動部分原始碼如下：

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();
}

/**
* 將檔名中的漢字轉為UTF8編碼的串,以便下載時能正確顯示另存的檔名.
* 縱橫軟體製作中心雨亦奇2003.08.01
* @param s 原檔名
* @return 重新編碼後的檔名
*/
public static String toUtf8String(String s) {
StringBuffer sb = new StringBuffer();
for (int i=0;ichar 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元件對返回的檔案未作任何處理，現在做了編碼的轉換工作，將檔名轉換為UTF-8形式的編碼形式。UTF-8編碼對英文未作任何處理，對中文則需要轉換為%XX的形式。toUtf8String方法中，直接利用Java語言提供的編碼轉換方法獲得漢字字元的UTF-8編碼，之後將其轉換為%XX的形式。

將原始碼編譯後打包成jspSmartUpload.jar，複製到Tomcat的shared/lib目錄下（可為所有WEB應用程式所共享），然後重啟Tomcat伺服器就可以正常下載含有中文名字的檔案了。另，toUtf8String方法也可用於轉換含有中文的超級連結，以保證連結的有效，因為有的WEB伺服器不支援中文連結。

小結：jspSmartUpload元件是應用JSP進行B/S程式開發過程中經常使用的上傳下載元件，它使用簡單，方便。現在我又為其加上了下載中文名字的檔案的支援，真個是如虎添翼，必將贏得更多開發者的青睞。