com.google.protobuf
Class DynamicMessage.Builder

java.lang.Object
  com.google.protobuf.AbstractMessage.Builder<DynamicMessage.Builder>
      com.google.protobuf.DynamicMessage.Builder

All Implemented Interfaces:

Message.Builder, java.lang.Cloneable

Enclosing class:

DynamicMessage

public static final class DynamicMessage.Builder
extends AbstractMessage.Builder<DynamicMessage.Builder>

Builder for DynamicMessages.

Method Summary

DynamicMessage.Builder	addRepeatedField(Descriptors.FieldDescriptor field, java.lang.Object value) Like setRepeatedField, but appends the value as a new element.
DynamicMessage	build() Construct the final message.
DynamicMessage	buildPartial() Like Message.Builder.build(), but does not throw an exception if the message is missing required fields.
DynamicMessage.Builder	clear() Resets all fields to their default values.
DynamicMessage.Builder	clearField(Descriptors.FieldDescriptor field) Clears the field.
DynamicMessage.Builder	clone() Clones the Builder.
java.util.Map<Descriptors.FieldDescriptor,java.lang.Object>	getAllFields() Like Message.getAllFields().
DynamicMessage	getDefaultInstanceForType() Get the message's type's default instance.
Descriptors.Descriptor	getDescriptorForType() Get the message's type's descriptor.
java.lang.Object	getField(Descriptors.FieldDescriptor field) Like Message.getField(Descriptors.FieldDescriptor)
java.lang.Object	getRepeatedField(Descriptors.FieldDescriptor field, int index) Like Message.getRepeatedField(Descriptors.FieldDescriptor,int)
int	getRepeatedFieldCount(Descriptors.FieldDescriptor field) Like Message.getRepeatedFieldCount(Descriptors.FieldDescriptor)
UnknownFieldSet	getUnknownFields() Get the UnknownFieldSet for this message.
boolean	hasField(Descriptors.FieldDescriptor field) Like Message.hasField(Descriptors.FieldDescriptor)
boolean	isInitialized() Returns true if all required fields in the message and all embedded messages are set, false otherwise.
DynamicMessage.Builder	mergeFrom(CodedInputStream input, ExtensionRegistry extensionRegistry) Like Message.Builder.mergeFrom(CodedInputStream), but also parses extensions.
DynamicMessage.Builder	mergeFrom(Message other) Merge other into the message being built.
DynamicMessage.Builder	mergeUnknownFields(UnknownFieldSet unknownFields) Merge some unknown fields into the UnknownFieldSet for this message.
DynamicMessage.Builder	newBuilderForField(Descriptors.FieldDescriptor field) Create a Builder for messages of the appropriate type for the given field.
DynamicMessage.Builder	setField(Descriptors.FieldDescriptor field, java.lang.Object value) Sets a field to the given value.
DynamicMessage.Builder	setRepeatedField(Descriptors.FieldDescriptor field, int index, java.lang.Object value) Sets an element of a repeated field to the given value.
DynamicMessage.Builder	setUnknownFields(UnknownFieldSet unknownFields) Set the UnknownFieldSet for this message.

Methods inherited from class com.google.protobuf.AbstractMessage.Builder

mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom, mergeFrom

Methods inherited from class java.lang.Object

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

Method Detail

clear

public DynamicMessage.Builder clear()

Description copied from interface: Message.Builder

Resets all fields to their default values.

Specified by:

clear in interface Message.Builder

Overrides:

clear in class AbstractMessage.Builder<DynamicMessage.Builder>

mergeFrom

public DynamicMessage.Builder mergeFrom(Message other)

Description copied from interface: Message.Builder

Merge other into the message being built. other must have the exact same type as this (i.e. getDescriptorForType() == other.getDescriptorForType()). Merging occurs as follows. For each field:
* For singular primitive fields, if the field is set in other, then other's value overwrites the value in this message.
* For singular message fields, if the field is set in other, it is merged into the corresponding sub-message of this message using the same merging rules.
* For repeated fields, the elements in other are concatenated with the elements in this message. This is equivalent to the Message::MergeFrom method in C++.

Specified by:

mergeFrom in interface Message.Builder

Overrides:

mergeFrom in class AbstractMessage.Builder<DynamicMessage.Builder>

build

public DynamicMessage build()

Description copied from interface: Message.Builder

Construct the final message. Once this is called, the Builder is no longer valid, and calling any other method may throw a NullPointerException. If you need to continue working with the builder after calling build(), clone() it first.

