文件上传和下载

学习目标：

1文件如何上传

2.相关的API

3.实现上传

4.实现下载

学习内容：

1文件如何上传

要实现Web开发中的文件上传功能，通常需完成两步操作：一是在Web页面中添加上传输入项；二是在Serviet中读取上传文件的数据，并保存到本地硬盘中。接下来，本节将对这两步操作内容进行详细讲解。
由于大多数文件的上传都是通过表单的形式提交给服务器的，因此，要想在程序中实现文件
上传的功能，首先要创建一个用于提交上传文件的表单页面。在页面中，需要使用<in put type="file">标签在Web页面中添加文件上传输入项。
<input type="file">标签的使用需要注意以下两点。
。必须要设置input输入项的name属性，否则浏览器将不会发送上传文件的数据。
。必须将表单页面的method属性设置为post方式，enctype属性设置为“ multiparli  form-data”类型。
需要注意的是，在使用 FileUpload 组件时，要导入commons- fileupload 、jar和commons-io.jar两个JAR包,这两个JAR包可以去Apache官网“ http://commons.apache.org/ ”下载(进入该网址页面后,在 ApacheCommonsProper 下方表格的 Components 列中找到 FileUpload 和lO,单击进入后即可找到下载链接)。

2.相关的API

一、FileItem接口

Fileltem接口用于封装单个表单字段元素的数据，一个表单字段元素对应一个Fileltem对象。为了便于讲解，在此将Fileltem的实现类称为Fileltem类，Fileltem类实现了Serializable接口，因此，支持序列化操作。在FiIeItem类中人素的方法，具体如下。

1. boolean isFormField()方法

isFormField()方法用于判断FileItem类对象封装的数据是一个普通文本表单字段，还是一个文件表单字段，如果是普通表单字段则返回true，否则返回false。

2.String getName()方法

getName()方法用于获得文件上传字段中的文件名。如果FileItem类对象对应的是普通表单字段，getName()方法将返回null，否则，只要浏览器将文件的字段信息传递给服务器，getName()方法就会返回一个字符串类型的结果，如“C:\Sunset.jpg”。

需要注意的是，通过不同浏览器上传的文件，获取到的完整路径和名称都是不一样的。例如，用户使用IE浏览器上传文件，获取到的就是完整的路径“C:\Sunset.jpg”，如果使用其他浏览器，比如火狐，获取到的仅仅是文件名，没有路径，如“Sunset.jpg”。

3.String getFieldName()方法

getFieldName()方法用于获得表单字段元素描述头的name属性值，也是表单标签name属性的值，例如“name=file1”中的“file1”。

4. void write(File file)方法

write()方法用于将Fileltem对象中保存的主体内容保存到某个指定的文件中。如果FileItem对象中的主体内容是保存在某个临时文件中，那么该方法顺利完成后，临时文件有可能会被清除。另外，该方法也可将普通表单字段内容写入到一个文件中，但它主要用于将上传的文件内容保存到本地文件系统中。

5.String getString()方法

getString()方法用于将Fileltem对象中保存的数据流内容以一个字符串返回，它有两个重载的定义形式;

(1) public String getString(）

(2) public String getString(java.lang.String encoding)

在上面重载的两个方法中，前者使用默认的字符集编码将主体内容转换成字符串，后者使用参数指足的子付集编码将主体内容转换成字符串。需要注意的是，如果在读取普通表单字段无系内谷时出现中文乱码现象，请调用第二个getString)方法，并为之传递正确的字符集编码名称。

倘名外Rssicod.sayThelos oninte .emelblait pait2 )moilelssto molleli

6. String getContentType()方法

getContentType()方法用于获得上传文件的类型，即表单字段元素描述头属性“Content-Type”的值，如"image/jpeg”。如果FileItem类对象对应的是普通表单字段，该方法将返回null。

7.boolean islnMemory()方法

isInMemory()方法用来判断FileItem对象封装的数据内容是存储在内存中，还是存储在临时文件中，如果存储在内存中则返回true，否则返回false。

8. void delete()方法

