ch11 文件的上傳和下載組件

Ch10文件的上傳和下載組件10.1概述文件上傳：指由Servlet或者JavaBean獲得客戶端發(fā)出的輸入流，再從這個(gè)輸入流中讀指定的文件，然后把文件保存到指定的位置，原理簡單，但實(shí)現(xiàn)復(fù)雜。上傳和下載有兩種方法：使用JavaI/O流自定義完成文件操作的類使用專業(yè)的上傳和下載組件使用jspSmartUpload組件使用CommonsFileUpLoad組件10.2jspSmartUpload組件jspSmartUpload是由網(wǎng)站開發(fā)的一個(gè)可免費(fèi)使用的全功能的文件上傳下載組件，適于嵌入執(zhí)行上傳下載操作的JSP文件中該組件有以下幾個(gè)特點(diǎn)：1、使用簡單。在JSP文件中僅僅書寫三五行JAVA代碼就可以搞定文件的上傳或下載，方便。2、能全程控制上傳。利用jspSmartUpload組件提供的對象及其操作方法，可以獲得全部上傳文件的信息（包括文件名，大小，類型，擴(kuò)展名，文件數(shù)據(jù)等），方便存取。3、能對上傳的文件在大小、類型等方面做出限制。如此可以濾掉不符合要求的文件。4、下載靈活。僅寫兩行代碼，就能把Web服務(wù)器變成文件服務(wù)器。不管文件在Web服務(wù)器的目錄下或在其它任何目錄下，都可以利用jspSmartUpload進(jìn)行下載。5、能將文件上傳到數(shù)據(jù)庫中，也能將數(shù)據(jù)庫中的數(shù)據(jù)下載下來。這種功能針對的是MYSQL數(shù)據(jù)庫，因?yàn)椴痪哂型ㄓ眯?，所以本?jié)不準(zhǔn)備舉例介紹這種用法。10.3jspSmartUpload組件安裝與配置jspSmartUpload組件可以從網(wǎng)站上自由下載，壓縮包的名字是jspSmartUpload.zip。下載后，用WinZip或WinRAR將其解壓到Tomcat的webapps目錄下解壓后的目錄是一個(gè)Web應(yīng)用程序，目錄結(jié)構(gòu)如圖1所示，將webapps/jspsmartupload目錄下的子目錄Web-inf名字改為全大寫的WEB-INF

通過http://localhost:8080/jspsmartupload/default.htm可以進(jìn)入演示程序頁面，如圖2所示

圖1圖2按上述方法安裝后，只有webapps/jspsmartupload目錄下的程序可以使用jspSmartUpload組件，如果想讓Tomcat服務(wù)器的所有Web應(yīng)用程序都能用它，必須做如下工作：1．進(jìn)入命令行狀態(tài)，將目錄切換到Tomcat的webapps/jspsmartupload/WEB-INF目錄下。2．運(yùn)行JAR打包命令：jarcvfjspSmartUpload.jarcom（也可以打開資源管理器，切換到當(dāng)前目錄，用WinZip將com目錄下的所有文件壓縮成jspSmartUpload.zip，然后將jspSmartUpload.zip換名為jspSmartUpload.jar文件即可。）3．將jspSmartUpload.jar拷貝到Tomcat的lib目錄下。注意：10.4jspSmartUpload組件的核心類簡介核心類主要包括File、Files、Request、SmartUpload（一）File類包含一個(gè)上傳文件的所有信息File類主要提供以下方法：

