Index: mojo/public/java/bindings/src/org/chromium/mojo/bindings/Interface.java |
diff --git a/mojo/public/java/bindings/src/org/chromium/mojo/bindings/Interface.java b/mojo/public/java/bindings/src/org/chromium/mojo/bindings/Interface.java |
deleted file mode 100644 |
index c3b26a205dd6e13580ec1824ea782b8aee4c0583..0000000000000000000000000000000000000000 |
--- a/mojo/public/java/bindings/src/org/chromium/mojo/bindings/Interface.java |
+++ /dev/null |
@@ -1,257 +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. |
- |
-package org.chromium.mojo.bindings; |
- |
-import org.chromium.mojo.system.Core; |
-import org.chromium.mojo.system.MessagePipeHandle; |
-import org.chromium.mojo.system.MojoException; |
-import org.chromium.mojo.system.Pair; |
- |
-import java.io.Closeable; |
- |
-/** |
- * Base class for mojo generated interfaces. |
- */ |
-public interface Interface extends ConnectionErrorHandler, Closeable { |
- |
- /** |
- * The close method is called when the connection to the interface is closed. |
- * |
- * @see java.io.Closeable#close() |
- */ |
- @Override |
- public void close(); |
- |
- /** |
- * A proxy to a mojo interface. This is base class for all generated proxies. It implements the |
- * Interface and each time a method is called, the parameters are serialized and sent to the |
- * {@link MessageReceiverWithResponder}, along with the response callback if needed. |
- */ |
- public interface Proxy extends Interface { |
- |
- /** |
- * Set the {@link ConnectionErrorHandler} that will be notified of errors. |
- */ |
- public void setErrorHandler(ConnectionErrorHandler errorHandler); |
- |
- } |
- |
- /** |
- * Base implementation of {@link Proxy}. |
- */ |
- abstract class AbstractProxy implements Proxy { |
- |
- /** |
- * The {@link Core} implementation to use. |
- */ |
- private final Core mCore; |
- |
- /** |
- * The {@link MessageReceiverWithResponder} that will receive a serialized message for each |
- * method call. |
- */ |
- private final MessageReceiverWithResponder mMessageReceiver; |
- |
- /** |
- * The {@link ConnectionErrorHandler} that will be notified of errors. |
- */ |
- private ConnectionErrorHandler mErrorHandler = null; |
- |
- /** |
- * Constructor. |
- * |
- * @param core the Core implementation used to create pipes and access the async waiter. |
- * @param messageReceiver the message receiver to send message to. |
- */ |
- protected AbstractProxy(Core core, MessageReceiverWithResponder messageReceiver) { |
- this.mCore = core; |
- this.mMessageReceiver = messageReceiver; |
- } |
- |
- /** |
- * Returns the message receiver to send message to. |
- */ |
- protected MessageReceiverWithResponder getMessageReceiver() { |
- return mMessageReceiver; |
- } |
- |
- /** |
- * Returns the Core implementation. |
- */ |
- protected Core getCore() { |
- return mCore; |
- } |
- |
- /** |
- * @see Proxy#setErrorHandler(ConnectionErrorHandler) |
- */ |
- @Override |
- public void setErrorHandler(ConnectionErrorHandler errorHandler) { |
- this.mErrorHandler = errorHandler; |
- } |
- |
- /** |
- * @see ConnectionErrorHandler#onConnectionError(MojoException) |
- */ |
- @Override |
- public void onConnectionError(MojoException e) { |
- if (mErrorHandler != null) { |
- mErrorHandler.onConnectionError(e); |
- } |
- } |
- |
- /** |
- * @see Closeable#close() |
- */ |
- @Override |
- public void close() { |
- mMessageReceiver.close(); |
- } |
- } |
- |
- /** |
- * Base implementation of Stub. Stubs are message receivers that deserialize the payload and |
- * call the appropriate method in the implementation. If the method returns result, the stub |
- * serializes the response and sends it back. |
- * |
- * @param <I> the type of the interface to delegate calls to. |
- */ |
- abstract class Stub<I extends Interface> implements MessageReceiverWithResponder { |
- |
- /** |
- * The {@link Core} implementation to use. |
- */ |
- private final Core mCore; |
- |
- /** |
- * The implementation to delegate calls to. |
- */ |
- private final I mImpl; |
- |
- /** |
- * Constructor. |
- * |
- * @param core the {@link Core} implementation to use. |
- * @param impl the implementation to delegate calls to. |
- */ |
- public Stub(Core core, I impl) { |
- mCore = core; |
- mImpl = impl; |
- } |
- |
- /** |
- * Returns the Core implementation. |
- */ |
- protected Core getCore() { |
- return mCore; |
- } |
- |
- /** |
- * Returns the implementation to delegate calls to. |
- */ |
- protected I getImpl() { |
- return mImpl; |
- } |
- |
- /** |
- * @see org.chromium.mojo.bindings.MessageReceiver#close() |
- */ |
- @Override |
- public void close() { |
- mImpl.close(); |
- } |
- |
- } |
- |
- /** |
- * The |Manager| object enables building of proxies and stubs for a given interface. |
- * |
- * @param <I> the type of the interface the manager can handle. |
- * @param <P> the type of the proxy the manager can handle. To be noted, P always extends I. |
- */ |
- abstract class Manager<I extends Interface, P extends Proxy> { |
- |
- /** |
- * Returns the name of the interface. This is an opaque (but human readable) identifier used |
- * by the service provider to identify services. |
- */ |
- public abstract String getName(); |
- |
- /** |
- * Binds the given implementation to the handle. |
- */ |
- public void bind(I impl, MessagePipeHandle handle) { |
- // The router (and by consequence the handle) is intentionally leaked. It will close |
- // itself when the connected handle is closed and the proxy receives the connection |
- // error. |
- Router router = new RouterImpl(handle); |
- bind(handle.getCore(), impl, router); |
- router.start(); |
- } |
- |
- /** |
- * Binds the given implementation to the InterfaceRequest. |
- */ |
- public final void bind(I impl, InterfaceRequest<I> request) { |
- bind(impl, request.passHandle()); |
- } |
- |
- /** |
- * Returns a Proxy that will send messages to the given |handle|. This implies that the |
- * other end of the handle must be binded to an implementation of the interface. |
- */ |
- public final P attachProxy(MessagePipeHandle handle) { |
- RouterImpl router = new RouterImpl(handle); |
- P proxy = attachProxy(handle.getCore(), router); |
- DelegatingConnectionErrorHandler handlers = new DelegatingConnectionErrorHandler(); |
- handlers.addConnectionErrorHandler(proxy); |
- router.setErrorHandler(handlers); |
- router.start(); |
- return proxy; |
- } |
- |
- /** |
- * Constructs a new |InterfaceRequest| for the interface. This method returns a Pair where |
- * the first element is a proxy, and the second element is the request. The proxy can be |
- * used immediately. |
- */ |
- public final Pair<P, InterfaceRequest<I>> getInterfaceRequest(Core core) { |
- Pair<MessagePipeHandle, MessagePipeHandle> handles = core.createMessagePipe(null); |
- P proxy = attachProxy(handles.first); |
- return Pair.create(proxy, new InterfaceRequest<I>(handles.second)); |
- } |
- |
- /** |
- * Binds the implementation to the given |router|. |
- */ |
- final void bind(Core core, I impl, Router router) { |
- router.setErrorHandler(impl); |
- router.setIncomingMessageReceiver(buildStub(core, impl)); |
- } |
- |
- /** |
- * Returns a Proxy that will send messages to the given |router|. |
- */ |
- final P attachProxy(Core core, Router router) { |
- return buildProxy(core, new AutoCloseableRouter(core, router)); |
- } |
- |
- /** |
- * Creates a new array of the given |size|. |
- */ |
- protected abstract I[] buildArray(int size); |
- |
- /** |
- * Constructs a Stub delegating to the given implementation. |
- */ |
- protected abstract Stub<I> buildStub(Core core, I impl); |
- |
- /** |
- * Constructs a Proxy forwarding the calls to the given message receiver. |
- */ |
- protected abstract P buildProxy(Core core, MessageReceiverWithResponder messageReceiver); |
- |
- } |
-} |