jspSmarUpload组件中的主要类

在jspSmartUpload组件中主要包含了File、Files、Request和SmartUpload核心类

1、File类

File类不同于java.io.File类,在编写程序时应注意使用。File类用于保存单个文件的相关信息。如上传文件的文件名、文件大小、文件数据等。

方法 说明
saveAs() 该方法用于保存文件
isMissing() 该方法用于判断用户是否选择了文件,即表单中对应的标记实现的文件选择域中是否有值。该方法返回boolean型值。
getFiledName() 获取Form表单中当前上传文件所对应的表单项的名称
getFileName() 获取文件的文件名,该文件名不包含目录
getFileExt() 获取文件的扩展名,即后缀,不包含”.”符号
getContentType() 获取文件MIME类型,如”text/plain”
getContentString() 获取文件的内容,返回String型
getSize() 获取文件的大小,单位字节,返回int型
getBinaryData(int index) 返回值为byte,获取文件数据中参数index指定位置处的一个字节

File类中提供了两种形式的saveAs()方法:

1、saveAs(String destFilePathName)

destFilePathName参数用于指定文件保存的路径,包含文件名。其值应以”/”开头

2、saveAs(String destFilePathName,int optionSaveAs)

optionSaveAs参数用于指定保存目标选项,该选项有三个值,分别是:

1.SAVEAS_AUTO -> 0

saveAs(“/files/myfile.txt”,File.SAVEAS_AUTO)或saveAs(“/files/myfile.txt”,0)
如果FileUpDown应用根目录下存在‘files’子目录,则以SAVEAS_VIRTUAL方式保存文件,否则以SAVEAS_PHYSICAL方式保存文件

2.SAVEAS_VIRTUAL -> 1

saveAs(“/files/myfile.txt”,File.SAVEAS_VIRTUAL)或saveAs(“/files/myfile.txt”,1)
如果FileUpDown应用下存在’files’子目录,则将上传的文件以”myfile.txt”为文件名进行保存,实际的保存路径为”E:\Tomcat\webapps\FileUpDown\files\myfile.txt”
如果不存在’files’子目录,则抛出异常

3.SAVEAS_PHYSICAL -> 2

saveAs(“/files/myfile.txt”,File.SAVEAS_PHYSICAL)或saveAs(“/files/myfile.txt”,2)
由于Tomcat安装在E盘,因此,若E盘更目录下存在’files’子目录,则将上传的文件以”myfile.txt”为文件名进行保存,实际的保存路径为”E:\file|myfile.txt”.
如果E盘根目录不存在’files’子目录,而FileUpDown应用的根目录下存在’files’子目录,则抛出异常

2、Files类

Files类存储了所有上传的文件,通过类中的方法可活得上传文件的数量和总长度等信息。

方法 说明
getCount() 获取上传文件的数目,返回为int型
getSize() 获取上传文件的总长度,单位为字节,返回值为long型
getFile(int index) 获取参数index指定位置处的com.jspsmart.upload.File对象
getCollection() 将所有File对象一Collection形式返回
getEnumeration() 将所有File对象以Enumeration形式返回

3、Request类

设置该类的目的是因为当Form表单实现文件上传时,通过JSP内置对象request的getParameter()方法无法获取其他表单项的值,所以提供了该类来获取

方法 说明
getParameter(String name) 获取Form表单中有参数指定的表单元素的值
getParameterNames() 获取Form表单中 除 外所有表单元素的名称,返回一个枚举型对象
getParameterValues(String name) 获取Form表单中多个具有相同名称的表单元素的值,该名称由name指定,返回一个字符串数组

4、SmartUpload类

1)在使用jspSmartUpload组件实现文件上传与下载时,必须先实现initialize()方法。

1.initialize(ServletConfig config,HttpServletRequest request,HttpServletResponse response)。
2.initialize(ServletContext application,HttpServletRequest request,HttpServletResponse response)
3.initialize(PageContext pageContext)

2)upload()方法

实现了 initialize()方法后,紧接着应事先upload()方法,用来完成一些准备操作。首先在该方法中调用JSP内置对象request的getInputSteam()方法获取客户的输入流,然后通过该输入流的read()方法读取用户上传的所有文件数据到字节数组中,再次在循环语句中从该字节数组中提取每个文件的数据,并将当前提取出的文件信息封装到File类对象中,最后将该File类对象通过Files类的addFile()方法添加到Files类对象中。

3)save()方法

在实现了initialize()方法和upload()方法后,通过调用该方法就可以将全部上传文件保存到指定目录下,并返回保存的文件个数。

save(String destPathName)->save(String destPathName,0)

save(String destPathName,int option)

实际上,在SmartUpload类中的save()方法中最终是调用File类中的saveAs()方法保存文件。

4)SmartUpload类中用来限制上传文件和获取其他信息的主要方方法。

1.setDeniedFilesList(String deniedFilesList)方法

指定禁止上传文件的扩展名,如setDeniedFilesList(“exe,jsp,bat”)

2.setAllowedFilesList(String allowedFilesList)方法

指定允许上传文件的扩展名

3.setMaxFileSize(long maxFileSize)

4.setTotalMaxFileSize(long totalMaxFileSize)

设置允许上传文件的总长度。

上面介绍的对文件进行限制的方法,需要在uploa()方法之前调用。

文件下载使用的方法

1、setContentDisposition(String contentDisposition)

该方法用于将追加到MIME文件头的CONTENT-DISPOSITION域。参数contentDisposition为要添加的数据。进行文件下载时,将contentDisposition设为null,则组件将自动添加”attachment”,表示将下载的文件作为 附件 ,IE浏览器会弹出“文件下载”对话框,而不是自动打开这个文件。

2、downloadFile()

1.downloadFile(String sourceFilePathName)
2.downloadFile(String sourceFilePathName,String contentType)
3.downloadFile(String sourceFilePathName,String contentType,String destFileName)
4.downloadFile(String sourceFilePathName,String contentType,String destFilePathName,int blockSize)

你可能感兴趣的:(文件上传,组件)