| 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_SERVICE_MANAGER_PUBLIC_CPP_SERVICE_CONTEXT_H_ | 5 #ifndef SERVICES_SERVICE_MANAGER_PUBLIC_CPP_SERVICE_CONTEXT_H_ | 
| 6 #define SERVICES_SERVICE_MANAGER_PUBLIC_CPP_SERVICE_CONTEXT_H_ | 6 #define SERVICES_SERVICE_MANAGER_PUBLIC_CPP_SERVICE_CONTEXT_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 "mojo/public/cpp/bindings/binding.h" | 14 #include "mojo/public/cpp/bindings/binding.h" | 
| 15 #include "mojo/public/cpp/system/core.h" | 15 #include "mojo/public/cpp/system/core.h" | 
| 16 #include "services/service_manager/public/cpp/connector.h" | 16 #include "services/service_manager/public/cpp/connector.h" | 
| 17 #include "services/service_manager/public/cpp/service.h" | 17 #include "services/service_manager/public/cpp/service.h" | 
| 18 #include "services/service_manager/public/interfaces/connector.mojom.h" | 18 #include "services/service_manager/public/interfaces/connector.mojom.h" | 
| 19 #include "services/service_manager/public/interfaces/service.mojom.h" | 19 #include "services/service_manager/public/interfaces/service.mojom.h" | 
| 20 | 20 | 
| 21 namespace shell { | 21 namespace service_manager { | 
| 22 | 22 | 
| 23 // Encapsulates a connection to the Service Manager in two parts: | 23 // Encapsulates a connection to the Service Manager in two parts: | 
| 24 // - a bound InterfacePtr to mojom::Connector, the primary mechanism | 24 // - a bound InterfacePtr to mojom::Connector, the primary mechanism | 
| 25 //   by which the instantiating service connects to other services, | 25 //   by which the instantiating service connects to other services, | 
| 26 //   brokered by the Service Manager. | 26 //   brokered by the Service Manager. | 
| 27 // - a bound InterfaceRequest of mojom::Service, an interface used by the | 27 // - a bound InterfaceRequest of mojom::Service, an interface used by the | 
| 28 //   Service Manager to inform this service of lifecycle events and | 28 //   Service Manager to inform this service of lifecycle events and | 
| 29 //   inbound connections brokered by it. | 29 //   inbound connections brokered by it. | 
| 30 // | 30 // | 
| 31 // This class should be used in two scenarios: | 31 // This class should be used in two scenarios: | 
| 32 // - During early startup to bind the mojom::ServiceRequest obtained from | 32 // - During early startup to bind the mojom::ServiceRequest obtained from | 
| 33 //   the Service Manager, typically in response to either ServiceMain() or | 33 //   the Service Manager, typically in response to either ServiceMain() or | 
| 34 //   main(). | 34 //   main(). | 
| 35 // - In an implementation of mojom::ServiceFactory to bind the | 35 // - In an implementation of mojom::ServiceFactory to bind the | 
| 36 //   mojom::ServiceRequest passed via CreateService. In this scenario there can | 36 //   mojom::ServiceRequest passed via CreateService. In this scenario there can | 
| 37 //   be many instances of this class per process. | 37 //   be many instances of this class per process. | 
| 38 // | 38 // | 
| 39 // Instances of this class are constructed with an implementation of the Service | 39 // Instances of this class are constructed with an implementation of the Service | 
| 40 // Manager Client Lib's Service interface. See documentation in service.h | 40 // Manager Client Lib's Service interface. See documentation in service.h | 
| 41 // for details. | 41 // for details. | 
| 42 // | 42 // | 
| 43 class ServiceContext : public mojom::Service { | 43 class ServiceContext : public mojom::Service { | 
| 44  public: | 44  public: | 
| 45   // Creates a new ServiceContext bound to |request|. This connection may be | 45   // Creates a new ServiceContext bound to |request|. This connection may be | 
| 46   // used immediately to make outgoing connections via connector().  Does not | 46   // used immediately to make outgoing connections via connector().  Does not | 
| 47   // take ownership of |service|, which must remain valid for the lifetime of | 47   // take ownership of |service|, which must remain valid for the lifetime of | 
| 48   // ServiceContext. If either |connector| or |connector_request| is non-null | 48   // ServiceContext. If either |connector| or |connector_request| is non-null | 
| 49   // both must be non-null. If both are null, the connection will create its own | 49   // both must be non-null. If both are null, the connection will create its own | 
| 50   // Connector and request to pass to the Service Manager on initialization. | 50   // Connector and request to pass to the Service Manager on initialization. | 
| 51   ServiceContext(shell::Service* service, | 51   ServiceContext(service_manager::Service* service, | 
| 52                  mojom::ServiceRequest request, | 52                  mojom::ServiceRequest request, | 
| 53                  std::unique_ptr<Connector> connector = nullptr, | 53                  std::unique_ptr<Connector> connector = nullptr, | 
| 54                  mojom::ConnectorRequest connector_request = nullptr); | 54                  mojom::ConnectorRequest connector_request = nullptr); | 
| 55 | 55 | 
| 56   ~ServiceContext() override; | 56   ~ServiceContext() override; | 
| 57 | 57 | 
| 58   Connector* connector() { return connector_.get(); } | 58   Connector* connector() { return connector_.get(); } | 
| 59   const Identity& identity() { return identity_; } | 59   const Identity& identity() { return identity_; } | 
| 60 | 60 | 
| 61   // Specify a function to be called when the connection to the shell is lost. | 61   // Specify a function to be called when the connection to the shell is lost. | 
| (...skipping 16 matching lines...) Expand all  Loading... | 
| 78   base::Closure initialize_handler_; | 78   base::Closure initialize_handler_; | 
| 79 | 79 | 
| 80   // We track the lifetime of incoming connection registries as it more | 80   // We track the lifetime of incoming connection registries as it more | 
| 81   // convenient for the client. | 81   // convenient for the client. | 
| 82   std::vector<std::unique_ptr<InterfaceRegistry>> incoming_connections_; | 82   std::vector<std::unique_ptr<InterfaceRegistry>> incoming_connections_; | 
| 83 | 83 | 
| 84   // A pending Connector request which will eventually be passed to the Service | 84   // A pending Connector request which will eventually be passed to the Service | 
| 85   // Manager. | 85   // Manager. | 
| 86   mojom::ConnectorRequest pending_connector_request_; | 86   mojom::ConnectorRequest pending_connector_request_; | 
| 87 | 87 | 
| 88   shell::Service* service_; | 88   service_manager::Service* service_; | 
| 89   mojo::Binding<mojom::Service> binding_; | 89   mojo::Binding<mojom::Service> binding_; | 
| 90   std::unique_ptr<Connector> connector_; | 90   std::unique_ptr<Connector> connector_; | 
| 91   shell::Identity identity_; | 91   service_manager::Identity identity_; | 
| 92   bool should_run_connection_lost_closure_ = false; | 92   bool should_run_connection_lost_closure_ = false; | 
| 93 | 93 | 
| 94   base::Closure connection_lost_closure_; | 94   base::Closure connection_lost_closure_; | 
| 95 | 95 | 
| 96   DISALLOW_COPY_AND_ASSIGN(ServiceContext); | 96   DISALLOW_COPY_AND_ASSIGN(ServiceContext); | 
| 97 }; | 97 }; | 
| 98 | 98 | 
| 99 }  // namespace shell | 99 }  // namespace service_manager | 
| 100 | 100 | 
| 101 #endif  // SERVICES_SERVICE_MANAGER_PUBLIC_CPP_SERVICE_CONTEXT_H_ | 101 #endif  // SERVICES_SERVICE_MANAGER_PUBLIC_CPP_SERVICE_CONTEXT_H_ | 
| OLD | NEW | 
|---|