| OLD | NEW |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. | 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 | 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 SERVICES_SHELL_PUBLIC_CPP_SHELL_CONNECTION_H_ | 5 #ifndef SERVICES_SHELL_PUBLIC_CPP_SHELL_CONNECTION_H_ |
| 6 #define SERVICES_SHELL_PUBLIC_CPP_SHELL_CONNECTION_H_ | 6 #define SERVICES_SHELL_PUBLIC_CPP_SHELL_CONNECTION_H_ |
| 7 | 7 |
| 8 #include <memory> | 8 #include <memory> |
| 9 #include <utility> | 9 #include <utility> |
| 10 #include <vector> | 10 #include <vector> |
| 11 | 11 |
| 12 #include "base/callback.h" | 12 #include "base/callback.h" |
| 13 #include "base/macros.h" | 13 #include "base/macros.h" |
| 14 #include "base/memory/scoped_vector.h" | |
| 15 #include "mojo/public/cpp/bindings/binding.h" | 14 #include "mojo/public/cpp/bindings/binding.h" |
| 16 #include "mojo/public/cpp/system/core.h" | 15 #include "mojo/public/cpp/system/core.h" |
| 16 #include "services/shell/public/cpp/connector.h" |
| 17 #include "services/shell/public/cpp/service.h" | 17 #include "services/shell/public/cpp/service.h" |
| 18 #include "services/shell/public/interfaces/connector.mojom.h" | 18 #include "services/shell/public/interfaces/connector.mojom.h" |
| 19 #include "services/shell/public/interfaces/service.mojom.h" | 19 #include "services/shell/public/interfaces/service.mojom.h" |
| 20 | 20 |
| 21 namespace shell { | 21 namespace shell { |
| 22 | 22 |
| 23 class Connector; | |
| 24 | |
| 25 // Encapsulates a connection to the Mojo Shell in two parts: | 23 // Encapsulates a connection to the Mojo Shell in two parts: |
| 26 // - a bound InterfacePtr to mojom::Shell, the primary mechanism | 24 // - a bound InterfacePtr to mojom::Shell, the primary mechanism |
| 27 // by which the instantiating application interacts with other services | 25 // by which the instantiating application interacts with other services |
| 28 // brokered by the Mojo Shell. | 26 // brokered by the Mojo Shell. |
| 29 // - a bound InterfaceRequest of mojom::Service, an interface | 27 // - a bound InterfaceRequest of mojom::Service, an interface |
| 30 // used by the Mojo Shell to inform this application of lifecycle events and | 28 // used by the Mojo Shell to inform this application of lifecycle events and |
| 31 // inbound connections brokered by it. | 29 // inbound connections brokered by it. |
| 32 // | 30 // |
| 33 // This class should be used in two scenarios: | 31 // This class should be used in two scenarios: |
| 34 // - During early startup to bind the mojom::ServiceRequest obtained from | 32 // - During early startup to bind the mojom::ServiceRequest obtained from |
| 35 // the Mojo Shell, typically in response to either MojoMain() or main(). | 33 // the Mojo Shell, typically in response to either MojoMain() or main(). |
| 36 // - In an implementation of mojom::ServiceFactory to bind the | 34 // - In an implementation of mojom::ServiceFactory to bind the |
| 37 // mojom::ServiceRequest passed via StartApplication. In this scenario | 35 // mojom::ServiceRequest passed via StartApplication. In this scenario |
| 38 // there can be many instances of this class per process. | 36 // there can be many instances of this class per process. |
| 39 // | 37 // |
| 40 // Instances of this class are constructed with an implementation of the Shell | 38 // Instances of this class are constructed with an implementation of the Shell |
| 41 // Client Lib's Service interface. See documentation in service.h | 39 // Client Lib's Service interface. See documentation in service.h |
| 42 // for details. | 40 // for details. |
| 43 // | 41 // |
| 44 class ShellConnection : public mojom::Service { | 42 class ShellConnection : public mojom::Service { |
| 45 public: | 43 public: |
| 46 // Creates a new ShellConnection bound to |request|. This connection may be | 44 // Creates a new ShellConnection bound to |request|. This connection may be |
| 47 // used immediately to make outgoing connections via connector(). Does not | 45 // used immediately to make outgoing connections via connector(). Does not |
| 48 // take ownership of |client|, which must remain valid for the lifetime of | 46 // take ownership of |service|, which must remain valid for the lifetime of |
| 49 // ShellConnection. | 47 // ShellConnection. If either |connector| or |connector_request| is non-null |
| 50 ShellConnection(shell::Service* client, | 48 // both must be non-null. If both are null, the connection will create its own |
| 51 mojom::ServiceRequest request); | 49 // Connector and request to pass to the shell on initialization. |
| 50 ShellConnection(shell::Service* service, |
| 51 mojom::ServiceRequest request, |
| 52 std::unique_ptr<Connector> connector = nullptr, |
| 53 mojom::ConnectorRequest connector_request = nullptr); |
| 52 | 54 |
| 53 ~ShellConnection() override; | 55 ~ShellConnection() override; |
| 54 | 56 |
| 55 Connector* connector() { return connector_.get(); } | 57 Connector* connector() { return connector_.get(); } |
| 56 const Identity& identity() { return identity_; } | 58 const Identity& identity() { return identity_; } |
| 57 | 59 |
| 58 // TODO(rockot): Remove this. http://crbug.com/594852. | |
| 59 void set_initialize_handler(const base::Closure& callback); | |
| 60 | |
| 61 // TODO(rockot): Remove this once we get rid of app tests. | |
| 62 void SetAppTestConnectorForTesting(mojom::ConnectorPtr connector); | |
| 63 | |
| 64 // Specify a function to be called when the connection to the shell is lost. | 60 // Specify a function to be called when the connection to the shell is lost. |
| 65 // Note that if connection has already been lost, then |closure| is called | 61 // Note that if connection has already been lost, then |closure| is called |
| 66 // immediately. | 62 // immediately. |
| 67 void SetConnectionLostClosure(const base::Closure& closure); | 63 void SetConnectionLostClosure(const base::Closure& closure); |
| 68 | 64 |
| 69 private: | 65 private: |
| 70 // mojom::Service: | 66 // mojom::Service: |
| 71 void OnStart(mojom::IdentityPtr identity, | 67 void OnStart(mojom::IdentityPtr identity, |
| 72 uint32_t id, | 68 uint32_t id, |
| 73 const OnStartCallback& callback) override; | 69 const OnStartCallback& callback) override; |
| 74 void OnConnect(mojom::IdentityPtr source, | 70 void OnConnect(mojom::IdentityPtr source, |
| 75 uint32_t source_id, | 71 uint32_t source_id, |
| 76 mojom::InterfaceProviderRequest remote_interfaces, | 72 mojom::InterfaceProviderRequest remote_interfaces, |
| 77 mojom::InterfaceProviderPtr local_interfaces, | 73 mojom::InterfaceProviderPtr local_interfaces, |
| 78 mojom::CapabilityRequestPtr allowed_capabilities, | 74 mojom::CapabilityRequestPtr allowed_capabilities, |
| 79 const mojo::String& name) override; | 75 const mojo::String& name) override; |
| 80 | 76 |
| 81 void OnConnectionError(); | 77 void OnConnectionError(); |
| 82 | 78 |
| 83 // A callback called when OnStart() is run. | 79 // A callback called when OnStart() is run. |
| 84 base::Closure initialize_handler_; | 80 base::Closure initialize_handler_; |
| 85 | 81 |
| 86 // We track the lifetime of incoming connection registries as it more | 82 // We track the lifetime of incoming connection registries as it more |
| 87 // convenient for the client. | 83 // convenient for the client. |
| 88 ScopedVector<Connection> incoming_connections_; | 84 std::vector<std::unique_ptr<Connection>> incoming_connections_; |
| 89 | 85 |
| 90 // A pending Connector request which will eventually be passed to the shell. | 86 // A pending Connector request which will eventually be passed to the shell. |
| 91 mojom::ConnectorRequest pending_connector_request_; | 87 mojom::ConnectorRequest pending_connector_request_; |
| 92 | 88 |
| 93 shell::Service* client_; | 89 shell::Service* service_; |
| 94 mojo::Binding<mojom::Service> binding_; | 90 mojo::Binding<mojom::Service> binding_; |
| 95 std::unique_ptr<Connector> connector_; | 91 std::unique_ptr<Connector> connector_; |
| 96 shell::Identity identity_; | 92 shell::Identity identity_; |
| 97 bool should_run_connection_lost_closure_ = false; | 93 bool should_run_connection_lost_closure_ = false; |
| 98 | 94 |
| 99 base::Closure connection_lost_closure_; | 95 base::Closure connection_lost_closure_; |
| 100 | 96 |
| 101 DISALLOW_COPY_AND_ASSIGN(ShellConnection); | 97 DISALLOW_COPY_AND_ASSIGN(ShellConnection); |
| 102 }; | 98 }; |
| 103 | 99 |
| 104 } // namespace shell | 100 } // namespace shell |
| 105 | 101 |
| 106 #endif // SERVICES_SHELL_PUBLIC_CPP_SHELL_CONNECTION_H_ | 102 #endif // SERVICES_SHELL_PUBLIC_CPP_SHELL_CONNECTION_H_ |
| OLD | NEW |