一、安裝篇
jspSmartUpload是由www.jspsmart.com網站開發的一個可免費使用的全功能的文件上傳下載組件,適于嵌入執行上傳下載操作的JSP文件中。該組件有以下幾個特點:
1、使用簡單。在JSP文件中僅僅書寫三五行JAVA代碼就可以搞定文件的上傳或下載,方便。
2、能全程控制上傳。利用jspSmartUpload組件提供的對象及其操作方法,可以獲得全部上傳文件的信息(包括文件名,大小,類型,擴展名,文件數據等),方便存取。
3、能對上傳的文件在大小、類型等方面做出限制。如此可以濾掉不符合要求的文件。
4、下載靈活。僅寫兩行代碼,就能把Web服務器變成文件服務器。不管文件在Web服務器的目錄下或在其它任何目錄下,都可以利用jspSmartUpload進行下載。
5、能將文件上傳到數據庫中,也能將數據庫中的數據下載下來。這種功能針對的是MYSQL數據庫,因為不具有通用性,所以本文不準備舉例介紹這種用法。
jspSmartUpload組件可以從www.jspsmart.com網站上自由下載,壓縮包的名字是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:\upload\sample.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為允許上傳的文件的總長度。
C.下載文件常用的方法
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表單的例子:
㈡ 上傳的例子
1、上傳頁面upload.html
本頁面提供表單,讓用戶選擇要上傳的文件,點擊"上傳"按鈕執行上傳操作。
頁面源碼如下:
2、上傳處理頁面do_upload.jsp
本頁面執行文件上傳操作。頁面源碼中詳細介紹了上傳方法的用法,在此不贅述了。
頁面源碼如下:
????????????????????????????????????????????????????????????????????????
<%
--
????文件名:do_upload.jsp
????作??者:縱橫軟件制作中心雨亦奇(zhsoft88@sohu.com)
--
%>
<%
@?page?contentType
=
"
text/html;?charset=gb2312
"
?language
=
"
java
"
?
import
=
"
java.util.*,com.jspsmart.upload.*
"
?errorPage
=
""
?
%>
<
html
>
<
head
>
<
title
>
文件上傳處理頁面
</
title
>
<
meta?
http-equiv
="Content-Type"
?content
="text/html;?charset=gb2312"
>
</
head
>
<
body
>
<%
????
//
?新建一個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
+
"
個文件上傳成功!<br>
"
);
????
????
//
?利用Request對象獲取參數之值
????out.println(
"
TEST=
"
+
su.getRequest().getParameter(
"
TEST
"
)
????
+
"
<BR><BR>
"
);

