Extension ports devtools remote service....

chrome/browser/extensions/extension_message_service.h

 // Copyright (c) 2009 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 CHROME_BROWSER_EXTENSIONS_EXTENSION_MESSAGE_SERVICE_H_
 #define CHROME_BROWSER_EXTENSIONS_EXTENSION_MESSAGE_SERVICE_H_
 
 #include <map>
 #include <set>
 #include <string>
 
 #include "base/linked_ptr.h"
 #include "base/lock.h"
 #include "base/ref_counted.h"
 #include "chrome/common/notification_registrar.h"
 #include "ipc/ipc_message.h"
 
 class MessageLoop;
 class Profile;
 class RenderProcessHost;
 class ResourceMessageFilter;
+class TabContents;
 class URLRequestContext;
 
 // This class manages message and event passing between renderer processes.
 // It maintains a list of processes that are listening to events and a set of
 // open channels.
 //
 // Messaging works this way:
 // - An extension-owned script context (like a toolstrip or a content script)
 // adds an event listener to the "onConnect" event.
 // - Another context calls "extension.connect()" to open a channel to the
@@ skipping 43 matching lines @@
   // the other side.
   void CloseChannel(int port_id);
 
   // Sends a message from a renderer to the given port.
   void PostMessageFromRenderer(int port_id, const std::string& message);
 
   // Send an event to every registered extension renderer.
   void DispatchEventToRenderers(
       const std::string& event_name, const std::string& event_args);
 
-  // Given an extension's ID, opens a channel between the given automation
-  // "port" and that extension.  Returns a channel ID to be used for posting
-  // messages between the processes, or -1 if the extension doesn't exist.
-  int OpenAutomationChannelToExtension(int source_process_id,
-                                       int routing_id,
-                                       const std::string& extension_id,
-                                       const std::string& channel_name,
-                                       IPC::Message::Sender* source);
+  // Given an extension ID, opens a channel between the given
+  // automation "port" or DevTools service and that extension. the
+  // channel will be open to the extension process hosting the
+  // background page and tool strip.
+  //
+  // Returns a port ID to be used for posting messages between the
+  // processes, or -1 if the extension doesn't exist.
+  int OpenSpecialChannelToExtension(
+      const std::string& extension_id, const std::string& channel_name,
+      IPC::Message::Sender* source);
+
+  // Given an extension ID, opens a channel between the given DevTools
+  // service and the content script for that extension running in the
+  // designated tab.
+  //
+  // Returns a port ID identifying the DevTools end of the channel, to
+  // be used for posting messages. May return -1 on failure, although
+  // the code doesn't detect whether the extension actually exists.
+  int OpenSpecialChannelToTab(
+      const std::string& extension_id, const std::string& channel_name,
+      TabContents* target_tab_contents, IPC::Message::Sender* source);
 
   // --- IO thread only:
 
   // Given an extension's ID, opens a channel between the given renderer "port"
   // and every listening context owned by that extension.  Returns a port ID
   // to be used for posting messages between the processes.  |channel_name| is
   // an optional identifier for use by extension developers.
   // This runs on the IO thread so that it can be used in a synchronous IPC
   // message.
   int OpenChannelToExtension(int routing_id, const std::string& extension_id,
@@ skipping 27 matching lines @@
   // opened.
   void OpenChannelToExtensionOnUIThread(
     int source_process_id, int source_routing_id, int receiver_port_id,
     const std::string& extension_id, const std::string& channel_name);
 
   void OpenChannelToTabOnUIThread(
     int source_process_id, int source_routing_id, int receiver_port_id,
     int tab_id, const std::string& extension_id,
     const std::string& channel_name);
 
-  // Common between OpenChannelOnUIThread and OpenAutomationChannelToExtension.
+  // Common between OpenChannelOnUIThread and OpenSpecialChannelToExtension.
   bool OpenChannelOnUIThreadImpl(
-    IPC::Message::Sender* source, int source_process_id, int source_routing_id,
-    const MessagePort& receiver, int receiver_port_id,
-    const std::string& extension_id, const std::string& channel_name);
+      IPC::Message::Sender* source, TabContents* source_contents,
+      const MessagePort& receiver, int receiver_port_id,
+      const std::string& extension_id, const std::string& channel_name);
 
   // NotificationObserver interface.
   void Observe(NotificationType type,
                const NotificationSource& source,
                const NotificationDetails& details);
 
   // An IPC sender that might be in our list of channels has closed.
   void OnSenderClosed(IPC::Message::Sender* sender);
 
   Profile* profile_;
@@ skipping 13 matching lines @@
   int next_port_id_;
 
   // Protects the next_port_id_ variable, since it can be
   // used on the IO thread or the UI thread.
   Lock next_port_id_lock_;
 
   DISALLOW_COPY_AND_ASSIGN(ExtensionMessageService);
 };
 
 #endif  // CHROME_BROWSER_EXTENSIONS_EXTENSION_MESSAGE_SERVICE_H_