Class InternalLazyField

java.lang.Object

com.google.protobuf.InternalLazyField

class InternalLazyField
extends Object

InternalLazyField encapsulates the logic of lazily parsing message fields. It stores the message in a ByteString initially and then parses it on-demand.

The invariants of InternalLazyField are that 1) once value or bytes is set, they will not be changed; 2) value and bytes cannot be null at the same time; 3) If corrupted is true, value must be null.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	InternalLazyField.LazyEntry<K>	LazyEntry and LazyIterator are used to encapsulate the lazy field, when users iterate all fields from FieldSet.
(package private) static class	InternalLazyField.LazyIterator<K>

Field Summary

Fields

Modifier and Type	Field	Description
private ByteString	bytes
private boolean	corrupted
private final MessageLite	defaultInstance
private final ExtensionRegistryLite	extensionRegistry
protected MessageLite	value

Constructor Summary

Constructors

Constructor	Description
InternalLazyField(MessageLite message)	Constructor for InternalLazyField that takes in a message value.
InternalLazyField(MessageLite defaultInstance, ExtensionRegistryLite extensionRegistry, ByteString bytes)	Constructor for InternalLazyField.

Method Summary

Modifier and Type	Method	Description
(package private) int	computeMessageSetExtensionSize(int fieldNumber)
(package private) int	computeSize(int fieldNumber)
(package private) int	computeSizeNoTag()
private void	ensureInitialized()	Guarantees that `this.value` is non-null or throws.
boolean	equals(Object obj)
(package private) int	getSerializedSize()
(package private) MessageLite	getValue()	Returns the parsed message value.
private boolean	hasBytes()
int	hashCode()
private boolean	isEmpty()
(package private) static InternalLazyField	mergeFrom(InternalLazyField lazyField, CodedInputStream input, ExtensionRegistryLite extensionRegistry)	Merges the InternalLazyField from the given CodedInputStream with the given extension registry.
(package private) static InternalLazyField	mergeFrom(InternalLazyField self, InternalLazyField other)	Merges a InternalLazyField from another InternalLazyField.
(package private) ByteString	toByteString()
String	toString()
(package private) void	writeTo(CodedOutputStreamWriter writer, int fieldNumber)

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

defaultInstance

private final MessageLite defaultInstance

extensionRegistry

private final ExtensionRegistryLite extensionRegistry

bytes

private volatile ByteString bytes

value

protected volatile MessageLite value

corrupted

private volatile boolean corrupted

Constructor Details

InternalLazyField

InternalLazyField(MessageLite defaultInstance,
 ExtensionRegistryLite extensionRegistry,
 ByteString bytes)

Constructor for InternalLazyField. All arguments cannot be null.

InternalLazyField

InternalLazyField(MessageLite message)

Constructor for InternalLazyField that takes in a message value. The argument cannot be null.

Method Details

mergeFrom

static InternalLazyField mergeFrom(InternalLazyField lazyField,
 CodedInputStream input,
 ExtensionRegistryLite extensionRegistry)
                            throws IOException

Merges the InternalLazyField from the given CodedInputStream with the given extension registry.

Precondition: the input stream should have already read the tag and be expected to read the size of the bytes next.

Throws:

IOException - only if an error occurs while reading the raw bytes from the input stream, not for failures in parsing the read bytes.

InvalidProtobufRuntimeException - if the lazy field is corrupted and cannot be merged with a different extension registry.

mergeFrom

static InternalLazyField mergeFrom(InternalLazyField self,
 InternalLazyField other)

Merges a InternalLazyField from another InternalLazyField.

Throws:

InvalidProtobufRuntimeException - if either lazy field is corrupted and cannot be merged with a different extension registry.

hasBytes

private boolean hasBytes()

isEmpty

private boolean isEmpty()

ensureInitialized

private void ensureInitialized()
                        throws InvalidProtocolBufferException

Guarantees that `this.value` is non-null or throws.

Throws:

InvalidProtocolBufferException - If `bytes` cannot be parsed.

getValue

MessageLite getValue()

Returns the parsed message value.

If the lazy field is corrupted, it will throw a runtime exception if ExtensionRegistryLite.lazyExtensionEnabled() is true, otherwise it will return the default instance.

getSerializedSize

int getSerializedSize()

toByteString

ByteString toByteString()

computeSizeNoTag

int computeSizeNoTag()

computeSize

int computeSize(int fieldNumber)

computeMessageSetExtensionSize

int computeMessageSetExtensionSize(int fieldNumber)

writeTo

void writeTo(CodedOutputStreamWriter writer,
 int fieldNumber)
      throws IOException

Throws:

IOException

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object