????
//
?逐一提取上傳文件信息,同時可保存文件。
????
for
?(
int
?i
=
0
;i
<
su.getFiles().getCount();i
++
)
????{
????????com.jspsmart.upload.File?file?
=
?su.getFiles().getFile(i);
????????
????????
//
?若文件不存在則繼續
????????
if
?(file.isMissing())?continue;

????????
//
?顯示當前文件信息
????????out.println(
"
<TABLE?BORDER=1>
"
);
????????out.println(
"
<TR><TD>表單項名(FieldName)</TD><TD>
"
????????
+
?file.getFieldName()?
+
?
"
</TD></TR>
"
);
????????out.println(
"
<TR><TD>文件長度(Size)</TD><TD>
"
?
+
?
????????file.getSize()?
+
?
"
</TD></TR>
"
);
????????out.println(
"
<TR><TD>文件名(FileName)</TD><TD>
"
?
????????
+
?file.getFileName()?
+
?
"
</TD></TR>
"
);
????????out.println(
"
<TR><TD>文件擴展名(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應用程序的根目錄為文件根目錄的目錄下
????????
//
?file.saveAs(
"
/upload/
"
?
+
?myFile.getFileName(),?
????????su.SAVE_VIRTUAL);
????????
//
?另存到操作系統的根目錄為文件根目錄的目錄下
????????
//
?file.saveAs(
"
c:\\temp\\
"
?
+
?myFile.getFileName(),?
????????su.SAVE_PHYSICAL);

????}
%>
</
body
>
</
html
>
四、文件下載篇
1、下載鏈接頁面download.html
頁面源碼如下:
2、下載處理頁面do_download.jsp do_download.jsp展示了如何利用jspSmartUpload組件來下載文件,從下面的源碼中就可以看到,下載何其簡單。
源碼如下:
<%
@?page?contentType
=
"
text/html;charset=gb2312
"
?
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這個方法,改動部分源碼如下:
????
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
;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組件對返回的文件未作任何處理,現在做了編碼的轉換工作,將文件名轉換為UTF-8形式的編碼形式。UTF-8編碼對英文未作任何處理,對中文則需要轉換為%XX的形式。toUtf8String方法中,直接利用Java語言提供的編碼轉換方法獲得漢字字符的UTF-8編碼,之后將其轉換為%XX的形式。
將源碼編譯后打包成jspSmartUpload.jar,拷貝到Tomcat的shared/lib目錄下(可為所有WEB應用程序所共享),然后重啟Tomcat服務器就可以正常下載含有中文名字的文件了。另,toUtf8String方法也可用于轉換含有中文的超級鏈接,以保證鏈接的有效,因為有的WEB服務器不支持中文鏈接。
小結:jspSmartUpload組件是應用JSP進行B/S程序開發過程中經常使用的上傳下載組件,它使用簡單,方便。現在我又為其加上了下載中文名字的文件的支持,真個是如虎添翼,必將贏得更多開發者的青睞。
jspSmartUpload是由www.jspsmart.com網站開發的一個可免費使用的全功能的文件上傳下載組件,適于嵌入執行上傳下載操作的JSP文件中。該組件有以下幾個特點:
1、使用簡單。在JSP文件中僅僅書寫三五行JAVA代碼就可以搞定文件的上傳或下載,方便。
2、能全程控制上傳。利用jspSmartUpload組件提供的對象及其操作方法,可以獲得全部上傳文件的信息(包括文件名,大小,類型,擴展名,文件數據等),方便存取。
3、能對上傳的文件在大小、類型等方面做出限制。如此可以濾掉不符合要求的文件。
4、下載靈活。僅寫兩行代碼,就能把Web服務器變成文件服務器。不管文件在Web服務器的目錄下或在其它任何目錄下,都可以利用jspSmartUpload進行下載。
5、能將文件上傳到數據庫中,也能將數據庫中的數據下載下來。這種功能針對的是MYSQL數據庫,因為不具有通用性,所以本文不準備舉例介紹這種用法。
jspSmartUpload組件可以從www.jspsmart.com網站上自由下載,壓縮包的名字是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:\upload\sample.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為允許上傳的文件的總長度。
C.下載文件常用的方法
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表單的例子:
???
<
FORM?
METHOD
="POST"
?ENCTYPE
="multipart/form-data"
?
??????????????????ACTION ="/jspSmartUpload/upload.jsp" >
<
INPUT?
TYPE
="FILE"
?NAME
="MYFILE"
>
<
INPUT?
TYPE
="SUBMIT"
>
</
FORM
>
??????????????????ACTION ="/jspSmartUpload/upload.jsp" >



㈡ 上傳的例子
1、上傳頁面upload.html
本頁面提供表單,讓用戶選擇要上傳的文件,點擊"上傳"按鈕執行上傳操作。
頁面源碼如下:
??
<!--
????文件名: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、上傳處理頁面do_upload.jsp
本頁面執行文件上傳操作。頁面源碼中詳細介紹了上傳方法的用法,在此不贅述了。
頁面源碼如下:
















































































四、文件下載篇
1、下載鏈接頁面download.html
頁面源碼如下:
?<!--
????????文件名: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"
>
點擊下載
</
a
>
</
body
>
</
html
>














2、下載處理頁面do_download.jsp do_download.jsp展示了如何利用jspSmartUpload組件來下載文件,從下面的源碼中就可以看到,下載何其簡單。
源碼如下:














3、如何下載中文文件
jspSmartUpload雖然能下載文件,但對中文支持不足。若下載的文件名中有漢字,則瀏覽器在提示另存的文件名時,顯示的是一堆亂碼,很掃人興。上面的例子就是這樣。(這個問題也是眾多下載組件所存在的問題,很少有人解決,搜索不到相關資料,可嘆!)
為了給jspSmartUpload組件增加下載中文文件的支持,我對該組件進行了研究,發現對返回給瀏覽器的另存文件名進行UTF-8編碼后,瀏覽器便能正確顯示中文名字了。這是一個令人高興的發現。于是我對jspSmartUpload組件的SmartUpload類做了升級處理,增加了toUtf8String這個方法,改動部分源碼如下:



































































































注意源碼中粗體部分,原jspSmartUpload組件對返回的文件未作任何處理,現在做了編碼的轉換工作,將文件名轉換為UTF-8形式的編碼形式。UTF-8編碼對英文未作任何處理,對中文則需要轉換為%XX的形式。toUtf8String方法中,直接利用Java語言提供的編碼轉換方法獲得漢字字符的UTF-8編碼,之后將其轉換為%XX的形式。
將源碼編譯后打包成jspSmartUpload.jar,拷貝到Tomcat的shared/lib目錄下(可為所有WEB應用程序所共享),然后重啟Tomcat服務器就可以正常下載含有中文名字的文件了。另,toUtf8String方法也可用于轉換含有中文的超級鏈接,以保證鏈接的有效,因為有的WEB服務器不支持中文鏈接。
小結:jspSmartUpload組件是應用JSP進行B/S程序開發過程中經常使用的上傳下載組件,它使用簡單,方便。現在我又為其加上了下載中文名字的文件的支持,真個是如虎添翼,必將贏得更多開發者的青睞。