查看本类的 API文档回源码主页

   /*
    * Copyright 2012 The Netty Project
    *
    * The Netty Project licenses this file to you under the Apache License,
    * version 2.0 (the "License"); you may not use this file except in compliance
    * with the License. You may obtain a copy of the License at:
    *
    *   http://www.apache.org/licenses/LICENSE-2.0
    *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
   * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
   * License for the specific language governing permissions and limitations
   * under the License.
   */
  package org.jboss.netty.handler.codec.http.multipart;
  
  import org.jboss.netty.handler.codec.http.HttpRequest;
  
  import java.io.IOException;
  import java.nio.charset.Charset;
  import java.util.ArrayList;
  import java.util.List;
  import java.util.Map;
  import java.util.concurrent.ConcurrentHashMap;
  
  /**
   * Default factory giving Attribute and FileUpload according to constructor
   *
   * Attribute and FileUpload could be :<br>
   * - MemoryAttribute, DiskAttribute or MixedAttribute<br>
   * - MemoryFileUpload, DiskFileUpload or MixedFileUpload<br>
   * according to the constructor.
   */
  public class DefaultHttpDataFactory implements HttpDataFactory {
      /**
       * Proposed default MINSIZE as 16 KB.
       */
      public static final long MINSIZE = 0x4000;
      /**
       * Proposed default MAXSIZE = -1 as UNLIMITED
       */
      public static final long MAXSIZE = -1;
  
      private final boolean useDisk;
  
      private final boolean checkSize;
  
      private long minSize;
  
      private long maxSize = MAXSIZE;
  
      /**
       * Keep all HttpDatas until cleanAllHttpDatas() is called.
       */
      private final Map<HttpRequest, List<HttpData>> requestFileDeleteMap =
              new ConcurrentHashMap<HttpRequest, List<HttpData>>();
      /**
       * HttpData will be in memory if less than default size (16KB). No limit setup.
       * The type will be Mixed.
       */
      public DefaultHttpDataFactory() {
          useDisk = false;
          checkSize = true;
          minSize = MINSIZE;
      }
  
      /**
       * HttpData will be always on Disk if useDisk is True, else always in Memory if False.
       * No limit setup.
       */
      public DefaultHttpDataFactory(boolean useDisk) {
          this.useDisk = useDisk;
          checkSize = false;
      }
  
      /**
       * HttpData will be on Disk if the size of the file is greater than minSize, else it
       * will be in memory. The type will be Mixed. No limit setup.
       */
      public DefaultHttpDataFactory(long minSize) {
          useDisk = false;
          checkSize = true;
          this.minSize = minSize;
      }
  
      public void setMaxLimit(long max) {
          this.maxSize = max;
      }
  
      /**
       * @return the associated list of Files for the request
       */
      private List<HttpData> getList(HttpRequest request) {
          List<HttpData> list = requestFileDeleteMap.get(request);
          if (list == null) {
              list = new ArrayList<HttpData>();
              requestFileDeleteMap.put(request, list);
          }
         return list;
     }
 
     public Attribute createAttribute(HttpRequest request, String name) {
         if (useDisk) {
             Attribute attribute = new DiskAttribute(name);
             attribute.setMaxSize(maxSize);
             List<HttpData> fileToDelete = getList(request);
             fileToDelete.add(attribute);
             return attribute;
         }
         if (checkSize) {
             Attribute attribute = new MixedAttribute(name, minSize);
             attribute.setMaxSize(maxSize);
             List<HttpData> fileToDelete = getList(request);
             fileToDelete.add(attribute);
             return attribute;
         }
         MemoryAttribute attribute = new MemoryAttribute(name);
         attribute.setMaxSize(maxSize);
         return attribute;
     }
 
     /**
      * Utility method
      * @param data
      */
     private void checkHttpDataSize(HttpData data) {
         try {
             data.checkSize(data.length());
         } catch (IOException e) {
             throw new IllegalArgumentException("Attribute bigger than maxSize allowed");
         }
     }
 
     public Attribute createAttribute(HttpRequest request, String name, String value) {
         if (useDisk) {
             Attribute attribute;
             try {
                 attribute = new DiskAttribute(name, value);
                 attribute.setMaxSize(maxSize);
             } catch (IOException e) {
                 // revert to Mixed mode
                 attribute = new MixedAttribute(name, value, minSize);
                 attribute.setMaxSize(maxSize);
             }
             checkHttpDataSize(attribute);
             List<HttpData> fileToDelete = getList(request);
             fileToDelete.add(attribute);
             return attribute;
         }
         if (checkSize) {
             Attribute attribute = new MixedAttribute(name, value, minSize);
             attribute.setMaxSize(maxSize);
             checkHttpDataSize(attribute);
             List<HttpData> fileToDelete = getList(request);
             fileToDelete.add(attribute);
             return attribute;
         }
         try {
             MemoryAttribute attribute = new MemoryAttribute(name, value);
             attribute.setMaxSize(maxSize);
             checkHttpDataSize(attribute);
             return attribute;
         } catch (IOException e) {
             throw new IllegalArgumentException(e);
         }
     }
 
     public FileUpload createFileUpload(HttpRequest request, String name, String filename,
             String contentType, String contentTransferEncoding, Charset charset,
             long size) {
         if (useDisk) {
             FileUpload fileUpload = new DiskFileUpload(name, filename, contentType,
                     contentTransferEncoding, charset, size);
             fileUpload.setMaxSize(maxSize);
             checkHttpDataSize(fileUpload);
             List<HttpData> fileToDelete = getList(request);
             fileToDelete.add(fileUpload);
             return fileUpload;
         }
         if (checkSize) {
             FileUpload fileUpload = new MixedFileUpload(name, filename, contentType,
                     contentTransferEncoding, charset, size, minSize);
             fileUpload.setMaxSize(maxSize);
             checkHttpDataSize(fileUpload);
             List<HttpData> fileToDelete = getList(request);
             fileToDelete.add(fileUpload);
             return fileUpload;
         }
         MemoryFileUpload fileUpload = new MemoryFileUpload(name, filename, contentType,
                 contentTransferEncoding, charset, size);
         fileUpload.setMaxSize(maxSize);
         checkHttpDataSize(fileUpload);
         return fileUpload;
     }
 
     public void removeHttpDataFromClean(HttpRequest request, InterfaceHttpData data) {
         if (data instanceof HttpData) {
             List<HttpData> fileToDelete = getList(request);
             fileToDelete.remove(data);
         }
     }
 
     public void cleanRequestHttpDatas(HttpRequest request) {
         List<HttpData> fileToDelete = requestFileDeleteMap.remove(request);
         if (fileToDelete != null) {
             for (HttpData data: fileToDelete) {
                 data.delete();
             }
             fileToDelete.clear();
         }
     }
 
     public void cleanAllHttpDatas() {
         for (HttpRequest request : requestFileDeleteMap.keySet()) {
             List<HttpData> fileToDelete = requestFileDeleteMap.get(request);
             if (fileToDelete != null) {
                 for (HttpData data: fileToDelete) {
                     data.delete();
                 }
                 fileToDelete.clear();
             }
             requestFileDeleteMap.remove(request);
         }
     }
 }