Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(250)

Unified Diff: mojo/shell/public/cpp/application_connection.h

Issue 1675083002: Rename ApplicationDelegate to ShellClient (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@delegate
Patch Set: . Created 4 years, 10 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « mojo/shell/public/cpp/BUILD.gn ('k') | mojo/shell/public/cpp/application_delegate.h » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
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_
« no previous file with comments | « mojo/shell/public/cpp/BUILD.gn ('k') | mojo/shell/public/cpp/application_delegate.h » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698