Home | History | Annotate | Download | only in http
      1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #ifndef NET_HTTP_HTTP_CONTENT_DISPOSITION_H_
      6 #define NET_HTTP_HTTP_CONTENT_DISPOSITION_H_
      7 
      8 #include <string>
      9 
     10 #include "base/basictypes.h"
     11 #include "net/base/net_export.h"
     12 
     13 namespace net {
     14 
     15 class NET_EXPORT HttpContentDisposition {
     16  public:
     17   enum Type {
     18     INLINE,
     19     ATTACHMENT,
     20   };
     21 
     22   // Properties of the Content-Disposition header. Used for UMA.
     23   enum ParseResultFlags {
     24     INVALID                      = 0,
     25 
     26     // A valid disposition-type is present.
     27     HAS_DISPOSITION_TYPE         = 1 << 0,
     28 
     29     // The disposition-type is not 'inline' or 'attachment'.
     30     HAS_UNKNOWN_DISPOSITION_TYPE = 1 << 1,
     31 
     32     // Has a valid non-empty 'name' attribute.
     33     HAS_NAME                     = 1 << 2,
     34 
     35     // Has a valid non-empty 'filename' attribute.
     36     HAS_FILENAME                 = 1 << 3,
     37 
     38     // Has a valid non-empty 'filename*' attribute.
     39     HAS_EXT_FILENAME             = 1 << 4,
     40 
     41     // The following fields are properties of the 'filename' attribute:
     42 
     43     // Quoted-string contains non-ASCII characters.
     44     HAS_NON_ASCII_STRINGS        = 1 << 5,
     45 
     46     // Quoted-string contains percent-encoding.
     47     HAS_PERCENT_ENCODED_STRINGS  = 1 << 6,
     48 
     49     // Quoted-string contains RFC 2047 encoded words.
     50     HAS_RFC2047_ENCODED_STRINGS  = 1 << 7
     51   };
     52 
     53   HttpContentDisposition(const std::string& header,
     54                          const std::string& referrer_charset);
     55   ~HttpContentDisposition();
     56 
     57   bool is_attachment() const { return type() == ATTACHMENT; }
     58 
     59   Type type() const { return type_; }
     60   const std::string& filename() const { return filename_; }
     61 
     62   // A combination of ParseResultFlags values.
     63   int parse_result_flags() const { return parse_result_flags_; }
     64 
     65  private:
     66   void Parse(const std::string& header, const std::string& referrer_charset);
     67   std::string::const_iterator ConsumeDispositionType(
     68       std::string::const_iterator begin, std::string::const_iterator end);
     69 
     70   Type type_;
     71   std::string filename_;
     72   int parse_result_flags_;
     73 
     74   DISALLOW_COPY_AND_ASSIGN(HttpContentDisposition);
     75 };
     76 
     77 }  // namespace net
     78 
     79 #endif  // NET_HTTP_HTTP_CONTENT_DISPOSITION_H_
     80