与文件上传到的三个类：FileItem类、ServletFileUpload 类、DiskFileItemFactory类

文件上传：

ServletFileUpload负责处理上传的文件数据,并将表单中每一个输入项封装成一个FileItem对象中， 在使用ServletFileUpload对象解析请求时须要根据DiskFileItemFactory对象的属性sizeThreshold（临界值）和repository（临时目录）来决定将解析获得的数据保存在内存仍是临时文件中，若是是临时文件，保存在哪一个临时目录中？。因此，咱们须要在进行解析工做前构造好DiskFileItemFactory对象，经过ServletFileUpload对象的构造方法或setFileItemFactory()方法设置ServletFileUpload对象的fileItemFactory属性。

简单点就是：ServletFileUpload和DiskFileItemFactory是成对出现的，ServletFileUpload负责解析请求，而解析后的对象存放位置（内存仍是临时文件形式）是经过，setFileItemFactory属性或者是构造函数来设定

FileItem类

在HTML页面input  必须有 name  <input type="file" name="filename">

表单若是包含一个文件上传输入项的话，这个表单的enctype属性就必须设置为multipart/form-data

<form action ="/day16/servlet/UpLoadServlet" enctype="multipart/form-data" method="post">

浏览器表单的类型若是为multipart/form-data,那么浏览器在提交表单数据时，它将采用MIME协议对数据进行封装后提交，在服务器这端也将不能采用

原来传统的方工获取数据了。在服务器端想获取数据就要经过流。request提供了一个getInputStream读取流。

FileItem类的经常使用方法：

1.  boolean isFormField()

        isFormField方法用于判断FileItem类对象封装的数据是一个普通文本表单字段，仍是一个文件表单字段，若是是普通表单字段则返回true，不然返回false。所以，可使用该方法判断是否为普通表单域，仍是文件上传表单域。

2.  String getName()
       getName方法用于得到文件上传字段中的文件名。

       注意IE或FireFox中获取的文件名是不同的，IE中是绝对路径，FireFox中只是文件名。

3.  String getFieldName()
      getFieldName方法用于返回表单标签name属性的值。如上例中<input type="text" name="column" />的value。

4.  void write(File file)

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

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

      public Java.lang.String getString()

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

             throws java.io.UnsupportedEncodingException

        前者使用缺省的字符集编码将主体内容转换成字符串，后者使用参数指定的字符集编码将主体内容转换成字符串。若是在读取普通表单字段元素的内容时出现了中文乱码现象，请调用第二个getString方法，并为之传递正确的字符集编码名称。

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

7.  boolean isInMemory()
        isInMemory方法用来判断FileItem对象封装的数据内容是存储在内存中，仍是存储在临时文件中，若是存储在内存中则返回true，不然返回false。

8.  void delete()
       delete方法用来清空FileItem类对象中存放的主体内容，若是主体内容被保存在临时文件中，delete方法将删除该临时文件。

        尽管当FileItem对象被垃圾收集器收集时会自动清除临时文件，但及时调用delete方法能够更早的清除临时文件，释放系统存储资源。另外，当系统出现异常时，仍有可能形成有的临时文件被永久保存在了硬盘中。

9.  InputStream getInputStream()
    以流的形式返回上传文件的数据内容。

10. long getSize()
      返回该上传文件的大小（以字节为单位）。

为了方便用户处理文件上传数据，Apache开源组织提供了一个用来处理表单文件上传的一个开源组件(Commons-fileupload).使用Commons-fileupload组件实现文件上传,须要导入该组件相应的jar包.

Commons-fileupload和commons-io两个jar包.

DiskFileItemFactory是建立FileItem对象的工厂包括方法:

1.public void setSizeThreshold(int?sizeThreshold) 
设置内存缓冲区的大小,默认值为10K,若是文件大于10K,将使用临时文件缓

存上传文件.

2.public void setRepository(Java.io.File repository)
指定临时文件目录

3.public DiskFileItemFactory();

 

 

ServletFileUpload 类

ServletFileUpload负责处理上传的文件数据,并将表单中每一个输入项封装成一个FileItem对象中.

