Headless: Support sending and receiving of raw protocol messages

headless/public/headless_devtools_client.h

 // Copyright 2016 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 HEADLESS_PUBLIC_HEADLESS_DEVTOOLS_CLIENT_H_
 #define HEADLESS_PUBLIC_HEADLESS_DEVTOOLS_CLIENT_H_
 
 #include <memory>
 
 #include "base/macros.h"
@@ skipping 128 matching lines @@
   virtual network::Domain* GetNetwork() = 0;
   virtual page::Domain* GetPage() = 0;
   virtual profiler::Domain* GetProfiler() = 0;
   virtual rendering::Domain* GetRendering() = 0;
   virtual runtime::Domain* GetRuntime() = 0;
   virtual security::Domain* GetSecurity() = 0;
   virtual service_worker::Domain* GetServiceWorker() = 0;
   virtual target::Domain* GetTarget() = 0;
   virtual tracing::Domain* GetTracing() = 0;
 
+  class HEADLESS_EXPORT RawProtocolListener {
+   public:
+    RawProtocolListener() {}
+    virtual ~RawProtocolListener() {}
+
+    virtual void OnProtocolMessage(

[Sami, 2017/04/12 14:54:24]

This feels a little asymmetric since you send a string but get back both a
string and a dict. How about we make call this as the first thing with just the
raw string and have it return true/false to choose whether the built-in callback
gets called or not?

[alex clarke (OOO till 29th), 2017/04/13 10:46:28]

As discussed offline we added void SendRawDevToolsMessage(const
base::DictionaryValue* message). 

+        const std::string& json_message,
+        const base::DictionaryValue* parsed_message) = 0;
+
+   private:
+    DISALLOW_COPY_AND_ASSIGN(RawProtocolListener);
+  };
+
+  virtual void SetRawProtocolListener(
+      RawProtocolListener* raw_protocol_listener) = 0;
+
+  // The id within the |json_message| must be odd to prevent collisions.
+  virtual void SendRawDevtoolsMessage(const std::string& json_message) = 0;

[Sami, 2017/04/12 14:54:24]

s/Devtools/DevTools/

[alex clarke (OOO till 29th), 2017/04/13 10:46:28]

Done.

+
   // TODO(skyostil): Add notification for disconnection.
 
  private:
   friend class HeadlessDevToolsClientImpl;
 
   HeadlessDevToolsClient() {}
 
   DISALLOW_COPY_AND_ASSIGN(HeadlessDevToolsClient);
 };
 
 }  // namespace headless
 
 #endif  // HEADLESS_PUBLIC_HEADLESS_DEVTOOLS_CLIENT_H_