ch11 文件的上传和下载组件

Ch10文件的上传和下载组件10.1概述文件上传：指由Servlet或者JavaBean获得客户端发出的输入流，再从这个输入流中读指定的文件，然后把文件保存到指定的位置，原理简单，但实现复杂。上传和下载有两种方法：使用JavaI/O流自定义完成文件操作的类使用专业的上传和下载组件使用jspSmartUpload组件使用CommonsFileUpLoad组件10.2jspSmartUpload组件jspSmartUpload是由网站开发的一个可免费使用的全功能的文件上传下载组件，适于嵌入执行上传下载操作的JSP文件中该组件有以下几个特点：1、使用简单。在JSP文件中仅仅书写三五行JAVA代码就可以搞定文件的上传或下载，方便。2、能全程控制上传。利用jspSmartUpload组件提供的对象及其操作方法，可以获得全部上传文件的信息（包括文件名，大小，类型，扩展名，文件数据等），方便存取。3、能对上传的文件在大小、类型等方面做出限制。如此可以滤掉不符合要求的文件。4、下载灵活。仅写两行代码，就能把Web服务器变成文件服务器。不管文件在Web服务器的目录下或在其它任何目录下，都可以利用jspSmartUpload进行下载。5、能将文件上传到数据库中，也能将数据库中的数据下载下来。这种功能针对的是MYSQL数据库，因为不具有通用性，所以本节不准备举例介绍这种用法。10.3jspSmartUpload组件安装与配置jspSmartUpload组件可以从网站上自由下载，压缩包的名字是jspSmartUpload.zip。下载后，用WinZip或WinRAR将其解压到Tomcat的webapps目录下解压后的目录是一个Web应用程序，目录结构如图1所示，将webapps/jspsmartupload目录下的子目录Web-inf名字改为全大写的WEB-INF

通过http://localhost:8080/jspsmartupload/default.htm可以进入演示程序页面，如图2所示

图1图2按上述方法安装后，只有webapps/jspsmartupload目录下的程序可以使用jspSmartUpload组件，如果想让Tomcat服务器的所有Web应用程序都能用它，必须做如下工作：1．进入命令行状态，将目录切换到Tomcat的webapps/jspsmartupload/WEB-INF目录下。2．运行JAR打包命令：jarcvfjspSmartUpload.jarcom（也可以打开资源管理器，切换到当前目录，用WinZip将com目录下的所有文件压缩成jspSmartUpload.zip，然后将jspSmartUpload.zip换名为jspSmartUpload.jar文件即可。）3．将jspSmartUpload.jar拷贝到Tomcat的lib目录下。注意：10.4jspSmartUpload组件的核心类简介核心类主要包括File、Files、Request、SmartUpload（一）File类包含一个上传文件的所有信息File类主要提供以下方法：

