| OLD | NEW |
| (Empty) |
| 1 // Copyright 2014 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 MOJO_PUBLIC_APPLICATION_APPLICATION_CONNECTION_H_ | |
| 6 #define MOJO_PUBLIC_APPLICATION_APPLICATION_CONNECTION_H_ | |
| 7 | |
| 8 #include <string> | |
| 9 | |
| 10 #include "mojo/public/cpp/application/lib/service_connector.h" | |
| 11 #include "mojo/public/interfaces/application/service_provider.mojom.h" | |
| 12 | |
| 13 namespace mojo { | |
| 14 | |
| 15 // An instance of this class is passed to | |
| 16 // ApplicationDelegate's ConfigureIncomingConnection() method each time a | |
| 17 // connection is made to this app, and to ApplicationDelegate's | |
| 18 // ConfigureOutgoingConnection() method when the app connects to | |
| 19 // another. | |
| 20 // | |
| 21 // To use define a class that implements your specific service api, e.g. FooImpl | |
| 22 // to implement a service named Foo. | |
| 23 // That class must subclass an InterfaceImpl specialization. | |
| 24 // | |
| 25 // Then implement an InterfaceFactory<Foo> that binds instances of FooImpl to | |
| 26 // InterfaceRequest<Foo>s and register that on the connection. | |
| 27 // | |
| 28 // connection->AddService(&factory); | |
| 29 // | |
| 30 // Or if you have multiple factories implemented by the same type, explicitly | |
| 31 // specify the interface to register the factory for: | |
| 32 // | |
| 33 // connection->AddService<Foo>(&my_foo_and_bar_factory_); | |
| 34 // connection->AddService<Bar>(&my_foo_and_bar_factory_); | |
| 35 // | |
| 36 // The InterfaceFactory must outlive the ApplicationConnection. | |
| 37 class ApplicationConnection { | |
| 38 public: | |
| 39 virtual ~ApplicationConnection(); | |
| 40 | |
| 41 template <typename Interface> | |
| 42 void AddService(InterfaceFactory<Interface>* factory) { | |
| 43 AddServiceConnector( | |
| 44 new internal::InterfaceFactoryConnector<Interface>(factory)); | |
| 45 } | |
| 46 | |
| 47 // Connect to the service implementing |Interface|. | |
| 48 template <typename Interface> | |
| 49 void ConnectToService(InterfacePtr<Interface>* ptr) { | |
| 50 MessagePipe pipe; | |
| 51 ptr->Bind(pipe.handle0.Pass()); | |
| 52 GetServiceProvider()->ConnectToService(Interface::Name_, | |
| 53 pipe.handle1.Pass()); | |
| 54 } | |
| 55 | |
| 56 // The url identifying the application on the other end of this connection. | |
| 57 virtual const std::string& GetRemoteApplicationURL() = 0; | |
| 58 | |
| 59 // Establishes a new connection to an application. | |
| 60 // TODO(davemoore): Would it be better to expose the ApplicationImpl? | |
| 61 virtual ApplicationConnection* ConnectToApplication( | |
| 62 const std::string& url) = 0; | |
| 63 | |
| 64 // Connect to application identified by |application_url| and connect to | |
| 65 // the service implementation of the interface identified by |Interface|. | |
| 66 template <typename Interface> | |
| 67 void ConnectToService(const std::string& application_url, | |
| 68 InterfacePtr<Interface>* ptr) { | |
| 69 ConnectToApplication(application_url)->ConnectToService(ptr); | |
| 70 } | |
| 71 | |
| 72 // Raw ServiceProvider interface to remote application. | |
| 73 virtual ServiceProvider* GetServiceProvider() = 0; | |
| 74 | |
| 75 private: | |
| 76 virtual void AddServiceConnector( | |
| 77 internal::ServiceConnectorBase* service_connector) = 0; | |
| 78 }; | |
| 79 | |
| 80 } // namespace mojo | |
| 81 | |
| 82 #endif // MOJO_PUBLIC_APPLICATION_APPLICATION_CONNECTION_H_ | |
| OLD | NEW |