Commons-FileUpload 组件具有以下特点:
利用大略:Commons-FileUpload 可以内嵌到 JSP 页面中,以是只须要编写少量的代码就可以完成文件的上传功能。
能够全程掌握上传内容:利用 Commons-FileUpload 组件供应的工具及操作方法,可以得到上传文件的信息,即文件名称、类型和大小等。
能够掌握上传文件的大小和类型:为了避免在上传过程中涌现非常数据,Commons-FileUpload 组件供应了相应的方法来掌握上传文件。
Commons-FileUpload 组件依赖于 FileUpload 和 Commons,须要 commons-fileupload-xx.jar 和 commons-io-xx.jar 文件。
commons-fileupload-xx.jar 下载地址:https://commons.apache.org/fileupload/
commons-io-xx.jar 下载地址:https://commons.apache.org/io/
Commons-FileUpload组件API下面我们先容一下 Commons-FileUpload 组件的接口和实现类。
1. ServletFileUpload类
ServletFileUpload 类用于实现文件上传操作,常用方法如下:
方 法
说 明
public void setSizeMax(long sizeMax)
设置上传文件总量的最大值 (包含文件和表单数据)
public List parseRequest(HttpServletRequest req)
解析 form 表单提交的数据,返回一个 FileItem 实例的凑集
public static final boolean isMultipartContent(HttpServletRequest req)
判断要求信息中的内容是否是”multipart/form-data“类型,是则返回 true,否则返回 false。
public void setHeaderEncoding(String encoding)
设置转换时所利用的字符集编码
2. FileItem接口
FileItem 接口用于封装单个表单字段元素的数据,一个表单字段对应一个 FileItem 实例,本节示例中利用的是实在现类 DiskFileItem。FileItem 接供词给的常用方法如下:
方 法
说 明
public boolean isFormField()
用于判断 FileItem 类工具封装的数据是一个普通文本表单字段,还是一个文件表单字段,如果是普通表单字段则返回 true,否则返回 false。因此,可以利用该方法判断是否为普通表单域,还是文件上传表单域。
public String getName()
获取文件上传的文件名
public String getFieldName()
返回表单字段元素的 name 属性值
public long getSize()
获取上传文件的大小
public String getString()
将 FileItem 工具中保存的主体内容以一个字符串返回。其重载方法 public String getString(String encoding) 中的参数用指定的字符集编码办法
public void write()
将 FileItem 工具中保存的主体内容保存到指定的文件中。
3. FileItemFactory接口与实现类
创建 ServletFileUpload 实例须要依赖 FileItemFactory 工厂接口。DiskFileItemFactory 是 FileItemFactory 接口的实现类,该类的常用方法如下。
方 法
说 明
public void setSizeThreshold(int sizeThreshold)
设置内存缓冲区的大小
public void setRepository(String path)
设置临时文件存放的目录
JSP上传文件JSP 和 HTML Form 标签一起利用,来许可用户把文件上传到做事器。上传的文件可以是文本文件、图像文件或其它任何文档。
创建上传文件表单时,须要把稳以下几点:
表单的 method 属性必须设置为 POST 方法,不能利用 GET 方法。
表单 enctype 属性应设置为 multipart/form-data。
表单 action 属性应设置为对应的 Servlet,用来处理文件上传的逻辑代码,下面示例中利用 FileUploadServlet 处理逻辑。
利用 标签上传单个文件,属性 type="file"。上传多个文件需添加多个 标签。
拓展
表单的 enctype 属性有以下 3 个值:
1、application/x-www-form-urlencoded:默认值,用于处理少量文本数据的通报。向做事器发送大量的文件或二进制数据时,效率很低。
2、multipart/form-data:上传二进制数据,只有利用了 multipart/form-data 才能完全的通报文件数据,进行上传操作。
3、text/plain:用于向做事器通报大量文本数据,适用于电子邮件的运用。
开课吧广场-人才学习互换平台