| OLD | NEW |
| 1 // Copyright 2016 The Chromium Authors. All rights reserved. | 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 | 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 MOJO_SHELL_PUBLIC_CPP_SHELL_H_ | 5 #ifndef MOJO_SHELL_PUBLIC_CPP_SHELL_H_ |
| 6 #define MOJO_SHELL_PUBLIC_CPP_SHELL_H_ | 6 #define MOJO_SHELL_PUBLIC_CPP_SHELL_H_ |
| 7 | 7 |
| 8 #include "mojo/shell/public/cpp/connection.h" | |
| 9 #include "mojo/shell/public/cpp/connector.h" | 8 #include "mojo/shell/public/cpp/connector.h" |
| 10 #include "mojo/shell/public/interfaces/shell.mojom.h" | |
| 11 #include "url/gurl.h" | |
| 12 | 9 |
| 13 namespace mojo { | 10 namespace mojo { |
| 14 | 11 |
| 15 // An interface implementation can keep this object as a member variable to | 12 using Shell = Connector; |
| 16 // hold a reference to the ShellConnection, keeping it alive as long as the | |
| 17 // bound implementation exists. | |
| 18 // Since interface implementations can be bound on different threads than the | |
| 19 // ShellConnection, this class is safe to use on any thread. However, each | |
| 20 // instance should only be used on one thread at a time (otherwise there'll be | |
| 21 // races between the AddRef resulting from cloning and destruction). | |
| 22 class AppRefCount { | |
| 23 public: | |
| 24 virtual ~AppRefCount() {} | |
| 25 | |
| 26 virtual scoped_ptr<AppRefCount> Clone() = 0; | |
| 27 }; | |
| 28 | |
| 29 // An interface that encapsulates the Mojo Shell's broker interface by which | |
| 30 // connections between applications are established. Implemented by | |
| 31 // ShellConnection, this is the primary interface exposed to clients. | |
| 32 class Shell { | |
| 33 public: | |
| 34 // Requests a new connection to an application. Returns a pointer to the | |
| 35 // connection if the connection is permitted by this application's delegate, | |
| 36 // or nullptr otherwise. Caller takes ownership. | |
| 37 virtual scoped_ptr<Connection> Connect(const std::string& url) = 0; | |
| 38 virtual scoped_ptr<Connection> Connect(Connector::ConnectParams* params) = 0; | |
| 39 | |
| 40 // Connect to application identified by |request->url| and connect to the | |
| 41 // service implementation of the interface identified by |Interface|. | |
| 42 template <typename Interface> | |
| 43 void ConnectToInterface(Connector::ConnectParams* params, | |
| 44 InterfacePtr<Interface>* ptr) { | |
| 45 scoped_ptr<Connection> connection = Connect(params); | |
| 46 if (connection) | |
| 47 connection->GetInterface(ptr); | |
| 48 } | |
| 49 template <typename Interface> | |
| 50 void ConnectToInterface(const std::string& url, | |
| 51 InterfacePtr<Interface>* ptr) { | |
| 52 Connector::ConnectParams params(url); | |
| 53 return ConnectToInterface(¶ms, ptr); | |
| 54 } | |
| 55 | |
| 56 // Returns a clone of the ShellConnection's Connector that can be passed to | |
| 57 // other threads. | |
| 58 virtual scoped_ptr<Connector> CloneConnector() const = 0; | |
| 59 | |
| 60 // Quits the message loop run by the ApplicationRunner, which causes this | |
| 61 // object to be destructed and the application to quit. | |
| 62 virtual void Quit() = 0; | |
| 63 | |
| 64 // Create an object that can be used to refcount the lifetime of the | |
| 65 // application. The returned object may be cloned, and when the refcount falls | |
| 66 // to zero Quit() is called. | |
| 67 virtual scoped_ptr<AppRefCount> CreateAppRefCount() = 0; | |
| 68 }; | |
| 69 | 13 |
| 70 } // namespace mojo | 14 } // namespace mojo |
| 71 | 15 |
| 72 #endif // MOJO_SHELL_PUBLIC_CPP_SHELL_H_ | 16 #endif // MOJO_SHELL_PUBLIC_CPP_SHELL_H_ |
| OLD | NEW |