delete()方法用来清空FileItem类对象中存放的主体内容，如果主体内容被保存在临时文件中，delete()方法将删除该临时文件。需要注意的是，尽管Fileltem对象被垃圾收集器收集时会自动清除临时文件，但应该及时调用delete()方法清除临时文件，从而释放系统存储资源，以防系统出现异常，导致临时文件被永久地保存在硬盘中。

9. InputStream getlnputStream()方法

getInputStream()方法以流的形式返回上传文件的数据内容。

10. long getSize()方法

getSize()方法返回该上传文件的大小(以子节为单)。

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

 Fheltem  createltem ( StringfieldName ,String con tentType,boolean is FormField,St hieName)方法
该方法用于将请求消息实体创建成Filellem类型的实例对象。需要注意的是，该方法是FBeUpkoad组件在解析请求时内部自动调用，无需我们管理。

（2） setSizeThreshold ( intsizeThreshold )和 getSizeThreshold ()方法
setSizeThreshold （）方法用于设置是否将上传文件以临时文件的形式保存在磁盘的临界值。当Apache文件上传组件解析上传的数据时，需要将解析后的数据临时保存，以便后续对数据进一步处理。由于Java虚拟机可使用的内存空间是有限的，因此，需要根据上传文件的大小决定文件的保存位置。例如，一个800MB的文件是无法在内存中临时保存的，这时，Apache文件上传组件可以采用临时文件的方式来保存这些数据。但是，如果上传的文件很小，只有600KB，显然将其保存在内存中是比较好的选择。另外，对应的 getSizeThreshold ()方法用来获取此临界值。
(3) setRepository (File  repository )和 getRepository ()方法
如果上传文件的大小大于 setSizeThreshold ()方法设置的临界值，这时，可以采用 setRepository ()方法，将上传的文件以临时文件的形式保存在指定的目录下。在默认情况下，采用的是系统默认的临时文件路径，可以通过以下方式获取。

3.ServletFileUpload 类
ServletFileUpload

1)  public void setSizeMax(long sizeMax)
        setSizeMax方法继承自FileUploadBase类，用于设置请求消息实体内容（即所有上传数据）的最大尺寸限制，以防止客户端恶意上传超大文件来浪费服务器端的存储空间。其参数是以字节为单位的long型数字。

       在请求解析的过程中，如果请求消息体内容的大小超过了setSizeMax方法的设置值，将会抛出FileUploadBase内部定义的SizeLimitExceededException异常(FileUploadException的子类)。该方法有一个对应的读方法：public long getSizeMax()方法。

2) public void setFileSizeMax(long fileSizeMax)
        setFileSizeMax方法继承自FileUploadBase类，用于设置单个上传文件的最大尺寸限制，以防止客户端恶意上传超大文件来浪费服务器端的存储空间。其参数是以字节为单位的long型数字。该方法有一个对应的读方法：public long geFileSizeMax()方法。

       在请求解析的过程中，如果单个上传文件的大小超过了setFileSizeMax方法的设置值，将会抛出FileUploadBase内部定义的FileSizeLimitExceededException异常(FileUploadException的子类)。

3) public List parseRequest(javax.servlet.http.HttpServletRequest req)
        parseRequest 方法是ServletFileUpload类的重要方法，它是对HTTP请求消息体内容进行解析的入口方法。它解析出FORM表单中的每个字段的数据，并将它们分别包装成独立的FileItem对象，然后将这些FileItem对象加入进一个List类型的集合对象中返回。

       该方法抛出FileUploadException异常来处理诸如文件尺寸过大、请求消息中的实体内容的类型不是“multipart/form-data”、IO异常、请求消息体长度信息丢失等各种异常。每一种异常都是FileUploadException的一个子类型。

4)  public FileItemIterator getItemIterator(HttpServletRequest request)
        getItemIterator方法和parseRequest 方法基本相同。但是getItemIterator方法返回的是一个迭代器，该迭代器中保存的不是FileItem对象，而是FileItemStream 对象，如果你希望进一步提高新能，你可以采用getItemIterator方法，直接获得每一个文件项的数据输入流，做底层处理；如果性能不是问题，你希望代码简单，则采用parseRequest方法即可。

