| OLD | NEW |
| (Empty) |
| 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 | |
| 3 // found in the LICENSE file. | |
| 4 | |
| 5 #ifndef CHROME_BROWSER_CHROMEOS_DBUS_PROXY_RESOLUTION_SERVICE_PROVIDER_H_ | |
| 6 #define CHROME_BROWSER_CHROMEOS_DBUS_PROXY_RESOLUTION_SERVICE_PROVIDER_H_ | |
| 7 | |
| 8 #include <string> | |
| 9 | |
| 10 #include "base/macros.h" | |
| 11 #include "base/memory/ref_counted.h" | |
| 12 #include "base/memory/scoped_ptr.h" | |
| 13 #include "base/memory/weak_ptr.h" | |
| 14 #include "chromeos/dbus/services/cros_dbus_service.h" | |
| 15 #include "dbus/exported_object.h" | |
| 16 | |
| 17 namespace base { | |
| 18 class SingleThreadTaskRunner; | |
| 19 } | |
| 20 | |
| 21 namespace dbus { | |
| 22 class MethodCall; | |
| 23 } | |
| 24 | |
| 25 namespace chromeos { | |
| 26 | |
| 27 class ProxyResolverInterface; | |
| 28 | |
| 29 // This class provides proxy resolution service for CrosDBusService. | |
| 30 // It processes proxy resolution requests for ChromeOS clients. | |
| 31 // | |
| 32 // The following methods are exported. | |
| 33 // | |
| 34 // Interface: org.chromium.LibCrosServiceInterface (kLibCrosServiceInterface) | |
| 35 // Method: ResolveNetworkProxy (kResolveNetworkProxy) | |
| 36 // Parameters: string:source_url | |
| 37 // string:signal_interface | |
| 38 // string:signal_name | |
| 39 // | |
| 40 // Resolves the proxy for |source_url|. Returns the result | |
| 41 // as a D-Bus signal sent to |signal_interface| and |signal_name|. | |
| 42 // | |
| 43 // The returned signal will contain the three values: | |
| 44 // - string:source_url - requested source URL. | |
| 45 // - string:proxy_info - proxy info for the source URL in PAC format | |
| 46 // like "PROXY cache.example.com:12345" | |
| 47 // - string:error_message - error message. Empty if successful. | |
| 48 // | |
| 49 // This service can be manually tested using dbus-monitor and | |
| 50 // dbus-send. For instance, you can resolve proxy configuration for | |
| 51 // http://www.gmail.com/ as follows: | |
| 52 // | |
| 53 // 1. Open a terminal and run the following: | |
| 54 // | |
| 55 // % dbus-monitor --system interface=org.chromium.TestInterface | |
| 56 // | |
| 57 // 2. Open another terminal and run the following: | |
| 58 // | |
| 59 // % dbus-send --system --type=method_call | |
| 60 // --dest=org.chromium.LibCrosService | |
| 61 // /org/chromium/LibCrosService | |
| 62 // org.chromium.LibCrosServiceInterface.ResolveNetworkProxy | |
| 63 // string:http://www.gmail.com/ | |
| 64 // string:org.chromium.TestInterface | |
| 65 // string:TestSignal | |
| 66 // | |
| 67 // 3. Go back to the original terminal and check the output which should | |
| 68 // look like: | |
| 69 // | |
| 70 // signal sender=:1.23 -> dest=(null destination) serial=12345 | |
| 71 // path=/org/chromium/LibCrosService; interface=org.chromium.TestInterface; | |
| 72 // member=TestSignal | |
| 73 // string "http://www.gmail.com/" | |
| 74 // string "PROXY proxy.example.com:8080" | |
| 75 // string "" | |
| 76 // | |
| 77 | |
| 78 class ProxyResolutionServiceProvider | |
| 79 : public CrosDBusService::ServiceProviderInterface { | |
| 80 public: | |
| 81 virtual ~ProxyResolutionServiceProvider(); | |
| 82 | |
| 83 // CrosDBusService::ServiceProviderInterface override. | |
| 84 virtual void Start( | |
| 85 scoped_refptr<dbus::ExportedObject> exported_object) override; | |
| 86 | |
| 87 // Creates the instance. | |
| 88 static ProxyResolutionServiceProvider* Create(); | |
| 89 | |
| 90 private: | |
| 91 explicit ProxyResolutionServiceProvider(ProxyResolverInterface *resovler); | |
| 92 | |
| 93 // Creates the instance for testing. Takes the ownership of |resovler| | |
| 94 friend class ProxyResolutionServiceProviderTest; | |
| 95 static ProxyResolutionServiceProvider* CreateForTesting( | |
| 96 ProxyResolverInterface* resolver); | |
| 97 | |
| 98 // Called from ExportedObject, when ResolveProxyHandler() is exported as | |
| 99 // a D-Bus method, or failed to be exported. | |
| 100 void OnExported(const std::string& interface_name, | |
| 101 const std::string& method_name, | |
| 102 bool success); | |
| 103 | |
| 104 // Callback to be invoked when ChromeOS clients send network proxy | |
| 105 // resolution requests to the service running in chrome executable. | |
| 106 // Called on UI thread from dbus request. | |
| 107 void ResolveProxyHandler(dbus::MethodCall* method_call, | |
| 108 dbus::ExportedObject::ResponseSender response_sender); | |
| 109 | |
| 110 // Calls ResolveProxyHandler() if weak_ptr is not NULL. Used to ensure a | |
| 111 // safe shutdown. | |
| 112 static void CallResolveProxyHandler( | |
| 113 base::WeakPtr<ProxyResolutionServiceProvider> weak_ptr, | |
| 114 dbus::MethodCall* method_call, | |
| 115 dbus::ExportedObject::ResponseSender response_sender); | |
| 116 | |
| 117 // Returns true if the current thread is on the origin thread. | |
| 118 bool OnOriginThread(); | |
| 119 | |
| 120 scoped_refptr<dbus::ExportedObject> exported_object_; | |
| 121 scoped_ptr<ProxyResolverInterface> resolver_; | |
| 122 scoped_refptr<base::SingleThreadTaskRunner> origin_thread_; | |
| 123 base::WeakPtrFactory<ProxyResolutionServiceProvider> weak_ptr_factory_; | |
| 124 | |
| 125 DISALLOW_COPY_AND_ASSIGN(ProxyResolutionServiceProvider); | |
| 126 }; | |
| 127 | |
| 128 // The interface is defined so we can mock out the proxy resolver | |
| 129 // implementation. | |
| 130 class ProxyResolverInterface { | |
| 131 public: | |
| 132 // Resolves the proxy for the given URL. Returns the result as a | |
| 133 // signal sent to |signal_interface| and | |
| 134 // |signal_name|. |exported_object| will be used to send the | |
| 135 // signal. The signal contains the three string members: | |
| 136 // | |
| 137 // - source url: the requested source URL. | |
| 138 // - proxy info: proxy info for the source URL in PAC format. | |
| 139 // - error message: empty if the proxy resolution was successful. | |
| 140 virtual void ResolveProxy( | |
| 141 const std::string& source_url, | |
| 142 const std::string& signal_interface, | |
| 143 const std::string& signal_name, | |
| 144 scoped_refptr<dbus::ExportedObject> exported_object) = 0; | |
| 145 | |
| 146 virtual ~ProxyResolverInterface(); | |
| 147 }; | |
| 148 | |
| 149 } // namespace chromeos | |
| 150 | |
| 151 #endif // CHROME_BROWSER_CHROMEOS_DBUS_PROXY_RESOLUTION_SERVICE_PROVIDER_H_ | |
| OLD | NEW |