大二第十五次文件上传和下载

文件上传和下载

如何实现文件上传

要实现web开发中的文件上传功能，通常需要完成两步操作，一是在web页面中添加上传输入项，二是在 Servlet 中读取上传文件的数据，并保存到本地硬盘中。
由于大多数文件的上传都是通过表单的形式提交给服务器的，因此，要想在程序中实现文件上传的功能，首先要创建一个用于提交上传文件的表单页面，在页面中需要使用标签在 Web 页面中添加文件上传输入项。
标签的使用需要注意以下两点。
1.必须要设置 input 输入项的 name 属性，否则浏览器将不会发送上传文件的数据。
2.必须将表单页面的 method 属性设置为 post 方式，enctype 属性设置为"multipart/form-data"类型示例代码如下。
<%–指定表单数据的 enctype 属性以及提交方式–%>

<%--指定标记的类型和文件域的名称--%> 选择上传文件：
当浏览器通过表单提交上传文件时，由于文件数据都附带在 HTTP 请求消息体中，并且采用 MIME 类型（多用途互联网邮件扩展类型）进行描述，在后台使用request 对象提供的getlnputStream()方法可以读取到客户端提交过来的数据。但由于用户可能会同时上传多个文件，而在Servlet 端直接读取上传数据，并分别解析出相应的文件数据是一项非常麻烦的工作。为了方便处理用户上传数据,Apache 组织提供了一个开源组件 Commons-FileUpload。 该组件可以方便地将“multipart/form-data”类型请求中的各种表单域解析出来，并实现一个或多个文件的上传，同时也可以限制上传文件的大小等内容。其性能十分优异，使用极其简单。 需要注意的是，在使用 FilieUpload 组件时，要导入 commons-ileuploadjar 和 commons-io.jar 两个 JAR 包,这两个 JAR 包可以去 Apache 官网“http:/lcommons.apache.org/”下载(进 入该网址页面后，在 Apache Commons Proper 下方表格的 Components 列中找到 FieUpload和 I0，单击进入后即可找到下载链接）。 Fieupload 组件是通过 Servet来实现文件上传功能的。

文件上传的相关API

Fileltem接口

Fileltem 接口在Commons-FileUpload组件中被实现，其主要用于封装单个表单字段元素的数据，一个表单字段元素对应一个 Fileltem对象。Commons-FileUpload组件在处理文件上传的过程中，将每一个表单域(包括普通的文本表单域和文件域)封装在一个Fileltem对象中
为了便于讲解，在此将Fileltem接口的实现类称为Fileltem类，Fileltem类实现了Serializabe接口，因此，支持序列化操作。在Fileltem类中定义了许多获取表单字段元素的方法，具体如下。

(1) boolean isFormField()方法
isFormField()方法用于判断 Fileltem类对象封装的数据是一个普通文本表单字段，还是一人文件表单字段，如果是普通文本表单字段，则返回true，否则返回false。
(2)String getName()方法
getName()方法用于获得文件上传字段中的文件名。如果Fileltem类对象对应的是普通文本表单字段，getName()方法将返回 null；否则，只要浏览器将文件的字段信息传递给服务器，getName()方法就会返回一个字符串类型的结果，如：“C:Sunset.jpg”。
需要注意的是，通过不同浏览器上传的文件，获取到的完整路径和名称都是不一样的。例如用户使用IE浏览器上传文件，获取到的就是完整的路径“C:ASunset.jpg”；如果使用其他浏览器比如火狐，获取到的仅仅是文件名，没有路径，如“Sunsetjpg”。
(3) String getFieldName()方法
getFieldName()方法用于获得表单字段元素描述头的name属性值，也是表单标签name属性的值。例如“name=file1”中的“file1”。
(4) void write(File file)方法
write()方法用于将Fileltem对象中保存的主体内容保存到某个指定的文件中。如果 Fileltem对象中的主体内容是保存在某个临时文件中，那么该方法顺利完成后，临时文件有可能会被清除。另外，该方法也可将普通表单字段内容写入到一个文件中，但它主要用于将上传的文件内容保存到本地文件系统中。
(5) String getString()方法
的定义形式。
getSring()方法用于将 Fileltem对象中保存的数据流内容以一个字符串返回，它有两个重载public String getString()
public String gelString(java.lang.String encoding)
在上面重载的两个方法中，前者使用默认的字符集编码将主体内容转换成字符串，后者使用参数指定的字符集编码将主体内容转换成字符串。需要注意的是，如果在读取普通表单字段元素内容时出现中文乱码现象，请调用第2个getString()方法，并为之传递正确的字符集编码名称。
(6)String getContentType()方法
getContentType()方法用于获得上传文件的类型，即表单字段元素描述头属性“Content-Type”的值，如“image/jpeg”。如果 Fileltem类对象对应的是普通表单字段，该方法将返回 null。
(7) boolean isInMemory()方法
isInMemory()方法用来判断 Fileltem 对象封装的数据内容是存储在内存中，还是存储在临时文件中，如果存储在内存中则返回true，否则返回false。
(8) void delete()方法
delete()方法用来清空 Fileltem 类对象中存放的主体内容，如果主体内容被保存在临时文件中，delete()方法将删除该临时文件。需要注意的是，尽管Fileltem对象被垃圾收集器收集时会自动清除临时文件，但应该及时调用delete()方法清除临时文件，从而释放系统存储资源，以防系统出现异常，导致临时文件被永久地保存在硬盘中。
(9)InputStream getInputStream()方法
getinputStream()方法以流的形式返回上传文件的数据内容。
(10) long getSize()方法
getSize()方法返回该上传文件的大小(以字节为单位)。

DiskFileltemFactory类

DiskFileltemFactory类用于将请求消息实体中的每一个文件封装成单独的Fileltem对象。如果上传的文件比较小，将直接保存在内存中，如果上传的文件比较大，则会以临时文件的形式，保存在磁盘的临时文件夹中。默认情况下，文件保存在内存还是硬盘临时文件夹的临界值是10240，即10KB。

DiskFileltemFactory 类的构造方法

DiskFileltemFactory()采用默认临界值和系统临时文件夹构造文件项工厂对象
DiskFileltemFactory(int sizeThre
repository)采用参数指定临界值和系统临时文件夹构造文件项工厂对象。
(1)Fileltem createltem(String fieldName, String contentType,boolean isFormField, String fileName) 方法
该方法用于将请求消息实体创建成Fileltem 类型的实例对象。需要注意的是，该方法是FileUpload组件在解析请求时内部自动调用，无需我们管理。
(2)setSizeThreshold(int sizeThreshold)和getSizeThreshold()方法
setSizeThreshold()方法用于设置是否将上传文件以临时文件的形式保存在磁盘的临界值。当Apache文件上传组件解析上传的数据时，需要将解析后的数据临时保存，以便后续对数据进一步处理。由于Java 虚拟机可使用的内存空间是有限的，因此，需要根据上传文件的大小决定文件的保存位置。例如，一个800MB的文件是无法在内存中临时保存的，这时，Apache文件上传组件可以采用临时文件的方式来保存这些数据。但是，如果上传的文件很小，只有600KB，显然将其保存在内存中是比较好的选择。另外，对应的 getSizeThreshold()方法用来获取此临界值。
(3)setRepository(File repository)和 getRepository()方法
如果上传文件的大小大于 setSizeThreshold()方法设置的临界值，这时，可以采用setRepository()方法，将上传的文件以临时文件的形式保存在指定的目录下。在默认情况下，采用的是系统默认的临时文件路径，可以通过以下方式获取。
System.getProperty(“java.io.tmpdir”)
另外，对应的getRepository()方法用于获取临时文件。

ServletFileltemFactory类的常用方法，如下所示。

(1)setsizemax(long sizemax)和getsizemax()
setsizemax()方法继承自fileuploadbase类，用于设置请求消息实体内容最大尺寸限制在以防止客户端恶意上传超大文件来浪费服务器端的存储空间其中参数sizeMax是以字节为单位另外对应的gatSizeMax()方法用于读取请求消息实体内容所允许的最大值。
(2) setfileSizeMax(long fileSizeMax)和 getFileSizeMax()方法
setFilieSizeMax()方法继承自 FieUploadBase 类，用于设置单个上传文件的最大尺寸限制。以防止客户端恶意上传超大文件来浪费服务器端的存储空间。其中，参数 fleSizeMax 是以字节为单位。另外，对应的 getFileSizeMax()方法用于获取单个上传文件所允许的最大值。

代码及成果展示

package cn.itcast.fileupload;

import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet