Index: mojo/shell/public/cpp/application_connection.h |
diff --git a/mojo/shell/public/cpp/application_connection.h b/mojo/shell/public/cpp/application_connection.h |
deleted file mode 100644 |
index 28a3a85676503a8889b8f5473d8fe7997db185bd..0000000000000000000000000000000000000000 |
--- a/mojo/shell/public/cpp/application_connection.h |
+++ /dev/null |
@@ -1,152 +0,0 @@ |
-// Copyright 2014 The Chromium Authors. All rights reserved. |
-// Use of this source code is governed by a BSD-style license that can be |
-// found in the LICENSE file. |
- |
-#ifndef MOJO_SHELL_PUBLIC_CPP_APPLICATION_CONNECTION_H_ |
-#define MOJO_SHELL_PUBLIC_CPP_APPLICATION_CONNECTION_H_ |
- |
-#include <stdint.h> |
- |
-#include <string> |
-#include <utility> |
- |
-#include "base/memory/weak_ptr.h" |
-#include "mojo/shell/public/cpp/lib/interface_factory_connector.h" |
-#include "mojo/shell/public/interfaces/service_provider.mojom.h" |
- |
-namespace mojo { |
- |
-class ServiceConnector; |
- |
-// Represents a connection to another application. An instance of this class is |
-// passed to ApplicationDelegate's AcceptConnection() method each |
-// time a connection is made to this app. |
-// |
-// To use, define a class that implements your specific service API (e.g., |
-// FooImpl to implement a service named Foo). Then implement an |
-// InterfaceFactory<Foo> that binds instances of FooImpl to |
-// InterfaceRequest<Foo>s and register that on the connection like this: |
-// |
-// connection->AddService(&factory); |
-// |
-// Or, if you have multiple factories implemented by the same type, explicitly |
-// specify the interface to register the factory for: |
-// |
-// connection->AddService<Foo>(&my_foo_and_bar_factory_); |
-// connection->AddService<Bar>(&my_foo_and_bar_factory_); |
-// |
-// The InterfaceFactory must outlive the ApplicationConnection. |
-// |
-// Additionally you specify a ServiceConnector. If a ServiceConnector has |
-// been set and an InterfaceFactory has not been registered for the interface |
-// request, than the interface request is sent to the ServiceConnector. |
-// |
-// Just as with InterfaceFactory, ServiceConnector must outlive |
-// ApplicationConnection. |
-// |
-// An ApplicationConnection's lifetime is managed by an ApplicationImpl. To |
-// close a connection, call CloseConnection which will destroy this object. |
-class ApplicationConnection { |
- public: |
- virtual ~ApplicationConnection() {} |
- |
- class TestApi { |
- public: |
- explicit TestApi(ApplicationConnection* connection) |
- : connection_(connection) { |
- } |
- base::WeakPtr<ApplicationConnection> GetWeakPtr() { |
- return connection_->GetWeakPtr(); |
- } |
- |
- private: |
- ApplicationConnection* connection_; |
- }; |
- |
- // See class description for details. |
- virtual void SetServiceConnector(ServiceConnector* connector) = 0; |
- |
- // Makes Interface available as a service to the remote application. |
- // |factory| will create implementations of Interface on demand. |
- // Returns true if the service was exposed, false if capability filtering |
- // from the shell prevented the service from being exposed. |
- template <typename Interface> |
- bool AddService(InterfaceFactory<Interface>* factory) { |
- return SetServiceConnectorForName( |
- new internal::InterfaceFactoryConnector<Interface>(factory), |
- Interface::Name_); |
- } |
- |
- // Binds |ptr| to an implemention of Interface in the remote application. |
- // |ptr| can immediately be used to start sending requests to the remote |
- // service. |
- template <typename Interface> |
- void ConnectToService(InterfacePtr<Interface>* ptr) { |
- if (ServiceProvider* sp = GetServiceProvider()) { |
- MessagePipe pipe; |
- ptr->Bind(InterfacePtrInfo<Interface>(std::move(pipe.handle0), 0u)); |
- sp->ConnectToService(Interface::Name_, std::move(pipe.handle1)); |
- } |
- } |
- |
- // Returns the URL that was used by the source application to establish a |
- // connection to the destination application. |
- // |
- // When ApplicationConnection is representing an incoming connection this can |
- // be different than the URL the application was initially loaded from, if the |
- // application handles multiple URLs. Note that this is the URL after all |
- // URL rewriting and HTTP redirects have been performed. |
- // |
- // When ApplicationConnection is representing and outgoing connection, this |
- // will be the same as the value returned by GetRemoveApplicationURL(). |
- virtual const std::string& GetConnectionURL() = 0; |
- |
- // Returns the URL identifying the remote application on this connection. |
- virtual const std::string& GetRemoteApplicationURL() = 0; |
- |
- // Returns the raw proxy to the remote application's ServiceProvider |
- // interface. Most applications will just use ConnectToService() instead. |
- // Caller does not take ownership. |
- virtual ServiceProvider* GetServiceProvider() = 0; |
- |
- // Returns the local application's ServiceProvider interface. The return |
- // value is owned by this connection. |
- virtual ServiceProvider* GetLocalServiceProvider() = 0; |
- |
- // Register a handler to receive an error notification on the pipe to the |
- // remote application's service provider. |
- virtual void SetRemoteServiceProviderConnectionErrorHandler( |
- const Closure& handler) = 0; |
- |
- // Returns the id of the remote application. For ApplicationConnections |
- // created via ApplicationImpl::ConnectToApplication(), this will not be |
- // determined until ConnectToApplication()'s callback is run, and this |
- // function will return false. Use AddRemoteIDCallback() to schedule a |
- // callback to be run when the remote application id is available. A value of |
- // Shell::kInvalidApplicationID indicates no remote application connection |
- // has been established. |
- virtual bool GetRemoteApplicationID(uint32_t* remote_id) const = 0; |
- |
- // Returns the id of the deepest content handler used in connecting to |
- // the application. See GetRemoteApplicationID() for details about the return |
- // value. A |content_handler_id| value of Shell::kInvalidApplicationID |
- // indicates no content handler was used in connecting to the application. |
- virtual bool GetRemoteContentHandlerID( |
- uint32_t* content_handler_id) const = 0; |
- |
- // See description in GetRemoteApplicationID()/GetRemoteContentHandlerID(). If |
- // the ids are available, |callback| is run immediately. |
- virtual void AddRemoteIDCallback(const Closure& callback) = 0; |
- |
- protected: |
- // Returns true if the connector was set, false if it was not set (e.g. by |
- // some filtering policy preventing this interface from being exposed). |
- virtual bool SetServiceConnectorForName(ServiceConnector* service_connector, |
- const std::string& name) = 0; |
- |
- virtual base::WeakPtr<ApplicationConnection> GetWeakPtr() = 0; |
-}; |
- |
-} // namespace mojo |
- |
-#endif // MOJO_SHELL_PUBLIC_CPP_APPLICATION_CONNECTION_H_ |