| Index: third_party/protobuf/java/src/main/java/com/google/protobuf/Message.java
|
| diff --git a/third_party/protobuf/java/src/main/java/com/google/protobuf/Message.java b/third_party/protobuf/java/src/main/java/com/google/protobuf/Message.java
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..67c4148eec2ec337e389ad9ed6c461759a26f3ff
|
| --- /dev/null
|
| +++ b/third_party/protobuf/java/src/main/java/com/google/protobuf/Message.java
|
| @@ -0,0 +1,215 @@
|
| +// Protocol Buffers - Google's data interchange format
|
| +// Copyright 2008 Google Inc. All rights reserved.
|
| +// http://code.google.com/p/protobuf/
|
| +//
|
| +// Redistribution and use in source and binary forms, with or without
|
| +// modification, are permitted provided that the following conditions are
|
| +// met:
|
| +//
|
| +// * Redistributions of source code must retain the above copyright
|
| +// notice, this list of conditions and the following disclaimer.
|
| +// * Redistributions in binary form must reproduce the above
|
| +// copyright notice, this list of conditions and the following disclaimer
|
| +// in the documentation and/or other materials provided with the
|
| +// distribution.
|
| +// * Neither the name of Google Inc. nor the names of its
|
| +// contributors may be used to endorse or promote products derived from
|
| +// this software without specific prior written permission.
|
| +//
|
| +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
| +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
| +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
| +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
| +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
| +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
| +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
| +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
| +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
| +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
| +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
| +
|
| +// TODO(kenton): Use generics? E.g. Builder<BuilderType extends Builder>, then
|
| +// mergeFrom*() could return BuilderType for better type-safety.
|
| +
|
| +package com.google.protobuf;
|
| +
|
| +import java.io.IOException;
|
| +import java.io.InputStream;
|
| +import java.util.Map;
|
| +
|
| +/**
|
| + * Abstract interface implemented by Protocol Message objects.
|
| + * <p>
|
| + * See also {@link MessageLite}, which defines most of the methods that typical
|
| + * users care about. {@link Message} adds to it methods that are not available
|
| + * in the "lite" runtime. The biggest added features are introspection and
|
| + * reflection -- i.e., getting descriptors for the message type and accessing
|
| + * the field values dynamically.
|
| + *
|
| + * @author kenton@google.com Kenton Varda
|
| + */
|
| +public interface Message extends MessageLite, MessageOrBuilder {
|
| +
|
| + // -----------------------------------------------------------------
|
| + // Comparison and hashing
|
| +
|
| + /**
|
| + * Compares the specified object with this message for equality. Returns
|
| + * <tt>true</tt> if the given object is a message of the same type (as
|
| + * defined by {@code getDescriptorForType()}) and has identical values for
|
| + * all of its fields. Subclasses must implement this; inheriting
|
| + * {@code Object.equals()} is incorrect.
|
| + *
|
| + * @param other object to be compared for equality with this message
|
| + * @return <tt>true</tt> if the specified object is equal to this message
|
| + */
|
| + @Override
|
| + boolean equals(Object other);
|
| +
|
| + /**
|
| + * Returns the hash code value for this message. The hash code of a message
|
| + * should mix the message's type (object identity of the decsriptor) with its
|
| + * contents (known and unknown field values). Subclasses must implement this;
|
| + * inheriting {@code Object.hashCode()} is incorrect.
|
| + *
|
| + * @return the hash code value for this message
|
| + * @see Map#hashCode()
|
| + */
|
| + @Override
|
| + int hashCode();
|
| +
|
| + // -----------------------------------------------------------------
|
| + // Convenience methods.
|
| +
|
| + /**
|
| + * Converts the message to a string in protocol buffer text format. This is
|
| + * just a trivial wrapper around {@link TextFormat#printToString(Message)}.
|
| + */
|
| + @Override
|
| + String toString();
|
| +
|
| + // =================================================================
|
| + // Builders
|
| +
|
| + // (From MessageLite, re-declared here only for return type covariance.)
|
| + Builder newBuilderForType();
|
| + Builder toBuilder();
|
| +
|
| + /**
|
| + * Abstract interface implemented by Protocol Message builders.
|
| + */
|
| + interface Builder extends MessageLite.Builder, MessageOrBuilder {
|
| + // (From MessageLite.Builder, re-declared here only for return type
|
| + // covariance.)
|
| + Builder clear();
|
| +
|
| + /**
|
| + * Merge {@code other} into the message being built. {@code other} must
|
| + * have the exact same type as {@code this} (i.e.
|
| + * {@code getDescriptorForType() == other.getDescriptorForType()}).
|
| + *
|
| + * Merging occurs as follows. For each field:<br>
|
| + * * For singular primitive fields, if the field is set in {@code other},
|
| + * then {@code other}'s value overwrites the value in this message.<br>
|
| + * * For singular message fields, if the field is set in {@code other},
|
| + * it is merged into the corresponding sub-message of this message
|
| + * using the same merging rules.<br>
|
| + * * For repeated fields, the elements in {@code other} are concatenated
|
| + * with the elements in this message.
|
| + *
|
| + * This is equivalent to the {@code Message::MergeFrom} method in C++.
|
| + */
|
| + Builder mergeFrom(Message other);
|
| +
|
| + // (From MessageLite.Builder, re-declared here only for return type
|
| + // covariance.)
|
| + Message build();
|
| + Message buildPartial();
|
| + Builder clone();
|
| + Builder mergeFrom(CodedInputStream input) throws IOException;
|
| + Builder mergeFrom(CodedInputStream input,
|
| + ExtensionRegistryLite extensionRegistry)
|
| + throws IOException;
|
| +
|
| + /**
|
| + * Get the message's type's descriptor.
|
| + * See {@link Message#getDescriptorForType()}.
|
| + */
|
| + Descriptors.Descriptor getDescriptorForType();
|
| +
|
| + /**
|
| + * Create a Builder for messages of the appropriate type for the given
|
| + * field. Messages built with this can then be passed to setField(),
|
| + * setRepeatedField(), or addRepeatedField().
|
| + */
|
| + Builder newBuilderForField(Descriptors.FieldDescriptor field);
|
| +
|
| + /**
|
| + * Sets a field to the given value. The value must be of the correct type
|
| + * for this field, i.e. the same type that
|
| + * {@link Message#getField(Descriptors.FieldDescriptor)} would return.
|
| + */
|
| + Builder setField(Descriptors.FieldDescriptor field, Object value);
|
| +
|
| + /**
|
| + * Clears the field. This is exactly equivalent to calling the generated
|
| + * "clear" accessor method corresponding to the field.
|
| + */
|
| + Builder clearField(Descriptors.FieldDescriptor field);
|
| +
|
| + /**
|
| + * Sets an element of a repeated field to the given value. The value must
|
| + * be of the correct type for this field, i.e. the same type that
|
| + * {@link Message#getRepeatedField(Descriptors.FieldDescriptor,int)} would
|
| + * return.
|
| + * @throws IllegalArgumentException The field is not a repeated field, or
|
| + * {@code field.getContainingType() != getDescriptorForType()}.
|
| + */
|
| + Builder setRepeatedField(Descriptors.FieldDescriptor field,
|
| + int index, Object value);
|
| +
|
| + /**
|
| + * Like {@code setRepeatedField}, but appends the value as a new element.
|
| + * @throws IllegalArgumentException The field is not a repeated field, or
|
| + * {@code field.getContainingType() != getDescriptorForType()}.
|
| + */
|
| + Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value);
|
| +
|
| + /** Set the {@link UnknownFieldSet} for this message. */
|
| + Builder setUnknownFields(UnknownFieldSet unknownFields);
|
| +
|
| + /**
|
| + * Merge some unknown fields into the {@link UnknownFieldSet} for this
|
| + * message.
|
| + */
|
| + Builder mergeUnknownFields(UnknownFieldSet unknownFields);
|
| +
|
| + // ---------------------------------------------------------------
|
| + // Convenience methods.
|
| +
|
| + // (From MessageLite.Builder, re-declared here only for return type
|
| + // covariance.)
|
| + Builder mergeFrom(ByteString data) throws InvalidProtocolBufferException;
|
| + Builder mergeFrom(ByteString data,
|
| + ExtensionRegistryLite extensionRegistry)
|
| + throws InvalidProtocolBufferException;
|
| + Builder mergeFrom(byte[] data) throws InvalidProtocolBufferException;
|
| + Builder mergeFrom(byte[] data, int off, int len)
|
| + throws InvalidProtocolBufferException;
|
| + Builder mergeFrom(byte[] data,
|
| + ExtensionRegistryLite extensionRegistry)
|
| + throws InvalidProtocolBufferException;
|
| + Builder mergeFrom(byte[] data, int off, int len,
|
| + ExtensionRegistryLite extensionRegistry)
|
| + throws InvalidProtocolBufferException;
|
| + Builder mergeFrom(InputStream input) throws IOException;
|
| + Builder mergeFrom(InputStream input,
|
| + ExtensionRegistryLite extensionRegistry)
|
| + throws IOException;
|
| + boolean mergeDelimitedFrom(InputStream input)
|
| + throws IOException;
|
| + boolean mergeDelimitedFrom(InputStream input,
|
| + ExtensionRegistryLite extensionRegistry)
|
| + throws IOException;
|
| + }
|
| +}
|
|
|