buildPartial

public DynamicMessage buildPartial()

Description copied from interface: Message.Builder

Like Message.Builder.build(), but does not throw an exception if the message is missing required fields. Instead, a partial message is returned.

clone

public DynamicMessage.Builder clone()

Description copied from interface: Message.Builder

Clones the Builder.

Specified by:

clone in interface Message.Builder

Specified by:

clone in class AbstractMessage.Builder<DynamicMessage.Builder>

See Also:

Object.clone()

isInitialized

public boolean isInitialized()

Description copied from interface: Message.Builder

Returns true if all required fields in the message and all embedded messages are set, false otherwise.

mergeFrom

public DynamicMessage.Builder mergeFrom(CodedInputStream input,
                                        ExtensionRegistry extensionRegistry)
                                 throws java.io.IOException

Description copied from interface: Message.Builder

Like Message.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.

Specified by:

mergeFrom in interface Message.Builder

Overrides:

mergeFrom in class AbstractMessage.Builder<DynamicMessage.Builder>

Throws:

java.io.IOException

getDescriptorForType

public Descriptors.Descriptor getDescriptorForType()

Description copied from interface: Message.Builder

Get the message's type's descriptor. See Message.getDescriptorForType().

getDefaultInstanceForType

public DynamicMessage getDefaultInstanceForType()

Description copied from interface: Message.Builder

Get the message's type's default instance. See Message.getDefaultInstanceForType().

getAllFields

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

Description copied from interface: Message.Builder

Like Message.getAllFields(). The returned map may or may not reflect future changes to the builder. Either way, the returned map is itself unmodifiable.

newBuilderForField

public DynamicMessage.Builder newBuilderForField(Descriptors.FieldDescriptor field)

Description copied from interface: Message.Builder

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().

hasField

public boolean hasField(Descriptors.FieldDescriptor field)

Description copied from interface: Message.Builder

Like Message.hasField(Descriptors.FieldDescriptor)

getField

public java.lang.Object getField(Descriptors.FieldDescriptor field)

Description copied from interface: Message.Builder

Like Message.getField(Descriptors.FieldDescriptor)

setField

public DynamicMessage.Builder setField(Descriptors.FieldDescriptor field,
                                       java.lang.Object value)

Description copied from interface: Message.Builder

Sets a field to the given value. The value must be of the correct type for this field, i.e. the same type that Message.getField(Descriptors.FieldDescriptor) would return.

clearField

public DynamicMessage.Builder clearField(Descriptors.FieldDescriptor field)

Description copied from interface: Message.Builder

Clears the field. This is exactly equivalent to calling the generated "clear" accessor method corresponding to the field.

getRepeatedFieldCount

public int getRepeatedFieldCount(Descriptors.FieldDescriptor field)

Description copied from interface: Message.Builder

Like Message.getRepeatedFieldCount(Descriptors.FieldDescriptor)

getRepeatedField

public java.lang.Object getRepeatedField(Descriptors.FieldDescriptor field,
                                         int index)

Description copied from interface: Message.Builder

Like Message.getRepeatedField(Descriptors.FieldDescriptor,int)

setRepeatedField

public DynamicMessage.Builder setRepeatedField(Descriptors.FieldDescriptor field,
                                               int index,
                                               java.lang.Object value)

Description copied from interface: Message.Builder

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 Message.getRepeatedField(Descriptors.FieldDescriptor,int) would return.

addRepeatedField

public DynamicMessage.Builder addRepeatedField(Descriptors.FieldDescriptor field,
                                               java.lang.Object value)

Description copied from interface: Message.Builder

Like setRepeatedField, but appends the value as a new element.

getUnknownFields

public UnknownFieldSet getUnknownFields()

Description copied from interface: Message.Builder

Get the UnknownFieldSet for this message.

setUnknownFields

public DynamicMessage.Builder setUnknownFields(UnknownFieldSet unknownFields)

Description copied from interface: Message.Builder

Set the UnknownFieldSet for this message.

mergeUnknownFields

public DynamicMessage.Builder mergeUnknownFields(UnknownFieldSet unknownFields)

Description copied from interface: Message.Builder

Merge some unknown fields into the UnknownFieldSet for this message.

Specified by:

mergeUnknownFields in interface Message.Builder

Overrides:

mergeUnknownFields in class AbstractMessage.Builder<DynamicMessage.Builder>