文件上传就是对文件进行读写,需要编写大量的代码来实现,而且容易发生异常。幸运的是,有很多实用的工具,可以帮助我们实现文件上传的功能,其中应用比较多的是 Commons-FileUpload 组件。本节我们在 JSP 中使用 Commons-FileUpload 组件来实现文件上传。
Commons-FileUpload 组件具有以下特点:
Commons-FileUpload 组件依赖于 FileUpload 和 Commons,需要 commons-fileupload-xx.jar 和 commons-io-xx.jar 文件。
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) | 设置临时文件存放的目录 |