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ì)象及其操作方法，可以獲得全部上傳文件的信息（包括文件名，大小，類型，擴(kuò)展名，文件數(shù)據(jù)等），方便存取。
3、能對(duì)上傳的文件在大小、類型等方面做出限制。如此可以濾掉不符合要求的文件。
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類才能使用。因?yàn)門omcat對(duì)文件名大小寫(xiě)敏感，它要求Web應(yīng)用程序相關(guān)的類所在目錄為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)類說(shuō)明篇
㈠ File類
這個(gè)類包裝了一個(gè)上傳文件的所有信息。通過(guò)它，可以得到上傳文件的文件名、文件大小、擴(kuò)展名、文件數(shù)據(jù)等信息。
File類主要提供以下方法：
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盤，則另存的文件名實(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類
這個(gè)類表示所有上傳文件的集合，通過(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類
這個(gè)類的功能等同于JSP內(nèi)置的對(duì)象request。只所以提供這個(gè)類，是因?yàn)閷?duì)于文件上傳表單，通過(guò)request對(duì)象無(wú)法獲得表單項(xiàng)的值，必須通過(guò)jspSmartUpload組件提供的Request對(duì)象來(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類這個(gè)類完成上傳下載工作。
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類的saveAs方法的選項(xiàng)之值類似）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)獲得上傳文件的數(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)度。
C．下載文件常用的方法
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)容類型，更改另存的文件名）。
① public void downloadFile(String sourceFilePathName)
其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）
② public void downloadFile(String sourceFilePathName,String contentType)
其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）,contentType為內(nèi)容類型（MIME格式的文件類型信息，可被瀏覽器識(shí)別）。
③ public void downloadFile(String sourceFilePathName,String contentType,String destFileName)
其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）,contentType為內(nèi)容類型（MIME格式的文件類型信息，可被瀏覽器識(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>
其他不多討論