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

Unified Diff: third_party/mojo/src/mojo/public/cpp/bindings/binding.h

Issue 1410053006: Move third_party/mojo/src/mojo/public to mojo/public (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: merge Created 5 years, 1 month 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
Index: third_party/mojo/src/mojo/public/cpp/bindings/binding.h
diff --git a/third_party/mojo/src/mojo/public/cpp/bindings/binding.h b/third_party/mojo/src/mojo/public/cpp/bindings/binding.h
deleted file mode 100644
index 3bee7c2e516640fbc919381df19bf681fb6a3674..0000000000000000000000000000000000000000
--- a/third_party/mojo/src/mojo/public/cpp/bindings/binding.h
+++ /dev/null
@@ -1,239 +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 THIRD_PARTY_MOJO_SRC_MOJO_PUBLIC_CPP_BINDINGS_BINDING_H_
-#define THIRD_PARTY_MOJO_SRC_MOJO_PUBLIC_CPP_BINDINGS_BINDING_H_
-
-#include "third_party/mojo/src/mojo/public/c/environment/async_waiter.h"
-#include "third_party/mojo/src/mojo/public/cpp/bindings/callback.h"
-#include "third_party/mojo/src/mojo/public/cpp/bindings/interface_ptr.h"
-#include "third_party/mojo/src/mojo/public/cpp/bindings/interface_ptr_info.h"
-#include "third_party/mojo/src/mojo/public/cpp/bindings/interface_request.h"
-#include "third_party/mojo/src/mojo/public/cpp/bindings/lib/filter_chain.h"
-#include "third_party/mojo/src/mojo/public/cpp/bindings/lib/message_header_validator.h"
-#include "third_party/mojo/src/mojo/public/cpp/bindings/lib/router.h"
-#include "third_party/mojo/src/mojo/public/cpp/environment/logging.h"
-#include "third_party/mojo/src/mojo/public/cpp/system/core.h"
-
-namespace mojo {
-
-// Represents the binding of an interface implementation to a message pipe.
-// When the |Binding| object is destroyed, the binding between the message pipe
-// and the interface is torn down and the message pipe is closed, leaving the
-// interface implementation in an unbound state.
-//
-// Example:
-//
-// #include "foo.mojom.h"
-//
-// class FooImpl : public Foo {
-// public:
-// explicit FooImpl(InterfaceRequest<Foo> request)
-// : binding_(this, request.Pass()) {}
-//
-// // Foo implementation here.
-//
-// private:
-// Binding<Foo> binding_;
-// };
-//
-// class MyFooFactory : public InterfaceFactory<Foo> {
-// public:
-// void Create(..., InterfaceRequest<Foo> request) override {
-// auto f = new FooImpl(request.Pass());
-// // Do something to manage the lifetime of |f|. Use StrongBinding<> to
-// // delete FooImpl on connection errors.
-// }
-// };
-//
-// The caller may specify a |MojoAsyncWaiter| to be used by the connection when
-// waiting for calls to arrive. Normally it is fine to use the default waiter.
-// However, the caller may provide their own implementation if needed. The
-// |Binding| will not take ownership of the waiter, and the waiter must outlive
-// the |Binding|. The provided waiter must be able to signal the implementation
-// which generally means it needs to be able to schedule work on the thread the
-// implementation runs on. If writing library code that has to work on different
-// types of threads callers may need to provide different waiter
-// implementations.
-template <typename Interface>
-class Binding {
- public:
- // Constructs an incomplete binding that will use the implementation |impl|.
- // The binding may be completed with a subsequent call to the |Bind| method.
- // Does not take ownership of |impl|, which must outlive the binding.
- explicit Binding(Interface* impl) : impl_(impl) { stub_.set_sink(impl_); }
-
- // Constructs a completed binding of message pipe |handle| to implementation
- // |impl|. Does not take ownership of |impl|, which must outlive the binding.
- // See class comment for definition of |waiter|.
- Binding(Interface* impl,
- ScopedMessagePipeHandle handle,
- const MojoAsyncWaiter* waiter = Environment::GetDefaultAsyncWaiter())
- : Binding(impl) {
- Bind(handle.Pass(), waiter);
- }
-
- // Constructs a completed binding of |impl| to a new message pipe, passing the
- // client end to |ptr|, which takes ownership of it. The caller is expected to
- // pass |ptr| on to the client of the service. Does not take ownership of any
- // of the parameters. |impl| must outlive the binding. |ptr| only needs to
- // last until the constructor returns. See class comment for definition of
- // |waiter|.
- Binding(Interface* impl,
- InterfacePtr<Interface>* ptr,
- const MojoAsyncWaiter* waiter = Environment::GetDefaultAsyncWaiter())
- : Binding(impl) {
- Bind(ptr, waiter);
- }
-
- // Constructs a completed binding of |impl| to the message pipe endpoint in
- // |request|, taking ownership of the endpoint. Does not take ownership of
- // |impl|, which must outlive the binding. See class comment for definition of
- // |waiter|.
- Binding(Interface* impl,
- InterfaceRequest<Interface> request,
- const MojoAsyncWaiter* waiter = Environment::GetDefaultAsyncWaiter())
- : Binding(impl) {
- Bind(request.PassMessagePipe(), waiter);
- }
-
- // Tears down the binding, closing the message pipe and leaving the interface
- // implementation unbound.
- ~Binding() {
- if (internal_router_)
- Close();
- }
-
- // Completes a binding that was constructed with only an interface
- // implementation. Takes ownership of |handle| and binds it to the previously
- // specified implementation. See class comment for definition of |waiter|.
- void Bind(
- ScopedMessagePipeHandle handle,
- const MojoAsyncWaiter* waiter = Environment::GetDefaultAsyncWaiter()) {
- MOJO_DCHECK(!internal_router_);
- internal::FilterChain filters;
- filters.Append<internal::MessageHeaderValidator>();
- filters.Append<typename Interface::RequestValidator_>();
-
- internal_router_ =
- new internal::Router(handle.Pass(), filters.Pass(), waiter);
- internal_router_->set_incoming_receiver(&stub_);
- internal_router_->set_connection_error_handler(
- [this]() { connection_error_handler_.Run(); });
- }
-
- // Completes a binding that was constructed with only an interface
- // implementation by creating a new message pipe, binding one end of it to the
- // previously specified implementation, and passing the other to |ptr|, which
- // takes ownership of it. The caller is expected to pass |ptr| on to the
- // eventual client of the service. Does not take ownership of |ptr|. See
- // class comment for definition of |waiter|.
- void Bind(
- InterfacePtr<Interface>* ptr,
- const MojoAsyncWaiter* waiter = Environment::GetDefaultAsyncWaiter()) {
- MessagePipe pipe;
- ptr->Bind(
- InterfacePtrInfo<Interface>(pipe.handle0.Pass(), Interface::Version_),
- waiter);
- Bind(pipe.handle1.Pass(), waiter);
- }
-
- // Completes a binding that was constructed with only an interface
- // implementation by removing the message pipe endpoint from |request| and
- // binding it to the previously specified implementation. See class comment
- // for definition of |waiter|.
- void Bind(
- InterfaceRequest<Interface> request,
- const MojoAsyncWaiter* waiter = Environment::GetDefaultAsyncWaiter()) {
- Bind(request.PassMessagePipe(), waiter);
- }
-
- // Stops processing incoming messages until
- // ResumeIncomingMethodCallProcessing(), or WaitForIncomingMethodCall().
- // Outgoing messages are still sent.
- //
- // No errors are detected on the message pipe while paused.
- void PauseIncomingMethodCallProcessing() {
- MOJO_DCHECK(internal_router_);
- internal_router_->PauseIncomingMethodCallProcessing();
- }
- void ResumeIncomingMethodCallProcessing() {
- MOJO_DCHECK(internal_router_);
- internal_router_->ResumeIncomingMethodCallProcessing();
- }
-
- // Blocks the calling thread until either a call arrives on the previously
- // bound message pipe, the deadline is exceeded, or an error occurs. Returns
- // true if a method was successfully read and dispatched.
- bool WaitForIncomingMethodCall(
- MojoDeadline deadline = MOJO_DEADLINE_INDEFINITE) {
- MOJO_DCHECK(internal_router_);
- return internal_router_->WaitForIncomingMessage(deadline);
- }
-
- // Closes the message pipe that was previously bound. Put this object into a
- // state where it can be rebound to a new pipe.
- void Close() {
- MOJO_DCHECK(internal_router_);
- internal_router_->CloseMessagePipe();
- DestroyRouter();
- }
-
- // Unbinds the underlying pipe from this binding and returns it so it can be
- // used in another context, such as on another thread or with a different
- // implementation. Put this object into a state where it can be rebound to a
- // new pipe.
- InterfaceRequest<Interface> Unbind() {
- InterfaceRequest<Interface> request =
- MakeRequest<Interface>(internal_router_->PassMessagePipe());
- DestroyRouter();
- // TODO(vtl): The |.Pass()| below is only needed due to an MSVS bug; remove
- // it once that's fixed.
- return request.Pass();
- }
-
- // Sets an error handler that will be called if a connection error occurs on
- // the bound message pipe.
- void set_connection_error_handler(const Closure& error_handler) {
- connection_error_handler_ = error_handler;
- }
-
- // Returns the interface implementation that was previously specified. Caller
- // does not take ownership.
- Interface* impl() { return impl_; }
-
- // Indicates whether the binding has been completed (i.e., whether a message
- // pipe has been bound to the implementation).
- bool is_bound() const { return !!internal_router_; }
-
- // Returns the value of the handle currently bound to this Binding which can
- // be used to make explicit Wait/WaitMany calls. Requires that the Binding be
- // bound. Ownership of the handle is retained by the Binding, it is not
- // transferred to the caller.
- MessagePipeHandle handle() const {
- MOJO_DCHECK(is_bound());
- return internal_router_->handle();
- }
-
- // Exposed for testing, should not generally be used.
- internal::Router* internal_router() { return internal_router_; }
-
- private:
- void DestroyRouter() {
- internal_router_->set_connection_error_handler(Closure());
- delete internal_router_;
- internal_router_ = nullptr;
- }
-
- internal::Router* internal_router_ = nullptr;
- typename Interface::Stub_ stub_;
- Interface* impl_;
- Closure connection_error_handler_;
-
- MOJO_DISALLOW_COPY_AND_ASSIGN(Binding);
-};
-
-} // namespace mojo
-
-#endif // THIRD_PARTY_MOJO_SRC_MOJO_PUBLIC_CPP_BINDINGS_BINDING_H_

Powered by Google App Engine
This is Rietveld 408576698