| 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_
|
|
|