文件上传就是对文件进行读写，需要编写大量的代码来实现，而且容易发生异常。幸运的是，有很多实用的工具，可以帮助我们实现文件上传的功能，其中应用比较多的是 Commons-FileUpload 组件。本节我们在 JSP 中使用 Commons-FileUpload 组件来实现文件上传。

　　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：用于向服务器传递大量文本数据，适用于电子邮件的应用。

开课吧广场-人才学习交流平台