Package com.google.protobuf

Class FieldSet.Builder<T extends FieldSet.FieldDescriptorLite<T>>

java.lang.Object

com.google.protobuf.FieldSet.Builder<T>

Enclosing class:

FieldSet<T extends FieldSet.FieldDescriptorLite<T>>

static final class FieldSet.Builder<T extends FieldSet.FieldDescriptorLite<T>>
extends java.lang.Object

A FieldSet Builder that accept a MessageLite.Builder as a field value. This is useful for implementing methods in MessageLite.Builder.

Field Summary

Fields

Modifier and Type	Field	Description
private SmallSortedMap<T,java.lang.Object>	fields
private boolean	hasLazyField
private boolean	hasNestedBuilders
private boolean	isMutable

Constructor Summary

Constructors

Modifier	Constructor	Description
private	Builder()
private	Builder(SmallSortedMap<T,java.lang.Object> fields)

Method Summary

Modifier and Type	Method	Description
void	addRepeatedField(T descriptor, java.lang.Object value)	Useful for implementing Message.Builder.addRepeatedField(Descriptors.FieldDescriptor, Object).
FieldSet<T>	build()	Creates the FieldSet
private FieldSet<T>	buildImpl(boolean partial)	Creates the FieldSet.
FieldSet<T>	buildPartial()	Creates the FieldSet but does not validate that all required fields are present.
void	clearField(T descriptor)	Useful for implementing Message.Builder.clearField(Descriptors.FieldDescriptor).
private void	ensureIsMutable()
static <T extends FieldSet.FieldDescriptorLite<T>> FieldSet.Builder<T>	fromFieldSet(FieldSet<T> fieldSet)	Returns a new Builder using the fields from fieldSet.
java.util.Map<T,java.lang.Object>	getAllFields()	Get a simple map containing all the fields.
java.lang.Object	getField(T descriptor)	Useful for implementing MessageOrBuilder.getField(Descriptors.FieldDescriptor).
(package private) java.lang.Object	getFieldAllowBuilders(T descriptor)	Same as #getField(F), but allow a MessageLite.Builder to be returned.
java.lang.Object	getRepeatedField(T descriptor, int index)	Useful for implementing MessageOrBuilder.getRepeatedField(Descriptors.FieldDescriptor, int).
(package private) java.lang.Object	getRepeatedFieldAllowBuilders(T descriptor, int index)	Same as #getRepeatedField(F, int), but allow a MessageLite.Builder to be returned.
int	getRepeatedFieldCount(T descriptor)	Useful for implementing MessageOrBuilder.getRepeatedFieldCount(Descriptors.FieldDescriptor).
boolean	hasField(T descriptor)	Useful for implementing MessageOrBuilder.hasField(Descriptors.FieldDescriptor).
boolean	isInitialized()	See MessageLiteOrBuilder.isInitialized().
void	mergeFrom(FieldSet<T> other)	Like Message.Builder.mergeFrom(Message), but merges from another FieldSet.
private void	mergeFromField(java.util.Map.Entry<T,java.lang.Object> entry)
private static java.lang.Object	replaceBuilder(java.lang.Object value, boolean partial)
private static <T extends FieldSet.FieldDescriptorLite<T>> void	replaceBuilders(SmallSortedMap<T,java.lang.Object> fieldMap, boolean partial)
private static <T extends FieldSet.FieldDescriptorLite<T>> void	replaceBuilders(java.util.Map.Entry<T,java.lang.Object> entry, boolean partial)
private static <T extends FieldSet.FieldDescriptorLite<T>> java.lang.Object	replaceBuilders(T descriptor, java.lang.Object value, boolean partial)
void	setField(T descriptor, java.lang.Object value)	Useful for implementing Message.Builder.setField(Descriptors.FieldDescriptor, Object).
void	setRepeatedField(T descriptor, int index, java.lang.Object value)	Useful for implementing Message.Builder.setRepeatedField(Descriptors.FieldDescriptor, int, Object).
private void	verifyType(T descriptor, java.lang.Object value)	Verifies that the given object is of the correct type to be a valid value for the given field.

Methods inherited from class java.lang.Object

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

Field Detail

fields

private SmallSortedMap<T extends FieldSet.FieldDescriptorLite<T>,java.lang.Object> fields

hasLazyField

private boolean hasLazyField

isMutable

private boolean isMutable

hasNestedBuilders

