jspSmartUpload组件的类和方法.docVIP

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、get