JSP SmartUpload的上傳下載
一.安裝篇
JSP SmartUpload是由www.JSPsmart.com網站開發的一個可免費使用的全功能的文件上傳下載組件，適于嵌入執行上傳下載操作的JSP文件中。該組件有以下幾個特點：
1、使用簡單。在JSP文件中僅僅書寫三五行JAVA代碼就可以搞定文件的上傳或下載，方便。
2、能全程控制上傳。利用JSP SmartUpload組件提供的對象及其操作方法，可以獲得全部上傳文件的信息（包括文件名，大小，類型，擴展名，文件數據等），方便存取。
3、能對上傳的文件在大小、類型等方面做出限制。如此可以濾掉不符合要求的文件。
4、下載靈活。僅寫兩行代碼，就能把Web服務器變成文件服務器。不管文件在Web服務器的目錄下或在其它任何目錄下，都可以利用JSP SmartUpload進行下載。
5、能將文件上傳到數據庫中，也能將數據庫中的數據下載下來。這種功能針對的是MYSQL數據庫，因為不具有通用性，所以本文不準備舉例介紹這種用法。
JSP SmartUpload組件可以從www.JSPsmart.com網站上自由下載，壓縮包的名字是JSP SmartUpload.zip.下載后，用WinZip或WinRAR將其解壓到Tomcat的webapps目錄下（本文以Tomcat服務器為例進行介紹）。解壓后，將webapps/JSP SmartUpload目錄下的子目錄Web-inf名字改為全大寫的WEB-INF，這樣一改JSP SmartUpload類才能使用。因為Tomcat對文件名大小寫敏感，它要求Web應用程序相關的類所在目錄為WEB-INF，且必須是大寫。接著重新啟動Tomcat，這樣就可以在JSP文件中使用JSP SmartUpload組件了。
注意，按上述方法安裝后，只有webapps/JSP SmartUpload目錄下的程序可以使用JSP SmartUpload組件，如果想讓Tomcat服務器的所有Web應用程序都能用它，必須做如下工作：
1.進入命令行狀態，將目錄切換到Tomcat的webapps/JSP SmartUpload/WEB-INF目錄下。
2.運行JAR打包命令：jar cvf JSP SmartUpload.jar com（也可以打開資源管理器，切換到當前目錄，用WinZip將com目錄下的所有文件壓縮成JSP SmartUpload.zip，然后將JSP SmartUpload.zip換名為JSP SmartUpload.jar文件即可。）
3.將JSP SmartUpload.jar拷貝到Tomcat的shared/lib目錄下。
二、相關類說明篇
1).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：\upload\sample.zip.而saveAs（"/upload/sample.zip"，SAVEAS_VIRTUAL）執行后若Web 應用程序的根目錄是webapps/JSP SmartUpload，則另存的文件名實際是webapps/JSP SmartUpload/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，以便移植。
1、isMissing作用：這個方法用于判斷用戶是否選擇了文件，也即對應的表單項是否有值。選擇了文件時，它返回false.未選文件時，它返回true.原型：public boolean isMissing（）
2、getFieldName作用：取HTML表單中對應于此上傳文件的表單項的名字。原型：public String getFieldName（）
3、getFileName作用：取文件名（不含目錄信息）原型：public String getFileName（）
4、getFilePathName作用：取文件全名（帶目錄）原型：public String getFilePathName
5、getFileExt作用：取文件擴展名（后綴）原型：public String getFileExt（）
6、getSize作用：取文件長度（以字節計）原型：public int getSize（）
7、getBinaryData作用：取文件數據中指定位移處的一個字節，用于檢測文件等處理。原型：public byte getBinaryData（int index）。其中，index表示位移，其值在0到getSize（）-1之間。
2).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（）
3).Request類這個類的功能等同于JSP內置的對象request.只所以提供這個類，是因為對于文件上傳表單，通過request對象無法獲得表單項的值，必須通過JSP SmartUpload 組件提供的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（）
4).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為允許上傳的文件的總長度。
C.下載文件常用的方法
1、setContentDisposition作用：將數據追加到MIME文件頭的CONTENT-DISPOSITION域。JSP SmartUpload組件會在返回下載的信息時自動填寫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為下載后默認的另存文件名。
【編輯推薦】