1、saveAs作用：将文件换名另存原型：publicvoidsaveAs(java.lang.StringdestFilePathName)或publicvoidsaveAs(java.lang.StringdestFilePathName,intoptionSaveAs)其中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.zipsaveAs("/upload/sample.zip",SAVEAS_VIRTUAL)执行后若Web应用程序的根目录是webapps/jspsmartupload，则另存的文件名实际是webapps/jspsmartupload/upload/sample.zipsaveAs("/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。原型：publicbooleanisMissing()3、getFieldName作用：取HTML表单中对应于此上传文件的表单项的名字。原型：publicStringgetFieldName()4、getFileName作用：取文件名（不含目录信息）原型：publicStringgetFileName()5、getFilePathName作用：取文件全名（带目录）原型：publicStringgetFilePathName6、getFileExt作用：取文件扩展名（后缀）原型：publicStringgetFileExt()7、getSize作用：取文件长度（以字节计）原型：publicintgetSize()8、getBinaryData作用：取文件数据中指定位移处的一个字节，用于检测文件等处理。原型：publicbytegetBinaryData(intindex)。其中，index表示位移，其值在0到getSize()-1之间。㈡Files类这个类表示所有上传文件的集合，通过它可以得到上传文件的数目、大小等信息。有以下方法：1、getCount作用：取得上传文件的数目。原型：publicintgetCount()2、getFile作用：取得指定位移处的文件对象File（这是com.jspsmart.upload.File

，不是java.io.File，注意区分）。原型：publicFilegetFile(intindex)。其中，index为指定位移，其值在0到getCount()-1之间。3、getSize作用：取得上传文件的总长度，可用于限制一次性上传的数据量大小。原型：publiclonggetSize()4、getCollection作用：将所有上传文件对象以Collection的形式返回，以便其它应用程序引用，浏览上传文件信息。原型：publicCollectiongetCollection()5、getEnumeration作用：将所有上传文件对象以Enumeration（枚举）的形式返回，以便其它应用程序浏览上传文件信息。原型：publicEnumerationgetEnumeration()㈢Request类

这个类的功能等同于JSP内置的对象request。只所以提供这个类，是因为对于文件上传表单，通过request对象无法获得表单项的值，必须通过jspSmartUpload组件提供的Request对象来获取。该类提供如下方法：1、getParameter作用：获取指定参数之值。当参数不存在时，返回值为null。原型：publicStringgetParameter(Stringname)。其中，name为参数的名字。2、getParameterValues作用：当一个参数可以有多个值时，用此方法来取其值。它返回的是一个字符串数组。当参数不存在时，返回值为null。原型：publicString[]getParameterValues(Stringname)。其中，name为参数的名字。3、getParameterNames作用：取得Request对象中所有参数的名字，用于遍历所有参数。它返回的是一个枚举型的对象。原型：publicEnumerationgetParameterNames()㈣SmartUpload类这个类完成上传下载工作

A．上传与下载共用的方法：只有一个：initialize。作用：执行上传下载的初始化工作，必须第一个执行。原型：有多个，主要使用下面这个：

publicfinalvoidinitialize(javax.servlet.jsp.PageContextpageContext)

其中，pageContext为JSP页面内置对象（页面上下文）。B．上传文件使用的方法：1、upload作用：上传文件数据。对于上传操作，第一步执行initialize方法，第二步就要执行这个方法。原型：publicvoidupload()2、save作用：将全部上传文件保存到指定目录下，并返回保存的文件个数。原型：publicintsave(StringdestPathName)

和publicintsave(StringdestPathName,intoption)其中，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作用：取上传文件数据的总长度原型：publicintgetSize()4、getFiles作用：取全部上传文件，以Files对象形式返回，可以利用Files类的操作方法来获得上传文件的数目等信息。

原型：publicFilesgetFiles()5、getRequest

作用：取得Request对象，以便由此对象获得上传表单参数之值。原型：publicRequestgetRequest()6、setAllowedFilesList作用：设定允许上传带有指定扩展名的文件，当上传过程中有文件名不允许时，组件将抛出异常。原型：publicvoidsetAllowedFilesList(StringallowedFilesList)其中，allowedFilesList为允许上传的文件扩展名列表，各个扩展名之间以逗号分隔。如果想允许上传那些没有扩展名的文件，可以用两个逗号表示。例如：setAllowedFilesList("doc,txt,,")将允许上传带doc和txt扩展名的文件以及没有扩展名的文件。7、setDeniedFilesList作用：用于限制上传那些带有指定扩展名的文件。若有文件扩展名被限制，则上传时组件将抛出异常。原型：publicvoidsetDeniedFilesList(StringdeniedFilesList)其中，deniedFilesList为禁止上传的文件扩展名列表，各个扩展名之间以逗号分隔。如果想禁止上传那些没有扩展名的文件，可以用两个逗号来表示。例如：setDeniedFilesList(“exe,bat,,”)将禁止上传带exe和bat扩展名的文件以及没有扩展名的文件。8、setMaxFileSize作用：设定每个文件允许上传的最大长度。原型：publicvoidsetMaxFileSize(longmaxFileSize)其中，maxFileSize为为每个文件允许上传的最大长度，当文件超出此长度时，将不被上传。9、setTotalMaxFileSize作用：设定允许上传的文件的总长度，用于限制一次性上传的数据量大小。原型：publicvoidsetTotalMaxFileSize(longtotalMaxFileSize)

其中，totalMaxFileSize为允许上传的文件的总长度。C．下载文件常用的方法

1、setContentDisposition作用：将数据追加到MIME文件头的CONTENT-DISPOSITION域。jspSmartUpload组件会在返回下载的信息时自动填写MIME文件头的CONTENT-DISPOSITION域，如果用户需要添加额外信息，请用此方法。原型：publicvoidsetContentDisposition(StringcontentDisposition)其中，contentDisposition为要添加的数据。如果contentDisposition为null，则组件将自动添加“attachment;”，以表明将下载的文件作为附件，结果是IE浏览器将会提示另存文件，而不是自动打开这个文件（IE浏览器一般根据下载的文件扩展名决定执行什么操作，扩展名为doc的将用word程序打开，扩展名为pdf的将用acrobat程序打开，等等）。

2、downloadFile作用：下载文件。原型：共有以下三个原型可用，第一个最常用，后两个用于特殊情况下的文件下载（如更改内容类型，更改另存的文件名）。①publicvoiddownloadFile(StringsourceFilePathName)其中，sourceFilePathName为要下载的文件名（带目录的文件全名）

②publicvoiddownloadFile(StringsourceFilePathName,StringcontentType)其中，sourceFilePathName为要下载的文件名（带目录的文件全名）,contentType为内容类型（MIME格式的文件类型信息，可被浏览器识别）。③publicvoiddownloadFile(StringsourceFilePathName,StringcontentType,StringdestFileName)其中，sourceFilePathName为要下载的文件名（带目录的文件全名）,contentType为内容类型（MIME格式的文件类型信息，可被浏览器识别）,destFileName为下载后默认的另存文件名。10.5文件上传㈠表单要求

对于上传文件的FORM表单，有两个要求：1、METHOD应用POST，即METHOD="POST"2、增加属性：ENCTYPE="multipart/form-data"下面是一个用于上传文件的FORM表单的例子：

<FORMMETHOD="POST"

ENCTYPE="multipart/form-data"

ACTION="/jspSmartUpload/upload.jsp"><INPUTTYPE="FILE"NAME="MYFILE"></FORM>1、上传页面upload.jsp本页面提供表单，让用户选择要上传的文件，点击“上传文件”按钮执行上传操作。源码如下所示：<%@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运行结果2、上传处理页do_upload.jsp本页面执行文件上传操作。页面源码中详细介绍了上传方法的用法，在此不赘述了。<%@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><% //新建一个SmartUpload对象

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

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

su.upload(); //将上传文件全部保存到指定目录

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

//利用Request对象获取参数之值

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

for(inti=0;i<su.getFiles().getCount();i++) { com.jspsmart.upload.Filefile=su.getFiles().getFile(i); //若文件不存在则继续

if(file.isMissing())continue; //显示当前文件信息

out.println("<TABLEBORDER=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("<TR><TD>文件类型（ContentType）</TD><TD>" +file.getContentType()+"</TD></TR>"); out.println("</TABLE><BR>"); }%><hr><%out.println("<br>一共可以上传"+su.getFiles().getCount()+"个文件<br>");out.println(count+"个文件已经被上传");%></body></html>另外可以设置上传限制，如限制上传文件的大小、类型等。//设定上传限制

//1.限制每个上传文件的最大长度。

su.setMaxFileSize(10000); //2.限制总上传数据的长度。

su.setTotalMaxFileSize(20000); //3.设定