这个类表示所有上传文件的集合，通过它可以得到上传文件的数目、大小等信息。有以 下方法： 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()
原型：public Files getFiles()
5、getRequest
作用：取得 Request 对象，以便由此对象获得上传表单参数之值。
原型：public Request getRequest()
6、setAllowedFilesList
作用：设定允许上传带有指定扩展名的文件，当上传过程中有文件名不允许时，组件将抛出 异常。
原型：
public void saveAs(ng.String destFilePathName)
或
public void saveAs(ng.String destFilePathName, int optionSaveAs)
其中，destFilePathName 是另存的文件名，optionSaveAs 是另存的选项，该选项有三个值， 分别是 SAVEAS_PHYSICAL,SAVEAS_VIRTUAL，SAVEAS_AUTO。SAVEAS_PHYSICAL 表明以操作系统的根目录为文件根目录另存文件，SAVEAS_VIRTUAL 表明以 Web 应用程 序的根目录为文件根目录另存文件，SAVEAS_AUTO 则表示让组件决定，当 Web 应用程序 的根目录存在另存文件的目录时，它会选择 SAVEAS_VIRTUAL，否则会选择 SAVEAS_PHYSICAL。
4、getCollection 作用：将所有上传文件对象以 Collection 的形式返回，以便其它应用程序引用，浏览上传文 件信息。
原型：public Collection getCollection() 5、getEnumeration 作用：将所有上传文件对象以 Enumeration（枚举）的形式返回，以便其它应用程序浏览上 传文件信息。
其中，destPathName 为文件保存目录，option 为保存选项，它有三个值，分别是 SAVE_PHYSICAL,SAVE_VIRTUAL 和 SAVE_AUTO。（同 File 类的 saveAs 方法的选项之 值类似）SAVE_PHYSICAL 指示组件将文件保存到以操作系统根目录为文件根目录的目录 下，SAVE_VIRTUAL 指示组件将文件保存到以 Web 应用程序根目录为文件根目录的目录 下，而 SAVE_AUTO 则表示由组件自动选择。
2．运行 JAR 打包命令：jar cvf jspSmartUpload.jar com
（也可以打开资源管理器，切换到当前目录，用 WinZip 将 com 目录下的所有文件压缩成 jspSmartUpload.zip，然后将 jspSmartUpload.zip 换名为 jspSmartUpload.jar 文件即可。）
原型：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
作用：取文件长度（以字节计） 原型：public int getSize() 8、getBinaryData 作用：取文件数据中指定位移处的一个字节，用于检测文件等处理。 原型：public byte getBinaryData(int index)。其中，index 表示位移，其值在0到 getSize()-1 之间。 ㈡ Files 类
一、安装篇
jspSmartUpload 是由 网站开发的一个可免费使用的全功能的文件 上传下载组件，适于嵌入执行上传下载操作的 JSP 文件中。该组件有以下几个特点：
1、使用简单。在 JSP 文件中仅仅书写三五行 JAVA 代码就可以搞定文件的上传或下载，方 便。
2、能全程控制上传。利用 jspSmartUpload 组件提供的对象及其操作方法，可以获得全部 上传文件的信息（包括文件名，大小，类型，扩展名，文件数据等），方便存取。
jspSmartUpload 组件可以从 网站上自由下载，压缩包的名字是 jspSmartUpload.zip。下载后，用 WinZip 或 WinRAR 将其解压到 Tomcat 的 webapps 目录 下（本文以 Tomcat 服务器为例进行介绍）。解压后，将 webapps/jspsmartupload 目录下的 子目录 Web-inf 名字改为全大写的 WEB-INF，这样一改 jspSmartUpload 类才能使用。因为 Tomcat 对文件名大小写敏感，它要求 Web 应用程序相关的类所在目录为 WEB-INF，且必 须是大写。接着重新启动 Tomcat，这样就可以在 JSP 文件中使用 jspSmartUpload 组件了。
注：save(destPathName)作用等同于 save(destPathName,SAVE_AUTO)。3Fra bibliotekgetSize
作用：取上传文件数据的总长度
原型：public int getSize()
4、getFiles
作用：取全部上传文件，以 Files 对象形式返回，可以利用 Files 类的操作方法来获得上传 文件的数目等信息。
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
3．将 jspSmartUpload.jar 拷贝到 Tomcat 的 shared/lib 目录下。
二、相关类说明篇
㈠ File 类
这个类包装了一个上传文件的所有信息。通过它，可以得到上传文件的文件名、文件大 小、扩展名、文件数据等信息。
File 类主要提供以下方法：
1、saveAs 作用：将文件换名另存。
例如，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)，否则同
3、能对上传的文件在大小、类型等方面做出限制。如此可以滤掉不符合要求的文件。
4、下载灵活。仅写两行代码，就能把 Web 服务器变成文件服务器。不管文件在 Web 服务 器的目录下或在其它任何目录下，都可以利用 jspSmartUpload 进行下载。
5、能将文件上传到数据库中，也能将数据库中的数据下载下来。这种功能针对的是 MYSQL 数据库，因为不具有通用性，所以本文不准备举例介绍这种用法。
注意，按上述方法安装后，只有 webapps/jspsmartupload 目录下的程序可以使用 jspSmartUpload 组件，如果想让 Tomcat 服务器的所有 Web 应用程序都能用它，必须做如 下工作：
1．进入命令行状态，将目录切换到 Tomcat 的 webapps/jspsmartupload/WEB-INF 目录下。
作用：取得 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)