public abstract static class GeneratedMessageLite.Builder<MessageType extends GeneratedMessageLite<MessageType,BuilderType>,BuilderType extends GeneratedMessageLite.Builder<MessageType,BuilderType>> extends AbstractMessageLite.Builder<MessageType,BuilderType>
| Modifier and Type | Field and Description |
|---|---|
protected MessageType |
instance |
protected boolean |
isBuilt |
| Modifier | Constructor and Description |
|---|---|
protected |
Builder(MessageType defaultInstance) |
| Modifier and Type | Method and Description |
|---|---|
MessageType |
build()
Constructs the message based on the state of the Builder.
|
MessageType |
buildPartial()
Like
MessageLite.Builder.build(), but does not throw an exception if the message is missing required fields. |
BuilderType |
clear()
Resets all fields to their default values.
|
BuilderType |
clone()
Creates and returns a copy of this object.
|
protected void |
copyOnWrite()
Called before any method that would mutate the builder to ensure that it correctly copies any state before
the write happens to preserve immutability guarantees.
|
MessageType |
getDefaultInstanceForType()
Get an instance of the type with no fields set.
|
protected BuilderType |
internalMergeFrom(MessageType message) |
boolean |
isInitialized()
Returns true if all required fields in the message and all embedded messages are set, false otherwise.
|
BuilderType |
mergeFrom(CodedInputStream input,
ExtensionRegistryLite extensionRegistry)
Like
MessageLite.Builder.mergeFrom(CodedInputStream), but also parses extensions. |
BuilderType |
mergeFrom(MessageType message)
All subclasses implement this.
|
addAll, mergeDelimitedFrom, mergeDelimitedFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, newUninitializedMessageExceptionprotected MessageType extends GeneratedMessageLite<MessageType,BuilderType> instance
protected boolean isBuilt
protected Builder(MessageType defaultInstance)
public final MessageType build()
MessageLite.Builderpublic MessageType buildPartial()
MessageLite.BuilderMessageLite.Builder.build(), but does not throw an exception if the message is missing required fields. Instead, a
partial message is returned. Subsequent changes to the Builder will not affect the returned message.public final BuilderType clear()
MessageLite.Builderpublic BuilderType clone()
Objectx, the expression: will be true, and that the expression:x.clone() != x
will bex.clone().getClass() == x.getClass()
true, but these are not absolute requirements. While it is
typically the case that: will bex.clone().equals(x)
true, this is not an absolute requirement.
By convention, the returned object should be obtained by calling super.clone. If a class
and all of its superclasses (except Object) obey this convention, it will be the case
that x.clone().getClass() == x.getClass().
By convention, the object returned by this method should be independent of this object (which is
being cloned). To achieve this independence, it may be necessary to modify one or more fields of
the object returned by super.clone before returning it. Typically, this means copying any
mutable objects that comprise the internal "deep structure" of the object being cloned and
replacing the references to these objects with references to the copies. If a class contains only
primitive fields or references to immutable objects, then it is usually the case that no fields
in the object returned by super.clone need to be modified.
The method clone for class Object performs a specific cloning operation. First,
if the class of this object does not implement the interface Cloneable, then a
CloneNotSupportedException is thrown. Note that all arrays are considered to implement
the interface Cloneable and that the return type of the clone method of an array
type T[] is T[] where T is any reference or primitive type. Otherwise, this
method creates a new instance of the class of this object and initializes all its fields with
exactly the contents of the corresponding fields of this object, as if by assignment; the
contents of the fields are not themselves cloned. Thus, this method performs a "shallow copy" of
this object, not a "deep copy" operation.
The class Object does not itself implement the interface Cloneable, so calling
the clone method on an object whose class is Object will result in throwing an
exception at run time.
clone in interface MessageLite.Builderclone in class AbstractMessageLite.Builder<MessageType extends GeneratedMessageLite<MessageType,BuilderType>,BuilderType extends GeneratedMessageLite.Builder<MessageType,BuilderType>>Cloneableprotected void copyOnWrite()
public MessageType getDefaultInstanceForType()
MessageLiteOrBuildergetDefaultInstance() method of generated message classes in that this method is an abstract
method of the MessageLite interface whereas getDefaultInstance() is a static method of a specific
class. They return the same thing.protected BuilderType internalMergeFrom(MessageType message)
internalMergeFrom in class AbstractMessageLite.Builder<MessageType extends GeneratedMessageLite<MessageType,BuilderType>,BuilderType extends GeneratedMessageLite.Builder<MessageType,BuilderType>>public final boolean isInitialized()
MessageLiteOrBuilderpublic BuilderType mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry) throws IOException
MessageLite.BuilderMessageLite.Builder.mergeFrom(CodedInputStream), but also parses extensions. The extensions that you want to
be able to parse must be registered in extensionRegistry. Extensions not in the registry will be
treated as unknown fields.mergeFrom in interface MessageLite.BuildermergeFrom in class AbstractMessageLite.Builder<MessageType extends GeneratedMessageLite<MessageType,BuilderType>,BuilderType extends GeneratedMessageLite.Builder<MessageType,BuilderType>>IOExceptionpublic BuilderType mergeFrom(MessageType message)