| OLD | NEW |
| (Empty) |
| 1 // Copyright 2016 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_SHELL_PUBLIC_CPP_CONNECTOR_H_ | |
| 6 #define MOJO_SHELL_PUBLIC_CPP_CONNECTOR_H_ | |
| 7 | |
| 8 #include "mojo/shell/public/cpp/connection.h" | |
| 9 #include "mojo/shell/public/cpp/identity.h" | |
| 10 #include "mojo/shell/public/interfaces/connector.mojom.h" | |
| 11 #include "mojo/shell/public/interfaces/shell.mojom.h" | |
| 12 #include "mojo/shell/public/interfaces/shell_client.mojom.h" | |
| 13 | |
| 14 namespace mojo { | |
| 15 | |
| 16 // An interface that encapsulates the Mojo Shell's broker interface by which | |
| 17 // connections between applications are established. Once Connect() is called, | |
| 18 // this class is bound to the thread the call was made on and it cannot be | |
| 19 // passed to another thread without calling Clone(). | |
| 20 // An instance of this class is created internally by ShellConnection for use | |
| 21 // on the thread ShellConnection is instantiated on, and this interface is | |
| 22 // wrapped by the Shell interface. | |
| 23 // To use this interface on other threads, call Shell::CloneConnector() and | |
| 24 // pass the result to another thread. To pass to subsequent threads, call | |
| 25 // Clone() on instances of this object. | |
| 26 // While instances of this object are owned by the caller, the underlying | |
| 27 // connection with the shell is bound to the lifetime of the instance that | |
| 28 // created it, i.e. when the application is terminated the Connector pipe is | |
| 29 // closed. | |
| 30 class Connector { | |
| 31 public: | |
| 32 virtual ~Connector() {} | |
| 33 | |
| 34 class ConnectParams { | |
| 35 public: | |
| 36 explicit ConnectParams(const Identity& target); | |
| 37 explicit ConnectParams(const std::string& name); | |
| 38 ~ConnectParams(); | |
| 39 | |
| 40 const Identity& target() { return target_; } | |
| 41 void set_target(const Identity& target) { target_ = target; } | |
| 42 void set_client_process_connection( | |
| 43 shell::mojom::ShellClientPtr shell_client, | |
| 44 shell::mojom::PIDReceiverRequest pid_receiver_request) { | |
| 45 shell_client_ = std::move(shell_client); | |
| 46 pid_receiver_request_ = std::move(pid_receiver_request); | |
| 47 } | |
| 48 void TakeClientProcessConnection( | |
| 49 shell::mojom::ShellClientPtr* shell_client, | |
| 50 shell::mojom::PIDReceiverRequest* pid_receiver_request) { | |
| 51 *shell_client = std::move(shell_client_); | |
| 52 *pid_receiver_request = std::move(pid_receiver_request_); | |
| 53 } | |
| 54 | |
| 55 private: | |
| 56 Identity target_; | |
| 57 shell::mojom::ShellClientPtr shell_client_; | |
| 58 shell::mojom::PIDReceiverRequest pid_receiver_request_; | |
| 59 | |
| 60 DISALLOW_COPY_AND_ASSIGN(ConnectParams); | |
| 61 }; | |
| 62 | |
| 63 // Requests a new connection to an application. Returns a pointer to the | |
| 64 // connection if the connection is permitted by this application's delegate, | |
| 65 // or nullptr otherwise. Caller takes ownership. | |
| 66 // Once this method is called, this object is bound to the thread on which the | |
| 67 // call took place. To pass to another thread, call Clone() and pass the | |
| 68 // result. | |
| 69 virtual scoped_ptr<Connection> Connect(const std::string& name) = 0; | |
| 70 virtual scoped_ptr<Connection> Connect(ConnectParams* params) = 0; | |
| 71 | |
| 72 // Connect to application identified by |request->name| and connect to the | |
| 73 // service implementation of the interface identified by |Interface|. | |
| 74 template <typename Interface> | |
| 75 void ConnectToInterface(ConnectParams* params, InterfacePtr<Interface>* ptr) { | |
| 76 scoped_ptr<Connection> connection = Connect(params); | |
| 77 if (connection) | |
| 78 connection->GetInterface(ptr); | |
| 79 } | |
| 80 template <typename Interface> | |
| 81 void ConnectToInterface(const Identity& target, | |
| 82 InterfacePtr<Interface>* ptr) { | |
| 83 ConnectParams params(target); | |
| 84 return ConnectToInterface(¶ms, ptr); | |
| 85 } | |
| 86 template <typename Interface> | |
| 87 void ConnectToInterface(const std::string& name, | |
| 88 InterfacePtr<Interface>* ptr) { | |
| 89 ConnectParams params(name); | |
| 90 return ConnectToInterface(¶ms, ptr); | |
| 91 } | |
| 92 | |
| 93 // Creates a new instance of this class which may be passed to another thread. | |
| 94 // The returned object may be passed multiple times until Connect() is called, | |
| 95 // at which point this method must be called again to pass again. | |
| 96 virtual scoped_ptr<Connector> Clone() = 0; | |
| 97 }; | |
| 98 | |
| 99 } // namespace mojo | |
| 100 | |
| 101 #endif // MOJO_SHELL_PUBLIC_CPP_CONNECTOR_H_ | |
| OLD | NEW |