Generating CIDs in Blink during MHTML serialization.

third_party/WebKit/Source/platform/mhtml/MHTMLParser.h

 /*
  * Copyright (C) 2011 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 15 matching lines @@
  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
 #ifndef MHTMLParser_h
 #define MHTMLParser_h
 
 #include "platform/SharedBufferChunkReader.h"
 #include "platform/heap/Handle.h"
+#include "platform/weborigin/KURL.h"
 #include "wtf/RefPtr.h"
 #include "wtf/Vector.h"
 
 namespace WTF {
 class String;
 }
 
 namespace blink {
 
 class ArchiveResource;
 class MHTMLArchive;
 class MIMEHeader;
 class SharedBuffer;
 
 class PLATFORM_EXPORT MHTMLParser final {
     STACK_ALLOCATED();
 public:
     explicit MHTMLParser(SharedBuffer*);
 
     PassRefPtrWillBeRawPtr<MHTMLArchive> parseArchive();
 
     size_t frameCount() const;
     MHTMLArchive* frameAt(size_t) const;
 
     size_t subResourceCount() const;
     ArchiveResource* subResourceAt(size_t) const;
 
+    // Translates |contentIDFromMimeHeader| (of the form "<foo@bar.com>")
+    // into a cid-scheme URI (of the form "cid:foo@bar.com").
+    //
+    // Returns KURL() - an invalid URL - if contentID is invalid.
+    //
+    // See rfc2557 - section 8.3 - "Use of the Content-ID header and CID URLs".
+    static KURL convertContentIDToURI(const String& contentID);
+
 private:
     PassRefPtrWillBeRawPtr<MHTMLArchive> parseArchiveWithHeader(MIMEHeader*);
     PassRefPtrWillBeRawPtr<ArchiveResource> parseNextPart(const MIMEHeader&, const String& endOfPartBoundary, const String& endOfDocumentBoundary, bool& endOfArchiveReached);
 
     void addResourceToArchive(ArchiveResource*, MHTMLArchive*);
 
     SharedBufferChunkReader m_lineReader;
     WillBeHeapVector<RefPtrWillBeMember<ArchiveResource>> m_resources;
     WillBeHeapVector<RefPtrWillBeMember<MHTMLArchive>> m_frames;
 };
 
 }
 
 #endif