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:uploadsample.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()-第11中学间。

3、getSize

效果:获得上传文件的总参谋长度,可用来约束三次性上传的数据量大小。

原型:public long getSize()

4、getCollection

效率:将具有上传文件对象以Collection的格局重返,以便别的应用程序援引,浏览上传文件音信。

原型:public Collection getCollection()

5、getEnumeration

作用:将具有上传文件对象以Enumeration(枚举)的情势再次来到,以便别的应用程序浏览上传文件音信。

原型:public Enumeration getEnumeration()

㈢ Request类

  那几个类的效应相像JSP内置的目的request。只所以提供这么些类,是因为对此文本上传表单,通过request对象不能够赢得表单项的值,必须通过jsp斯马特Upload组件提供的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为下载后暗中同意的另存文件名。

发表评论

电子邮件地址不会被公开。 必填项已用*标注