Index: mojo/public/java/system/src/org/chromium/mojo/system/MessagePipeHandle.java |
diff --git a/mojo/public/java/system/src/org/chromium/mojo/system/MessagePipeHandle.java b/mojo/public/java/system/src/org/chromium/mojo/system/MessagePipeHandle.java |
deleted file mode 100644 |
index 60ac6825b42e40350750d595dbbed4dbc6f75a9a..0000000000000000000000000000000000000000 |
--- a/mojo/public/java/system/src/org/chromium/mojo/system/MessagePipeHandle.java |
+++ /dev/null |
@@ -1,242 +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.system; |
- |
-import java.nio.ByteBuffer; |
-import java.util.List; |
- |
-/** |
- * Message pipes are bidirectional communication channel for framed data (i.e., messages). Messages |
- * can contain plain data and/or Mojo handles. |
- */ |
-public interface MessagePipeHandle extends Handle { |
- |
- /** |
- * Flags for the message pipe creation operation. |
- */ |
- public static class CreateFlags extends Flags<CreateFlags> { |
- private static final int FLAG_NONE = 0; |
- |
- /** |
- * Immutable flag with not bit set. |
- */ |
- public static final CreateFlags NONE = CreateFlags.none().immutable(); |
- |
- /** |
- * Dedicated constructor. |
- * |
- * @param flags initial value of the flags. |
- */ |
- protected CreateFlags(int flags) { |
- super(flags); |
- } |
- |
- /** |
- * @return flags with no bit set. |
- */ |
- public static CreateFlags none() { |
- return new CreateFlags(FLAG_NONE); |
- } |
- |
- } |
- |
- /** |
- * Used to specify creation parameters for a message pipe to |Core#createMessagePipe()|. |
- */ |
- public static class CreateOptions { |
- private CreateFlags mFlags = CreateFlags.NONE; |
- |
- /** |
- * @return the flags |
- */ |
- public CreateFlags getFlags() { |
- return mFlags; |
- } |
- |
- } |
- |
- /** |
- * Flags for the write operations on MessagePipeHandle . |
- */ |
- public static class WriteFlags extends Flags<WriteFlags> { |
- private static final int FLAG_NONE = 0; |
- |
- /** |
- * Immutable flag with no bit set. |
- */ |
- public static final WriteFlags NONE = WriteFlags.none().immutable(); |
- |
- /** |
- * Dedicated constructor. |
- * |
- * @param flags initial value of the flag. |
- */ |
- private WriteFlags(int flags) { |
- super(flags); |
- } |
- |
- /** |
- * @return a flag with no bit set. |
- */ |
- public static WriteFlags none() { |
- return new WriteFlags(FLAG_NONE); |
- } |
- } |
- |
- /** |
- * Flags for the read operations on MessagePipeHandle. |
- */ |
- public static class ReadFlags extends Flags<ReadFlags> { |
- private static final int FLAG_NONE = 0; |
- private static final int FLAG_MAY_DISCARD = 1 << 0; |
- |
- /** |
- * Immutable flag with no bit set. |
- */ |
- public static final ReadFlags NONE = ReadFlags.none().immutable(); |
- |
- /** |
- * Dedicated constructor. |
- * |
- * @param flags initial value of the flag. |
- */ |
- private ReadFlags(int flags) { |
- super(flags); |
- } |
- |
- /** |
- * Change the may-discard bit of this flag. If set, if the message is unable to be read for |
- * whatever reason (e.g., the caller-supplied buffer is too small), discard the message |
- * (i.e., simply dequeue it). |
- * |
- * @param mayDiscard the new value of the may-discard bit. |
- * @return this. |
- */ |
- public ReadFlags setMayDiscard(boolean mayDiscard) { |
- return setFlag(FLAG_MAY_DISCARD, mayDiscard); |
- } |
- |
- /** |
- * @return a flag with no bit set. |
- */ |
- public static ReadFlags none() { |
- return new ReadFlags(FLAG_NONE); |
- } |
- |
- } |
- |
- /** |
- * Result of the |readMessage| method. |
- */ |
- public static class ReadMessageResult { |
- /** |
- * The MojoResult value of the read call. |
- */ |
- private int mMojoResult; |
- /** |
- * If a message was read, the size in bytes of the message, otherwise the size in bytes of |
- * the next message. |
- */ |
- private int mMessageSize; |
- /** |
- * If a message was read, the number of handles contained in the message, otherwise the |
- * number of handles contained in the next message. |
- */ |
- private int mHandlesCount; |
- /** |
- * If a message was read, the handles contained in the message, undefined otherwise. |
- */ |
- private List<UntypedHandle> mHandles; |
- |
- /** |
- * @return the mojoResult |
- */ |
- public int getMojoResult() { |
- return mMojoResult; |
- } |
- |
- /** |
- * @param mojoResult the mojoResult to set |
- */ |
- public void setMojoResult(int mojoResult) { |
- mMojoResult = mojoResult; |
- } |
- |
- /** |
- * @return the messageSize |
- */ |
- public int getMessageSize() { |
- return mMessageSize; |
- } |
- |
- /** |
- * @param messageSize the messageSize to set |
- */ |
- public void setMessageSize(int messageSize) { |
- mMessageSize = messageSize; |
- } |
- |
- /** |
- * @return the handlesCount |
- */ |
- public int getHandlesCount() { |
- return mHandlesCount; |
- } |
- |
- /** |
- * @param handlesCount the handlesCount to set |
- */ |
- public void setHandlesCount(int handlesCount) { |
- mHandlesCount = handlesCount; |
- } |
- |
- /** |
- * @return the handles |
- */ |
- public List<UntypedHandle> getHandles() { |
- return mHandles; |
- } |
- |
- /** |
- * @param handles the handles to set |
- */ |
- public void setHandles(List<UntypedHandle> handles) { |
- mHandles = handles; |
- } |
- } |
- |
- /** |
- * @see org.chromium.mojo.system.Handle#pass() |
- */ |
- @Override |
- public MessagePipeHandle pass(); |
- |
- /** |
- * Writes a message to the message pipe endpoint, with message data specified by |bytes| and |
- * attached handles specified by |handles|, and options specified by |flags|. If there is no |
- * message data, |bytes| may be null, otherwise it must be a direct ByteBuffer. If there are no |
- * attached handles, |handles| may be null. |
- * <p> |
- * If handles are attached, on success the handles will no longer be valid (the receiver will |
- * receive equivalent, but logically different, handles). Handles to be sent should not be in |
- * simultaneous use (e.g., on another thread). |
- */ |
- void writeMessage(ByteBuffer bytes, List<? extends Handle> handles, WriteFlags flags); |
- |
- /** |
- * Reads a message from the message pipe endpoint; also usable to query the size of the next |
- * message or discard the next message. |bytes| indicate the buffer/buffer size to receive the |
- * message data (if any) and |maxNumberOfHandles| indicate the maximum handle count to receive |
- * the attached handles (if any). |bytes| is optional. If null, |maxNumberOfHandles| must be |
- * zero, and the return value will indicate the size of the next message. If non-null, it must |
- * be a direct ByteBuffer and the return value will indicate if the message was read or not. If |
- * the message was read its content will be in |bytes|, and the attached handles will be in the |
- * return value. Partial reads are NEVER done. Either a full read is done and |wasMessageRead| |
- * will be true, or the read is NOT done and |wasMessageRead| will be false (if |mayDiscard| was |
- * set, the message is also discarded in this case). |
- */ |
- ReadMessageResult readMessage(ByteBuffer bytes, int maxNumberOfHandles, |
- ReadFlags flags); |
-} |