1、saveAs作用：將文件換名另存原型：publicvoidsaveAs(java.lang.StringdestFilePathName)或publicvoidsaveAs(java.lang.StringdestFilePathName,intoptionSaveAs)其中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.zipsaveAs("/upload/sample.zip",SAVEAS_VIRTUAL)執(zhí)行后若Web應(yīng)用程序的根目錄是webapps/jspsmartupload，則另存的文件名實(shí)際是webapps/jspsmartupload/upload/sample.zipsaveAs("/upload/sample.zip",SAVEAS_AUTO)執(zhí)行時(shí)若Web應(yīng)用程序根目錄下存在upload目錄，則其效果同saveAs("/upload/sample.zip",SAVEAS_VIRTUAL)，否則同saveAs("/upload/sample.zip",SAVEAS_PHYSICAL)。建議：對于Web程序的開發(fā)來說，最好使用SAVEAS_VIRTUAL以便移植。2、isMissing作用：這個(gè)方法用于判斷用戶是否選擇了文件，也即對應(yīng)的表單項(xiàng)是否有值。選擇了文件時(shí)，它返回false。未選文件時(shí)，它返回true。原型：publicbooleanisMissing()3、getFieldName作用：取HTML表單中對應(yīng)于此上傳文件的表單項(xiàng)的名字。原型：publicStringgetFieldName()4、getFileName作用：取文件名（不含目錄信息）原型：publicStringgetFileName()5、getFilePathName作用：取文件全名（帶目錄）原型：publicStringgetFilePathName6、getFileExt作用：取文件擴(kuò)展名（后綴）原型：publicStringgetFileExt()7、getSize作用：取文件長度（以字節(jié)計(jì)）原型：publicintgetSize()8、getBinaryData作用：取文件數(shù)據(jù)中指定位移處的一個(gè)字節(jié)，用于檢測文件等處理。原型：publicbytegetBinaryData(intindex)。其中，index表示位移，其值在0到getSize()-1之間。㈡Files類這個(gè)類表示所有上傳文件的集合，通過它可以得到上傳文件的數(shù)目、大小等信息。有以下方法：1、getCount作用：取得上傳文件的數(shù)目。原型：publicintgetCount()2、getFile作用：取得指定位移處的文件對象File（這是com.jspsmart.upload.File

，不是java.io.File，注意區(qū)分）。原型：publicFilegetFile(intindex)。其中，index為指定位移，其值在0到getCount()-1之間。3、getSize作用：取得上傳文件的總長度，可用于限制一次性上傳的數(shù)據(jù)量大小。原型：publiclonggetSize()4、getCollection作用：將所有上傳文件對象以Collection的形式返回，以便其它應(yīng)用程序引用，瀏覽上傳文件信息。原型：publicCollectiongetCollection()5、getEnumeration作用：將所有上傳文件對象以Enumeration（枚舉）的形式返回，以便其它應(yīng)用程序?yàn)g覽上傳文件信息。原型：publicEnumerationgetEnumeration()㈢Request類

這個(gè)類的功能等同于JSP內(nèi)置的對象request。只所以提供這個(gè)類，是因?yàn)閷τ谖募蟼鞅韱?，通過request對象無法獲得表單項(xiàng)的值，必須通過jspSmartUpload組件提供的Request對象來獲取。該類提供如下方法：1、getParameter作用：獲取指定參數(shù)之值。當(dāng)參數(shù)不存在時(shí)，返回值為null。原型：publicStringgetParameter(Stringname)。其中，name為參數(shù)的名字。2、getParameterValues作用：當(dāng)一個(gè)參數(shù)可以有多個(gè)值時(shí)，用此方法來取其值。它返回的是一個(gè)字符串?dāng)?shù)組。當(dāng)參數(shù)不存在時(shí)，返回值為null。原型：publicString[]getParameterValues(Stringname)。其中，name為參數(shù)的名字。3、getParameterNames作用：取得Request對象中所有參數(shù)的名字，用于遍歷所有參數(shù)。它返回的是一個(gè)枚舉型的對象。原型：publicEnumerationgetParameterNames()㈣SmartUpload類這個(gè)類完成上傳下載工作

A．上傳與下載共用的方法：只有一個(gè)：initialize。作用：執(zhí)行上傳下載的初始化工作，必須第一個(gè)執(zhí)行。原型：有多個(gè)，主要使用下面這個(gè)：

publicfinalvoidinitialize(javax.servlet.jsp.PageContextpageContext)