org.apache.commons.fileupload.servlet.ServletFileUpload类是Apache文件上传组件处理文件上传的核心高级类（所谓高级就是不须要管底层实现，暴露给用户的简单易用的接口）。

使用其parseRequest(HttpServletRequest) 方法能够将经过表单中每个HTML标签提交的数据封装成一个FileItem对象，而后以List列表的形式返回。使用该方法处理上传文件简单易用。

 若是你但愿进一步提升新能，你能够采用 getItemIterator 方法，直接得到每个文件项的数据输入流，对数据作直接处理。

 在使用ServletFileUpload对象解析请求时须要根据DiskFileItemFactory对象的属性sizeThreshold（临界值）和repository（临时目录）来决定将解析获得的数据保存在内存仍是临时文件中，若是是临时文件，保存      在哪一个临时目录中？。因此，咱们须要在进行解析工做前构造好DiskFileItemFactory对象，经过ServletFileUpload对象的构造方法或setFileItemFactory()方法设置ServletFileUpload对象的fileItemFactory属性。

 

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"));

 

DiskFileItemFactory类

 

 

 将请求消息实体中的每个项目封装成单独的DiskFileItem (FileItem接口的实现) 对象的任务
由 org.apache.commons.fileupload.FileItemFactory 接口的默认实现 
org.apache.commons.fileupload.disk.DiskFileItemFactory 来完成。当上传的文件项目比较小时，直接保存在内存中（速度比较快），比较大时，以临时文件的形式，保存在磁盘临时文件夹（虽然速度慢些，可是内存资源是有限的）。

属性
1) public static final int DEFAULT_SIZE_THRESHOLD ：将文件保存在内存仍是磁盘临时文件夹的默认临界值，值为10240，即10kb。

2) private File repository：用于配置在建立文件项目时，当文件项目大于临界值时使用的临时文件夹，默认采用系统默认的临时文件路径，能够经过系统属性 java.io.tmpdir获取。以下代码：

System.getProperty("java.io.tmpdir");

3) private int sizeThreshold：用于保存将文件保存在内存仍是磁盘临时文件夹的临界值

构造方法
1) public DiskFileItemFactory()

      采用默认临界值和系统临时文件夹构造文件项工厂对象。

2) public DiskFileItemFactory(int sizeThreshold,File repository)

      采用参数指定临界值和系统临时文件夹构造文件项工厂对象。

3) FileItem createItem() 
       根据DiskFileItemFactory相关配置将每个请求消息实体项目建立成DiskFileItem 实例，并返回。该方法历来不须要咱们亲自调用，FileUpload组件在解析请求时内部使用。

4) void setSizeThreshold(int sizeThreshold)
        Apache文件上传组件在解析上传数据中的每一个字段内容时，须要临时保存解析出的数据，以便在后面进行数据的进一步处理（保存在磁盘特定位置或插入数据库）。由于Java虚拟机默承认以使用的内存空间是有限的，超出限制时将会抛出“java.lang.OutOfMemoryError”错误。若是上传的文件很大，例如800M的文件，在内存中将没法临时保存该文件内容，Apache文件上传组件转而采用临时文件来保存这些数据；但若是上传的文件很小，例如600个字节的文件，显然将其直接保存在内存中性能会更加好些。

        setSizeThreshold方法用于设置是否将上传文件已临时文件的形式保存在磁盘的临界值（以字节为单位的int值），若是从没有调用该方法设置此临界值，将会采用系统默认值10KB。对应的getSizeThreshold() 方法用来获取此临界值。

5) void setRepository(File repository)
        setRepositoryPath方法用于设置当上传文件尺寸大于setSizeThreshold方法设置的临界值时，将文件以临时文件形式保存在磁盘上的存放目录。有一个对应的得到临时文件夹的 File getRespository() 方法。

         注意：当从没有调用此方法设置临时文件存储目录时，默认采用系统默认的临时文件路径，能够经过系统属性 java.io.tmpdir 获取。以下代码：

System.getProperty("java.io.tmpdir");

Tomcat系统默认临时目录为“<tomcat安装目录>/temp/”。