com.google.protobuf

Class AbstractMessageLite<MessageType extends AbstractMessageLite<MessageType,BuilderType>,BuilderType extends AbstractMessageLite.Builder<MessageType,BuilderType>>

java.lang.Object

com.google.protobuf.AbstractMessageLite<MessageType,BuilderType>

Type Parameters:

MessageType - the type of the message.

BuilderType - the type of the builder.

All Implemented Interfaces:

MessageLite, MessageLiteOrBuilder

Direct Known Subclasses:

GeneratedMessageLite

public abstract class AbstractMessageLite<MessageType extends AbstractMessageLite<MessageType,BuilderType>,BuilderType extends AbstractMessageLite.Builder<MessageType,BuilderType>>
extends Object
implements MessageLite

A partial implementation of the MessageLite interface which implements as many methods of that interface as possible in terms of other methods.

Author:

kenton@google.com Kenton Varda

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractMessageLite.Builder<MessageType extends AbstractMessageLite<MessageType,BuilderType>,BuilderType extends AbstractMessageLite.Builder<MessageType,BuilderType>> A partial implementation of the MessageLite.Builder interface which implements as many methods of that interface as possible in terms of other methods.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	memoizedHashCode Hashcode.

Constructor Summary

Constructors

Constructor and Description
AbstractMessageLite()

Method Summary

Modifier and Type	Method and Description
protected static <T> void	addAll(Iterable<T> values, Collection<? super T> list) Adds all values to the given list.
protected static void	checkByteStringIsUtf8(ByteString byteString) Checks wheter a ByteString is encoded in Utf-8.
byte[]	toByteArray() Serializes the message to a byte array and returns it.
ByteString	toByteString() Serializes the message to a ByteString and returns it.
void	writeDelimitedTo(OutputStream output) Like MessageLite.writeTo(OutputStream), but writes the size of the message as a varint before writing the data.
void	writeTo(OutputStream output) Serializes the message and writes it to output.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.google.protobuf.MessageLite

getParserForType, getSerializedSize, newBuilderForType, toBuilder, writeTo

Methods inherited from interface com.google.protobuf.MessageLiteOrBuilder

getDefaultInstanceForType, isInitialized

Field Detail

memoizedHashCode

protected int memoizedHashCode

Hashcode.

Constructor Detail

AbstractMessageLite

public AbstractMessageLite()

Method Detail

addAll

protected static <T> void addAll(Iterable<T> values,
                                 Collection<? super T> list)

Adds all values to the given list.

Parameters:

values - the values to add.

list - the list in which the values will be added.

checkByteStringIsUtf8

protected static void checkByteStringIsUtf8(ByteString byteString)
                                     throws IllegalArgumentException

Checks wheter a ByteString is encoded in Utf-8.

Parameters:

byteString - the ByteString to test.

Throws:

IllegalArgumentException - when the ByteString is not encoded in Utf-8.

toByteArray

public byte[] toByteArray()

Description copied from interface: MessageLite

Serializes the message to a byte array and returns it. This is just a trivial wrapper around MessageLite.writeTo(CodedOutputStream).

Specified by:

toByteArray in interface MessageLite

toByteString

public ByteString toByteString()

Description copied from interface: MessageLite

Serializes the message to a ByteString and returns it. This is just a trivial wrapper around MessageLite.writeTo(CodedOutputStream).

Specified by:

toByteString in interface MessageLite

writeDelimitedTo

public void writeDelimitedTo(OutputStream output)
                      throws IOException

Description copied from interface: MessageLite

Like MessageLite.writeTo(OutputStream), but writes the size of the message as a varint before writing the data. This allows more data to be written to the stream after the message without the need to delimit the message data yourself. Use MessageLite.Builder.mergeDelimitedFrom(InputStream) (or the static method YourMessageType.parseDelimitedFrom(InputStream)) to parse messages written by this method.

Specified by:

writeDelimitedTo in interface MessageLite

Throws:

IOException

writeTo

public void writeTo(OutputStream output)
             throws IOException

Description copied from interface: MessageLite

Serializes the message and writes it to output. This is just a trivial wrapper around MessageLite.writeTo(CodedOutputStream). This does not flush or close the stream.

NOTE: Protocol Buffers are not self-delimiting. Therefore, if you write any more data to the stream after the message, you must somehow ensure that the parser on the receiving end does not interpret this as being part of the protocol message. This can be done e.g. by writing the size of the message before the data, then making sure to limit the input to that size on the receiving end (e.g. by wrapping the InputStream in one which limits the input). Alternatively, just use MessageLite.writeDelimitedTo(OutputStream).

Specified by:

writeTo in interface MessageLite

Throws:

IOException