| Index: mojo/public/cpp/bindings/interface_impl.h
|
| diff --git a/mojo/public/cpp/bindings/interface_impl.h b/mojo/public/cpp/bindings/interface_impl.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..ec6bc9160e7701dcf4f45ef73c3d992fcb2d1bf9
|
| --- /dev/null
|
| +++ b/mojo/public/cpp/bindings/interface_impl.h
|
| @@ -0,0 +1,79 @@
|
| +// 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_PUBLIC_CPP_BINDINGS_INTERFACE_IMPL_H_
|
| +#define MOJO_PUBLIC_CPP_BINDINGS_INTERFACE_IMPL_H_
|
| +
|
| +#include "mojo/public/cpp/bindings/lib/interface_impl_internal.h"
|
| +#include "mojo/public/cpp/system/macros.h"
|
| +
|
| +namespace mojo {
|
| +
|
| +// InterfaceImpl<..> is designed to be the base class of an interface
|
| +// implementation. It may be bound to a pipe or a proxy, see BindToPipe and
|
| +// BindToProxy.
|
| +//
|
| +// NOTE: A base class of WithErrorHandler<Interface> is used to avoid multiple
|
| +// inheritance. This base class inserts the signature of ErrorHandler into the
|
| +// inheritance chain.
|
| +template <typename Interface>
|
| +class InterfaceImpl : public WithErrorHandler<Interface> {
|
| + public:
|
| + InterfaceImpl() : internal_state_(this) {}
|
| + virtual ~InterfaceImpl() {}
|
| +
|
| + // Subclasses must handle connection errors.
|
| + virtual void OnConnectionError() = 0;
|
| +
|
| + // DO NOT USE. Exposed only for internal use and for testing.
|
| + internal::InterfaceImplState<Interface>* internal_state() {
|
| + return &internal_state_;
|
| + }
|
| +
|
| + private:
|
| + internal::InterfaceImplState<Interface> internal_state_;
|
| + MOJO_DISALLOW_COPY_AND_ASSIGN(InterfaceImpl);
|
| +};
|
| +
|
| +// Takes an instance of an InterfaceImpl<..> subclass and binds it to the given
|
| +// MessagePipe. The instance is returned for convenience in member initializer
|
| +// lists, etc. If the pipe is closed, the instance's OnConnectionError method
|
| +// will be called.
|
| +//
|
| +// The instance is also bound to the current thread. Its methods will only be
|
| +// called on the current thread, and if the current thread exits, then it will
|
| +// also be deleted, and along with it, its end point of the pipe will be closed.
|
| +//
|
| +// Before returning, the instance will receive a SetClient call, providing it
|
| +// with a proxy to the client on the other end of the pipe.
|
| +template <typename Impl>
|
| +Impl* BindToPipe(Impl* instance,
|
| + ScopedMessagePipeHandle handle,
|
| + MojoAsyncWaiter* waiter = GetDefaultAsyncWaiter()) {
|
| + instance->internal_state()->Bind(handle.Pass(), waiter);
|
| + return instance;
|
| +}
|
| +
|
| +// Takes an instance of an InterfaceImpl<..> subclass and binds it to the given
|
| +// InterfacePtr<..>. The instance is returned for convenience in member
|
| +// initializer lists, etc. If the pipe is closed, the instance's
|
| +// OnConnectionError method will be called.
|
| +//
|
| +// The instance is also bound to the current thread. Its methods will only be
|
| +// called on the current thread, and if the current thread exits, then it will
|
| +// also be deleted, and along with it, its end point of the pipe will be closed.
|
| +//
|
| +// Before returning, the instance will receive a SetClient call, providing it
|
| +// with a proxy to the client on the other end of the pipe.
|
| +template <typename Impl, typename Interface>
|
| +Impl* BindToProxy(Impl* instance,
|
| + InterfacePtr<Interface>* ptr,
|
| + MojoAsyncWaiter* waiter = GetDefaultAsyncWaiter()) {
|
| + instance->internal_state()->BindProxy(ptr, waiter);
|
| + return instance;
|
| +}
|
| +
|
| +} // namespace mojo
|
| +
|
| +#endif // MOJO_PUBLIC_CPP_BINDINGS_INTERFACE_IMPL_H_
|
|
|