5) public stiatc boolean isMultipartContent(HttpServletRequest req)
        isMultipartContent方法方法用于判断请求消息中的内容是否是“multipart/form-data”类型，是则返回true，否则返回false。isMultipartContent方法是一个静态方法，不用创建ServletFileUpload类的实例对象即可被调用。

6) getFileItemFactory()和setFileItemFactory(FileItemFactory)
       方法继承自FileUpload类，用于设置和读取fileItemFactory属性。

7) public void setProgressListener(ProgressListener pListener)
      设置文件上传进度监听器。该方法有一个对应的读取方法：ProgressListener getProgressListener()。

8) public void setHeaderEncoding()
       在文件上传请求的消息体中，除了普通表单域的值是文本内容以外，上传文件中的文件路径名也是文本（包括文件名），在内存中保存的是它们的某种字符集编码的字节数组，Apache文件上传组件在读取这些内容时，必须知道它们所采用的字符集编码，才能将它们转换成正确的字符文本返回。

        setHeaderEncoding方法继承自FileUploadBase类，用于设置上面提到的字符编码。如果没有设置，则对应的读方法getHeaderEncoding()方法返回null，将采用HttpServletRequest设置的字符编码，如果HttpServletRequest的字符编码也为null，则采用系统默认字符编码。可以通过一下语句获得系统默认字符编码：

         System.getProperty("file.encoding"));

3.实现上传

创建项目，导入jar包

在Eclipse中创建一个名称为chapter12的Web项目，在项目的WEB-INF/Iib目录下导入JAR包commons- fileupload -1.3.1. jar和commons-io-2.4jar,并发布到类路径下。

 2.创建上传页面

在chapter12项目的 WebContent 目录下创建一个名称为form的jsp页面，该页面用于播供文件上传的Form表单，需要注意的是，Form表单的enctype属性值要设置为“multipart\form-data”，method属性值要设置为“post”，并将其action的属性值设置为“ UploadServie  form.jsp

 3.创建Servlet
在项目的src目录下创建一个名称为enitoast/fleupload的包，在该包中编写一个名称为 UplaadSenvlet 的类，该类主要用于获取表单及其上传文件的信息

 

 4.启动项目查看结果

 

 

 文件下载

实现文件下载功能比较简单，通常情况下，不需要使用第三方组件实现，而是直接使用Serv/let类和输入／输出流实现。与访问服务器文件不同的是，要实现文件的下载，不仅需要指定文件的路径，还需要在HTTP协议中设置两个响应消息头，具体如下。
(7)设定接收程序处理数据的方式
Content- Disposition ; attachment ;filename=
设定实体内容的MIME类型
Content-Type: application /x- msdownload
浏览器通常会直接处理响应的实体内容，需要在HTTP响应消息中设置两个响应消息头宇段,用来指定接收程序处理数据内容的方式为下载方式。当单击【下载】超链接时,系统将请求提交到对应的Serviet。在该Servilet中，首先获取下载文件的地址，并根据该地址创建文件字节输入流，然后通过该流读取下载的文件内容，最后将读取的内容通过输出流写到目标文件中。

4.实现下载

【实现步骤】
1.创建下载页面
在chapter12项目的 WebContent 目录下创建下载页面download. jsp，该页面中编写用于下载的链接

 2.创建Servlet在cn.tcast.fleupload包中创建 DownloadServlet 类，该类主要用于设置所要下载的文件以及文件在浏览器中的打开方式

 创建下载目录及文件
在项目的 WebContent 目录下创建一个名称为download的文件夹(Folder)，在该文件夹中放置一个名称为“1. jpg”的图片文件

启动项目查看结果：

解决下载中中文文件乱码问题 

将文件名称1.JPG改为风景.JPG

实现步骤：

1.修改Servlet类
使用 URLEncoder 类的encode(String s，String enc)方法对文件12- 4DownioadServlet  ava进行改写。

2.修改下载页面
在文件12-3 download，jsp中，同样使用 URLEncoder 类的encode(String s，String ena)方法对下载地址中的中文进行编码

3.运行项目，查看结果
重新启动Tomcat服务器,再次访问download.jsp页面,单击【文件下载】链接后

2020080605009