private boolean hasNestedBuilders

Constructor Detail

Builder

private Builder()

Builder

private Builder(SmallSortedMap<T,java.lang.Object> fields)

Method Detail

build

public FieldSet<T> build()

Creates the FieldSet

Throws:

UninitializedMessageException - if a message field is missing required fields.

buildPartial

public FieldSet<T> buildPartial()

Creates the FieldSet but does not validate that all required fields are present.

buildImpl

private FieldSet<T> buildImpl(boolean partial)

Creates the FieldSet.

Parameters:

partial - controls whether to do a build() or buildPartial() when converting submessage builders to messages.

replaceBuilders

private static <T extends FieldSet.FieldDescriptorLite<T>> void replaceBuilders(SmallSortedMap<T,java.lang.Object> fieldMap,
                                                                                boolean partial)

replaceBuilders

private static <T extends FieldSet.FieldDescriptorLite<T>> void replaceBuilders(java.util.Map.Entry<T,java.lang.Object> entry,
                                                                                boolean partial)

replaceBuilders

private static <T extends FieldSet.FieldDescriptorLite<T>> java.lang.Object replaceBuilders(T descriptor,
                                                                                            java.lang.Object value,
                                                                                            boolean partial)

replaceBuilder

private static java.lang.Object replaceBuilder(java.lang.Object value,
                                               boolean partial)

fromFieldSet

public static <T extends FieldSet.FieldDescriptorLite<T>> FieldSet.Builder<T> fromFieldSet(FieldSet<T> fieldSet)

Returns a new Builder using the fields from fieldSet.

getAllFields

public java.util.Map<T,java.lang.Object> getAllFields()

Get a simple map containing all the fields.

hasField

public boolean hasField(T descriptor)

Useful for implementing MessageOrBuilder.hasField(Descriptors.FieldDescriptor).

getField

public java.lang.Object getField(T descriptor)

Useful for implementing MessageOrBuilder.getField(Descriptors.FieldDescriptor). This method returns null if the field is not set; in this case it is up to the caller to fetch the field's default value.

getFieldAllowBuilders

java.lang.Object getFieldAllowBuilders(T descriptor)

Same as #getField(F), but allow a MessageLite.Builder to be returned.

ensureIsMutable

private void ensureIsMutable()

setField

public void setField(T descriptor,
                     java.lang.Object value)

Useful for implementing Message.Builder.setField(Descriptors.FieldDescriptor, Object).

clearField

public void clearField(T descriptor)

Useful for implementing Message.Builder.clearField(Descriptors.FieldDescriptor).

getRepeatedFieldCount

public int getRepeatedFieldCount(T descriptor)

Useful for implementing MessageOrBuilder.getRepeatedFieldCount(Descriptors.FieldDescriptor).

getRepeatedField

public java.lang.Object getRepeatedField(T descriptor,
                                         int index)

Useful for implementing MessageOrBuilder.getRepeatedField(Descriptors.FieldDescriptor, int).

getRepeatedFieldAllowBuilders

java.lang.Object getRepeatedFieldAllowBuilders(T descriptor,
                                               int index)

Same as #getRepeatedField(F, int), but allow a MessageLite.Builder to be returned.

setRepeatedField

public void setRepeatedField(T descriptor,
                             int index,
                             java.lang.Object value)

Useful for implementing Message.Builder.setRepeatedField(Descriptors.FieldDescriptor, int, Object).

addRepeatedField

public void addRepeatedField(T descriptor,
                             java.lang.Object value)

Useful for implementing Message.Builder.addRepeatedField(Descriptors.FieldDescriptor, Object).

verifyType

private void verifyType(T descriptor,
                        java.lang.Object value)

Verifies that the given object is of the correct type to be a valid value for the given field. (For repeated fields, this checks if the object is the right type to be one element of the field.)

Throws:

java.lang.IllegalArgumentException - The value is not of the right type.

isInitialized

public boolean isInitialized()

See MessageLiteOrBuilder.isInitialized(). Note: Since FieldSet itself does not have any way of knowing about required fields that aren't actually present in the set, it is up to the caller to check that all required fields are present.

mergeFrom

public void mergeFrom(FieldSet<T> other)

Like Message.Builder.mergeFrom(Message), but merges from another FieldSet.

mergeFromField

private void mergeFromField(java.util.Map.Entry<T,java.lang.Object> entry)