OLD | NEW |
1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 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 | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef CONTENT_PUBLIC_BROWSER_DEVTOOLS_HTTP_HANDLER_H_ | 5 #ifndef CONTENT_PUBLIC_BROWSER_DEVTOOLS_HTTP_HANDLER_H_ |
6 #define CONTENT_PUBLIC_BROWSER_DEVTOOLS_HTTP_HANDLER_H_ | 6 #define CONTENT_PUBLIC_BROWSER_DEVTOOLS_HTTP_HANDLER_H_ |
7 | 7 |
8 #include <string> | 8 #include <string> |
9 | 9 |
10 #include "base/files/file_path.h" | 10 #include "base/files/file_path.h" |
| 11 #include "base/memory/scoped_ptr.h" |
11 #include "content/common/content_export.h" | 12 #include "content/common/content_export.h" |
12 | 13 |
13 class GURL; | 14 class GURL; |
14 | 15 |
15 namespace net { | 16 namespace net { |
16 class StreamListenSocketFactory; | 17 class ServerSocket; |
17 class URLRequestContextGetter; | 18 class URLRequestContextGetter; |
18 } | 19 } |
19 | 20 |
20 namespace content { | 21 namespace content { |
21 | 22 |
22 class DevToolsHttpHandlerDelegate; | 23 class DevToolsHttpHandlerDelegate; |
23 | 24 |
24 // This class is used for managing DevTools remote debugging server. | 25 // This class is used for managing DevTools remote debugging server. |
25 // Clients can connect to the specified ip:port and start debugging | 26 // Clients can connect to the specified ip:port and start debugging |
26 // this browser. | 27 // this browser. |
27 class DevToolsHttpHandler { | 28 class DevToolsHttpHandler { |
28 public: | 29 public: |
| 30 |
| 31 // Factory of net::ServerSocket. This is to separate instantiating dev tools |
| 32 // and instantiating server socket. |
| 33 class CONTENT_EXPORT ServerSocketFactory { |
| 34 public: |
| 35 ServerSocketFactory(const std::string& address, int port, int backlog); |
| 36 virtual ~ServerSocketFactory(); |
| 37 |
| 38 // Returns a new instance of ServerSocket or NULL if an error occurred. |
| 39 // It calls ServerSocket::ListenWithAddressAndPort() with address, port and |
| 40 // backlog passed to constructor. |
| 41 virtual scoped_ptr<net::ServerSocket> CreateAndListen() const; |
| 42 |
| 43 protected: |
| 44 // Creates a server socket. ServerSocket::Listen() will be called soon |
| 45 // unless it returns NULL. |
| 46 virtual scoped_ptr<net::ServerSocket> Create() const = 0; |
| 47 |
| 48 const std::string address_; |
| 49 const int port_; |
| 50 const int backlog_; |
| 51 |
| 52 private: |
| 53 DISALLOW_COPY_AND_ASSIGN(ServerSocketFactory); |
| 54 }; |
| 55 |
29 // Returns true if the given protocol version is supported. | 56 // Returns true if the given protocol version is supported. |
30 CONTENT_EXPORT static bool IsSupportedProtocolVersion( | 57 CONTENT_EXPORT static bool IsSupportedProtocolVersion( |
31 const std::string& version); | 58 const std::string& version); |
32 | 59 |
33 // Returns frontend resource id for the given resource |name|. | 60 // Returns frontend resource id for the given resource |name|. |
34 CONTENT_EXPORT static int GetFrontendResourceId( | 61 CONTENT_EXPORT static int GetFrontendResourceId( |
35 const std::string& name); | 62 const std::string& name); |
36 | 63 |
37 // Takes ownership over |socket_factory| and |delegate|. | 64 // Takes ownership over |socket_factory| and |delegate|. |
38 // If |active_port_output_directory| is non-empty, it is assumed the | 65 // If |active_port_output_directory| is non-empty, it is assumed the |
39 // socket_factory was initialized with an ephemeral port (0). The | 66 // socket_factory was initialized with an ephemeral port (0). The |
40 // port selected by the OS will be written to a well-known file in | 67 // port selected by the OS will be written to a well-known file in |
41 // the output directory. | 68 // the output directory. |
42 CONTENT_EXPORT static DevToolsHttpHandler* Start( | 69 CONTENT_EXPORT static DevToolsHttpHandler* Start( |
43 const net::StreamListenSocketFactory* socket_factory, | 70 scoped_ptr<ServerSocketFactory> server_socket_factory, |
44 const std::string& frontend_url, | 71 const std::string& frontend_url, |
45 DevToolsHttpHandlerDelegate* delegate, | 72 DevToolsHttpHandlerDelegate* delegate, |
46 const base::FilePath& active_port_output_directory); | 73 const base::FilePath& active_port_output_directory); |
47 | 74 |
48 // Called from the main thread in order to stop protocol handler. | 75 // Called from the main thread in order to stop protocol handler. |
49 // Automatically destroys the handler instance. | 76 // Automatically destroys the handler instance. |
50 virtual void Stop() = 0; | 77 virtual void Stop() = 0; |
51 | 78 |
52 // Returns the URL for the address to debug |agent_host|. | 79 // Returns the URL for the address to debug |agent_host|. |
53 virtual GURL GetFrontendURL() = 0; | 80 virtual GURL GetFrontendURL() = 0; |
54 | 81 |
55 protected: | 82 protected: |
56 virtual ~DevToolsHttpHandler() {} | 83 virtual ~DevToolsHttpHandler() {} |
57 }; | 84 }; |
58 | 85 |
59 } // namespace content | 86 } // namespace content |
60 | 87 |
61 #endif // CONTENT_PUBLIC_BROWSER_DEVTOOLS_HTTP_HANDLER_H_ | 88 #endif // CONTENT_PUBLIC_BROWSER_DEVTOOLS_HTTP_HANDLER_H_ |
OLD | NEW |