Rewrite clipboard write IPC handling to be easier to understand.

ui/base/clipboard/clipboard.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef UI_BASE_CLIPBOARD_CLIPBOARD_H_
 #define UI_BASE_CLIPBOARD_CLIPBOARD_H_
 
 #include <map>
 #include <string>
 #include <vector>
@@ skipping 14 matching lines @@
 #endif
 
 namespace base {
 class FilePath;
 
 namespace win {
 class MessageWindow;
 }  // namespace win
 }  // namespace base
 
-// TODO(dcheng): Temporary until the IPC layer doesn't use WriteObjects().
-namespace content {
-class ClipboardMessageFilter;
-}
-
 namespace gfx {
 class Size;
 }
 
 class SkBitmap;
 
 #ifdef __OBJC__
 @class NSString;
 #else
 class NSString;
@@ skipping 61 matching lines @@
 #elif defined(OS_MACOSX)
     explicit FormatType(NSString* native_format);
     NSString* data_;
 #else
 #error No FormatType definition.
 #endif
 
     // Copyable and assignable, since this is essentially an opaque value type.
   };
 
-  // TODO(dcheng): Make this private once the IPC layer no longer needs to
-  // serialize this information.
-  // ObjectType designates the type of data to be stored in the clipboard. This
-  // designation is shared across all OSes. The system-specific designation
-  // is defined by FormatType. A single ObjectType might be represented by
-  // several system-specific FormatTypes. For example, on Linux the CBF_TEXT
-  // ObjectType maps to "text/plain", "STRING", and several other formats. On
-  // windows it maps to CF_UNICODETEXT.
-  enum ObjectType {
-    CBF_TEXT,
-    CBF_HTML,
-    CBF_RTF,
-    CBF_BOOKMARK,
-    CBF_WEBKIT,
-    CBF_SMBITMAP,  // Bitmap from shared memory.
-    CBF_DATA,  // Arbitrary block of bytes.
-  };
-
-  // ObjectMap is a map from ObjectType to associated data.
-  // The data is organized differently for each ObjectType. The following
-  // table summarizes what kind of data is stored for each key.
-  // * indicates an optional argument.
-  //
-  // Key           Arguments    Type
-  // -------------------------------------
-  // CBF_TEXT      text         char array
-  // CBF_HTML      html         char array
-  //               url*         char array
-  // CBF_RTF       data         byte array
-  // CBF_BOOKMARK  html         char array
-  //               url          char array
-  // CBF_WEBKIT    none         empty vector
-  // CBF_SMBITMAP  shared_mem   A pointer to an unmapped base::SharedMemory
-  //                            object containing the bitmap data. The bitmap
-  //                            data should be premultiplied.
-  //               size         gfx::Size struct
-  // CBF_DATA      format       char array
-  //               data         byte array
-  typedef std::vector<char> ObjectMapParam;
-  typedef std::vector<ObjectMapParam> ObjectMapParams;
-  typedef std::map<int /* ObjectType */, ObjectMapParams> ObjectMap;
-
   static bool IsSupportedClipboardType(int32 type) {
     switch (type) {
       case CLIPBOARD_TYPE_COPY_PASTE:
         return true;
 #if !defined(OS_WIN) && !defined(OS_MACOSX) && !defined(OS_CHROMEOS)
       case CLIPBOARD_TYPE_SELECTION:
         return true;
 #endif
     }
     return false;
@@ skipping 87 matching lines @@
   static const FormatType& GetWebKitSmartPasteFormatType();
   // Win: MS HTML Format, Other: Generic HTML format
   static const FormatType& GetHtmlFormatType();
   static const FormatType& GetRtfFormatType();
   static const FormatType& GetBitmapFormatType();
   // TODO(raymes): Unify web custom data and pepper custom data:
   // crbug.com/158399.
   static const FormatType& GetWebCustomDataFormatType();
   static const FormatType& GetPepperCustomDataFormatType();
 
-  // Embeds a pointer to a SharedMemory object pointed to by |bitmap_handle|
-  // belonging to |process| into a shared bitmap [CBF_SMBITMAP] slot in
-  // |objects|.  The pointer is deleted by DispatchObjects().
-  //
-  // On non-Windows platforms, |process| is ignored.
-  static bool ReplaceSharedMemHandle(ObjectMap* objects,
-                                     base::SharedMemoryHandle bitmap_handle,
-                                     base::ProcessHandle process)
-      WARN_UNUSED_RESULT;
 #if defined(OS_WIN)
   // Firefox text/html
   static const FormatType& GetTextHtmlFormatType();
   static const FormatType& GetCFHDropFormatType();
   static const FormatType& GetFileDescriptorFormatType();
   static const FormatType& GetFileContentZeroFormatType();
   static const FormatType& GetIDListFormatType();
 #endif
 
  protected:
   static Clipboard* Create();
 
   Clipboard() {}
   virtual ~Clipboard() {}
 
+  // ObjectType designates the type of data to be stored in the clipboard. This
+  // designation is shared across all OSes. The system-specific designation
+  // is defined by FormatType. A single ObjectType might be represented by
+  // several system-specific FormatTypes. For example, on Linux the CBF_TEXT
+  // ObjectType maps to "text/plain", "STRING", and several other formats. On
+  // windows it maps to CF_UNICODETEXT.
+  enum ObjectType {
+    CBF_TEXT,
+    CBF_HTML,
+    CBF_RTF,
+    CBF_BOOKMARK,
+    CBF_WEBKIT,
+    CBF_SMBITMAP,  // Bitmap from shared memory.
+    CBF_DATA,      // Arbitrary block of bytes.
+  };
+
+  // ObjectMap is a map from ObjectType to associated data.
+  // The data is organized differently for each ObjectType. The following
+  // table summarizes what kind of data is stored for each key.
+  // * indicates an optional argument.
+  //
+  // Key           Arguments    Type
+  // -------------------------------------
+  // CBF_TEXT      text         char array
+  // CBF_HTML      html         char array
+  //               url*         char array
+  // CBF_RTF       data         byte array
+  // CBF_BOOKMARK  html         char array
+  //               url          char array
+  // CBF_WEBKIT    none         empty vector
+  // CBF_SMBITMAP  bitmap       A pointer to a SkBitmap. The caller must ensure
+  //                            the SkBitmap remains live for the duration of
+  //                            the WriteObjects call.
+  // CBF_DATA      format       char array
+  //               data         byte array
+  typedef std::vector<char> ObjectMapParam;
+  typedef std::vector<ObjectMapParam> ObjectMapParams;
+  typedef std::map<int /* ObjectType */, ObjectMapParams> ObjectMap;
+
   // Write a bunch of objects to the system clipboard. Copies are made of the
   // contents of |objects|.
   virtual void WriteObjects(ClipboardType type, const ObjectMap& objects) = 0;
 
   void DispatchObject(ObjectType type, const ObjectMapParams& params);
 
   virtual void WriteText(const char* text_data, size_t text_len) = 0;
 
   virtual void WriteHTML(const char* markup_data,
                          size_t markup_len,
                          const char* url_data,
                          size_t url_len) = 0;
 
   virtual void WriteRTF(const char* rtf_data, size_t data_len) = 0;
 
   virtual void WriteBookmark(const char* title_data,
                              size_t title_len,
                              const char* url_data,
                              size_t url_len) = 0;
 
   virtual void WriteWebSmartPaste() = 0;
 
   virtual void WriteBitmap(const SkBitmap& bitmap) = 0;
 
   virtual void WriteData(const FormatType& format,
                          const char* data_data,
                          size_t data_len) = 0;
 
  private:
-  template <typename T>
-  friend class ClipboardTest;
   // For access to WriteObjects().
-  // TODO(dcheng): Remove the temporary exception for content.
-  friend class content::ClipboardMessageFilter;
   friend class ScopedClipboardWriter;
   friend class TestClipboard;
 
   // A list of allowed threads. By default, this is empty and no thread checking
   // is done (in the unit test case), but a user (like content) can set which
   // threads are allowed to call this method.
   typedef std::vector<base::PlatformThreadId> AllowedThreadsVector;
   static base::LazyInstance<AllowedThreadsVector> allowed_threads_;
 
   // Mapping from threads to clipboard objects.
   typedef std::map<base::PlatformThreadId, Clipboard*> ClipboardMap;
   static base::LazyInstance<ClipboardMap> clipboard_map_;
 
   // Mutex that controls access to |g_clipboard_map|.
   static base::LazyInstance<base::Lock>::Leaky clipboard_map_lock_;
 
   DISALLOW_COPY_AND_ASSIGN(Clipboard);
 };
 
 }  // namespace ui
 
 #endif  // UI_BASE_CLIPBOARD_CLIPBOARD_H_