其中，pageContext為JSP頁面內(nèi)置對象（頁面上下文）。B．上傳文件使用的方法：1、upload作用：上傳文件數(shù)據(jù)。對于上傳操作，第一步執(zhí)行initialize方法，第二步就要執(zhí)行這個(gè)方法。原型：publicvoidupload()2、save作用：將全部上傳文件保存到指定目錄下，并返回保存的文件個(gè)數(shù)。原型：publicintsave(StringdestPathName)

和publicintsave(StringdestPathName,intoption)其中，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ù)的總長度原型：publicintgetSize()4、getFiles作用：取全部上傳文件，以Files對象形式返回，可以利用Files類的操作方法來獲得上傳文件的數(shù)目等信息。

原型：publicFilesgetFiles()5、getRequest

作用：取得Request對象，以便由此對象獲得上傳表單參數(shù)之值。原型：publicRequestgetRequest()6、setAllowedFilesList作用：設(shè)定允許上傳帶有指定擴(kuò)展名的文件，當(dāng)上傳過程中有文件名不允許時(shí)，組件將拋出異常。原型：publicvoidsetAllowedFilesList(StringallowedFilesList)其中，allowedFilesList為允許上傳的文件擴(kuò)展名列表，各個(gè)擴(kuò)展名之間以逗號分隔。如果想允許上傳那些沒有擴(kuò)展名的文件，可以用兩個(gè)逗號表示。例如：setAllowedFilesList("doc,txt,,")將允許上傳帶doc和txt擴(kuò)展名的文件以及沒有擴(kuò)展名的文件。7、setDeniedFilesList作用：用于限制上傳那些帶有指定擴(kuò)展名的文件。若有文件擴(kuò)展名被限制，則上傳時(shí)組件將拋出異常。原型：publicvoidsetDeniedFilesList(StringdeniedFilesList)其中，deniedFilesList為禁止上傳的文件擴(kuò)展名列表，各個(gè)擴(kuò)展名之間以逗號分隔。如果想禁止上傳那些沒有擴(kuò)展名的文件，可以用兩個(gè)逗號來表示。例如：setDeniedFilesList(“exe,bat,,”)將禁止上傳帶exe和bat擴(kuò)展名的文件以及沒有擴(kuò)展名的文件。8、setMaxFileSize作用：設(shè)定每個(gè)文件允許上傳的最大長度。原型：publicvoidsetMaxFileSize(longmaxFileSize)其中，maxFileSize為為每個(gè)文件允許上傳的最大長度，當(dāng)文件超出此長度時(shí)，將不被上傳。9、setTotalMaxFileSize作用：設(shè)定允許上傳的文件的總長度，用于限制一次性上傳的數(shù)據(jù)量大小。原型：publicvoidsetTotalMaxFileSize(longtotalMaxFileSize)

其中，totalMaxFileSize為允許上傳的文件的總長度。C．下載文件常用的方法

1、setContentDisposition作用：將數(shù)據(jù)追加到MIME文件頭的CONTENT-DISPOSITION域。jspSmartUpload組件會(huì)在返回下載的信息時(shí)自動(dòng)填寫MIME文件頭的CONTENT-DISPOSITION域，如果用戶需要添加額外信息，請用此方法。原型：publicvoidsetContentDisposition(StringcontentDisposition)其中，contentDisposition為要添加的數(shù)據(jù)。如果contentDisposition為null，則組件將自動(dòng)添加“attachment;”，以表明將下載的文件作為附件，結(jié)果是IE瀏覽器將會(huì)提示另存文件，而不是自動(dòng)打開這個(gè)文件（IE瀏覽器一般根據(jù)下載的文件擴(kuò)展名決定執(zhí)行什么操作，擴(kuò)展名為doc的將用word程序打開，擴(kuò)展名為pdf的將用acrobat程序打開，等等）。

2、downloadFile作用：下載文件。原型：共有以下三個(gè)原型可用，第一個(gè)最常用，后兩個(gè)用于特殊情況下的文件下載（如更改內(nèi)容類型，更改另存的文件名）。①publicvoiddownloadFile(StringsourceFilePathName)其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）

