jsp smartupload學習

 

smartupload 是jsp中用於上傳文件的組件，　　其特色以下：

一、使用簡單。在JSP文件中僅僅書寫三五行java代碼就能夠搞定文件的上傳或下載，方便。

二、能全程控制上傳。利用jspSmartUpload組件提供的對象及其操做方法，能夠得到所有上傳文件的信息（包括文件名，大小，類型，擴展名，文件數據等），方便存取。

 

三、能對上傳的文件在大小、類型等方面作出限制。如此能夠濾掉不符合要求的文件。

 

四、下載靈活。僅寫兩行代碼，就能把 Web服務器變成文件服務器。無論文件在Web服務器的目錄下或在其它任何目錄下，均可以利用jspSmartUpload進行下載。

 

這裏簡單介紹這個組件裏面類的功能

 

File類

 

這個類包裝了一個上傳文件的全部信息。經過它，能夠獲得上傳文件的文件名、文件大小、擴展名、文件數據等信息。

 

File類主要提供如下方法：

 

一、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("/uploa

 

/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，以便移植。

 

二、 isMissing

 

做用：這個方法用於判斷用戶是否選擇了文件，也即對應的表單項是否有值。選擇了文件時，它返回false。未選文件時，它返回true。

 

原型：public boolean isMissing()

 

三、getFieldName

 

做用：取 HTML表單中對應於此上傳文件的表單項的名字。

 

原型：public String getFieldName()

 

四、 getFileName

 

做用：取文件名（不含目錄信息）

 

原型：public String getFileName()

 

五、getFilePathName

 

做用：取文件全名（帶目錄）

 

原型：public String getFilePathName

 

六、getFileExt

 

做用：取 文件擴展名（後綴）

 

原型：public String getFileExt()

 

七、getSize

 

做用：取文件長度（以 字節計）

 

原型：public int getSize()

 

八、getBinaryData

 

做用：取文件數據中指定位移處的一個字節，用於檢測文件等處理。

 

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

 

Files類

 

這個類表示全部上傳文件的集合，經過它能夠獲得上傳文件的數目、大小等信息。有如下方法：

 

一、 getCount

 

做用：取得上傳文件的數目。

 

原型：public int getCount()

 

二、getFile

 

做用：取得指定位移處的文件對象File（這是com.jspsmart.upload.File，不是java.io.File，注意區分）。

 

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

 

三、getSize

 

做用：取得上傳文件的總長度，可用於限制一次性上傳的數據量大小。

 

原型：public long getSize()

 

四、getCollection

 

做用：將全部上傳文件對象以Collection的形式返回，以便其它應用程序引用，瀏覽上傳文件信息。

 

原型：public Collection getCollection()

 

 

五、getEnumeration

 

做用：將全部上傳文件對象以 Enumeration（枚舉）的形式返回，以便其它應用程序瀏覽上傳文件信息。

 

原型：public Enumeration getEnumeration()

 

Request類

 

這個類的功能等同於JSP內置的對象request。只因此提供這個類，是由於對於文件上傳表單，經過 request對象沒法得到表單項的值，必須經過jspSmartUpload組件提供的 Request

 

對象來獲取。該類提供以下方法：

 

一、getParameter

 

做用：獲取指定參數之值。當參數不存在時，返回值爲null。

 

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

 

二、getParameterValues

 

做用：當一個參數能夠有多個值時，用此方法來取其值。它返回的是一個字符串 數組。當參數不存在時，返回值爲null。

 

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

 

三、getParameterNames

 

做用：取得 Request對象中全部參數的名字，用於 遍歷全部參數。它返回的是一個 枚舉型的對象。

 

原型：public Enumeration getParameterNames()

 

SmartUpload類這個類完成上傳下載工做

 

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

 

只有一個：initialize。

 

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

 

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

 

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

 

其中， pageContext爲JSP頁面內置對象（頁面上下文）。

 

B．上傳文件使用的方法：

 

一、upload

 

做用：上傳文件數據。對於上傳操做，第一步執行initialize方法，第二步就要執行這個方法。

 

原型：public void upload()

 

二、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)。

 

三、getSize

 

做用：取上傳文件數據的總長度

 

原型：public int getSize()

 

四、getFiles

 

做用：取所有上傳文件，以Files對象形式返回，能夠利用Files類的操做方法來得到上傳文件的數目等信息。

 

原型：public Files getFiles()

 

五、getRequest

 

做用：取得 Request對象，以便由此對象得到上傳表單參數之值。

 

原型：public Request getRequest()

 

六、setAllowedFilesList

 

做用：設定容許上傳帶有指定擴展名的文件，當上傳過程當中有文件名不容許時，組件將 拋出異常。

 

原型：public void setAllowedFilesList(String allowedFilesList)

 

其中，allowedFilesList爲容許上傳的 文件擴展名列表，各個擴展名之間以逗號分隔。若是想容許上傳那些沒有擴展名的文件，能夠用兩個逗號表示。例

 

 

如：setAllowedFilesList("doc,txt,,")將容許上傳帶doc和txt擴展名的文件以及沒有擴展名的文件。

 

七、setDeniedFilesList

 

做用：用於限制上傳那些帶有指定擴展名的文件。如有文件擴展名被限制，則上傳時組件將 拋出異常。

 

原型：public void setDeniedFilesList(String deniedFilesList)

 

其中，deniedFilesList爲禁止上傳的 文件擴展名列表，各個擴展名之間以逗號分隔。若是想禁止上傳那些沒有擴展名的文件，能夠用兩個逗號來表示。例

 

如：setDeniedFilesList("exe,bat,,")將禁止上傳帶exe和bat擴展名的文件以及沒有擴展名的文件。

 

八、setMaxFileSize

 

做用：設定每一個文件容許上傳的最大長度。

 

原型：public void setMaxFileSize(long maxFileSize)

 

其中，maxFileSize爲爲每一個文件容許上傳的最大長度，當文件超出此長度時，將不被上傳。

 

九、setTotalMaxFileSize

 

做用：設定容許上傳的文件的總長度，用於限制一次性上傳的數據量大小。

 

原型：public void setTotalMaxFileSize(long totalMaxFileSize)

 

其中，totalMaxFileSize爲容許上傳的文件的總長度。

 

C．下載文件經常使用的方法

 

一、setContentDisposition

 

做用：將數據追加到 MIME 文件頭的CONTENT-DISPOSITION域。jspSmartUpload組件會在返回下載的信息時自動填寫MIME文件頭的CONTENT-DISPOSITION域，若是用戶須要添加

 

額外信息，請用此方法。

 

原型：public void setContentDisposition(String contentDisposition)

 

其中，contentDisposition爲要添加的數據。若是contentDisposition爲null，則組件將自動添加"attachment;"，以代表將下載的文件做爲附件，結果是 IE瀏覽器將會提示另存文件，而

 

不是自動打開這個文件（IE瀏覽器通常根據下載的 文件擴展名決定執行什麼操做，擴展名爲doc的將用Word程序打開，擴展名爲 pdf的將用acrobat程序打開，等等）。

 

二、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爲下載後默認的另存文

 

件名