SmartUpload相关类的证实

㈠ 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)

内部,total马克斯FileSize为允许上传的文件的总长度。

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为下载后默许的另存文件名。

相关文章