②publicvoiddownloadFile(StringsourceFilePathName,StringcontentType)其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）,contentType為內(nèi)容類型（MIME格式的文件類型信息，可被瀏覽器識(shí)別）。③publicvoiddownloadFile(StringsourceFilePathName,StringcontentType,StringdestFileName)其中，sourceFilePathName為要下載的文件名（帶目錄的文件全名）,contentType為內(nèi)容類型（MIME格式的文件類型信息，可被瀏覽器識(shí)別）,destFileName為下載后默認(rèn)的另存文件名。10.5文件上傳㈠表單要求

對于上傳文件的FORM表單，有兩個(gè)要求：1、METHOD應(yīng)用POST，即METHOD="POST"2、增加屬性：ENCTYPE="multipart/form-data"下面是一個(gè)用于上傳文件的FORM表單的例子：

<FORMMETHOD="POST"

ENCTYPE="multipart/form-data"

ACTION="/jspSmartUpload/upload.jsp"><INPUTTYPE="FILE"NAME="MYFILE"></FORM>1、上傳頁面upload.jsp本頁面提供表單，讓用戶選擇要上傳的文件，點(diǎn)擊“上傳文件”按鈕執(zhí)行上傳操作。源碼如下所示：<%@pagecontentType="text/html;charset=utf-8"language="java"%><html><head><title>文件上傳</title></head><body><palign="center">文件上傳選擇</p><formaction=“do_upload.jsp"method="post"enctype="multipart/form-data"><inputtype="hidden"name="test"value="good"><tablewidth="60%"border="1"align="center"><tr><tdalign="center">文件1<inputtype="file"name="file1"size="30"></td></tr><tr><tdalign="center">文件2<inputtype="file"name="file2"size="30"></td></tr><tr><tdalign="center">文件3<inputtype="file"name="file3"size="30"></td></tr><tr><tdalign="center"><inputtype="submit"name="submit"value="上傳文件"></td></tr></table></form></body></html>upload.jsp運(yùn)行結(jié)果2、上傳處理頁do_upload.jsp本頁面執(zhí)行文件上傳操作。頁面源碼中詳細(xì)介紹了上傳方法的用法，在此不贅述了。<%@pagecontentType="text/html;charset=gb2312"language="java"import="java.util.*,com.jspsmart.upload.*"errorPage=""%><html><head><title>文件上傳處理頁面</title><metahttp-equiv="Content-Type"content="text/html;charset=gb2312"></head><body><% //新建一個(gè)SmartUpload對象

SmartUploadsu=newSmartUpload(); //上傳初始化

su.initialize(pageContext);//上傳文件

su.upload(); //將上傳文件全部保存到指定目錄

intcount=su.save("/upload"); out.println(count+"個(gè)文件上傳成功！<br>");

//利用Request對象獲取參數(shù)之值

out.println("TEST="+su.getRequest().getParameter("TEST") +"<BR><BR>"); //逐一提取上傳文件信息，同時(shí)可保存文件。

for(inti=0;i<su.getFiles().getCount();i++) { com.jspsmart.upload.Filefile=su.getFiles().getFile(i); //若文件不存在則繼續(xù)

if(file.isMissing())continue; //顯示當(dāng)前文件信息

out.println("<TABLEBORDER=1>"); out.println("<TR><TD>表單項(xiàng)名（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>文件擴(kuò)展名（FileExt）</TD><TD>" +file.getFileExt()+"</TD></TR>"); out.println("<TR><TD>文件路徑全名（FilePathName）</TD><TD>" +file.getFilePathName()+"</TD></TR>"); out.println("<TR><TD>文件類型（ContentType）</TD><TD>" +file.getContentType()+"</TD></TR>"); out.println("</TABLE><BR>"); }%><hr><%out.println("<br>一共可以上傳"+su.getFiles().getCount()+"個(gè)文件<br>");out.println(count+"個(gè)文件已經(jīng)被上傳");%></body></html>另外可以設(shè)置上傳限制，如限制上傳文件的大小、類型等。//設(shè)定上傳限制

//1.限制每個(gè)上傳文件的最大長度。

su.setMaxFileSize(10000); //2.限制總上傳數(shù)據(jù)的長度。

su.setTotalMaxFileSize(20000); //3.設(shè)定