Package com.google.protobuf
Class UnknownFieldSet.Builder
java.lang.Object
com.google.protobuf.UnknownFieldSet.Builder
- All Implemented Interfaces:
MessageLite.Builder,MessageLiteOrBuilder,Cloneable
- Enclosing class:
- UnknownFieldSet
Builder for
UnknownFieldSets.
Note that this class maintains UnknownFieldSet.Field.Builders for all fields
in the set. Thus, adding one element to an existing UnknownFieldSet.Field does not
require making a copy. This is important for efficient parsing of
unknown repeated fields. However, it implies that UnknownFieldSet.Fields cannot
be constructed independently, nor can two UnknownFieldSets share
the same Field object.
Use UnknownFieldSet.newBuilder() to construct a Builder.
-
Method Summary
Modifier and TypeMethodDescriptionaddField(int number, UnknownFieldSet.Field field) Add a field to theUnknownFieldSet.asMap()Get all presentFields as an immutableMap.build()Build theUnknownFieldSetand return it.LikeMessageLite.Builder.build(), but does not throw an exception if the message is missing required fields.clear()Reset the builder to an empty set.clearField(int number) Clear fields from the set with a given field number.clone()Clones the Builder.Get an instance of the type with no fields set.booleanhasField(int number) Check if the given field number is present in the set.booleanReturns true if all required fields in the message and all embedded messages are set, false otherwise.booleanmergeDelimitedFrom(InputStream input) LikeMessageLite.Builder.mergeFrom(InputStream), but does not read until EOF.booleanmergeDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry) LikeMessageLite.Builder.mergeDelimitedFrom(InputStream)but supporting extensions.mergeField(int number, UnknownFieldSet.Field field) Add a field to theUnknownFieldSet.booleanmergeFieldFrom(int tag, CodedInputStream input) Parse a single field frominputand merge it into this set.mergeFrom(byte[] data) Parsedataas anUnknownFieldSetand merge it with the set being built.mergeFrom(byte[] data, int off, int len) Parsedataas a message of this type and merge it with the message being built.mergeFrom(byte[] data, int off, int len, ExtensionRegistryLite extensionRegistry) Parsedataas a message of this type and merge it with the message being built.mergeFrom(byte[] data, ExtensionRegistryLite extensionRegistry) Parsedataas a message of this type and merge it with the message being built.mergeFrom(ByteString data) Parsedataas anUnknownFieldSetand merge it with the set being built.mergeFrom(ByteString data, ExtensionRegistryLite extensionRegistry) Parsedataas a message of this type and merge it with the message being built.mergeFrom(CodedInputStream input) Parse an entire message frominputand merge its fields into this set.mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry) LikeMessageLite.Builder.mergeFrom(CodedInputStream), but also parses extensions.mergeFrom(UnknownFieldSet other) Merge the fields fromotherinto this set.mergeFrom(InputStream input) Parse anUnknownFieldSetfrominputand merge it with the set being built.mergeFrom(InputStream input, ExtensionRegistryLite extensionRegistry) Parse a message of this type frominputand merge it with the message being built.mergeVarintField(int number, int value) Convenience method for merging a new field containing a single varint value.
-
Method Details
-
build
Build theUnknownFieldSetand return it.Once
build()has been called, theBuilderwill no longer be usable. Calling any method afterbuild()will result in undefined behavior and can cause aNullPointerExceptionto be thrown.- Specified by:
buildin interfaceMessageLite.Builder
-
buildPartial
Description copied from interface:MessageLite.BuilderLikeMessageLite.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.- Specified by:
buildPartialin interfaceMessageLite.Builder
-
clone
Description copied from interface:MessageLite.BuilderClones the Builder.- Specified by:
clonein interfaceMessageLite.Builder- Overrides:
clonein classObject- See Also:
-
getDefaultInstanceForType
Description copied from interface:MessageLiteOrBuilderGet an instance of the type with no fields set. Because no fields are set, all getters for singular fields will return default values and repeated fields will appear empty. This may or may not be a singleton. This differs from thegetDefaultInstance()method of generated message classes in that this method is an abstract method of theMessageLiteinterface whereasgetDefaultInstance()is a static method of a specific class. They return the same thing.- Specified by:
getDefaultInstanceForTypein interfaceMessageLiteOrBuilder
-
clear
Reset the builder to an empty set.- Specified by:
clearin interfaceMessageLite.Builder
-
clearField
Clear fields from the set with a given field number. -
mergeFrom
Merge the fields fromotherinto this set. If a field number exists in both sets,other's values for that field will be appended to the values in this set. -
mergeField
Add a field to theUnknownFieldSet. If a field with the same number already exists, the two are merged. -
mergeVarintField
Convenience method for merging a new field containing a single varint value. This is used in particular when an unknown enum value is encountered. -
hasField
public boolean hasField(int number) Check if the given field number is present in the set. -
addField
Add a field to theUnknownFieldSet. If a field with the same number already exists, it is removed. -
asMap
Get all presentFields as an immutableMap. If more fields are added, the changes may or may not be reflected in this map. -
mergeFrom
Parse an entire message frominputand merge its fields into this set.- Specified by:
mergeFromin interfaceMessageLite.Builder- Throws:
IOException
-
mergeFieldFrom
Parse a single field frominputand merge it into this set.- Parameters:
tag- The field's tag number, which was already parsed.- Returns:
falseif the tag is an end group tag.- Throws:
IOException
-
mergeFrom
Parsedataas anUnknownFieldSetand merge it with the set being built. This is just a small wrapper aroundmergeFrom(CodedInputStream).- Specified by:
mergeFromin interfaceMessageLite.Builder- Returns:
- this
- Throws:
InvalidProtocolBufferException
-
mergeFrom
Parsedataas anUnknownFieldSetand merge it with the set being built. This is just a small wrapper aroundmergeFrom(CodedInputStream).- Specified by:
mergeFromin interfaceMessageLite.Builder- Returns:
- this
- Throws:
InvalidProtocolBufferException
-
mergeFrom
Parse anUnknownFieldSetfrominputand merge it with the set being built. This is just a small wrapper aroundmergeFrom(CodedInputStream).- Specified by:
mergeFromin interfaceMessageLite.Builder- Returns:
- this
- Throws:
IOException
-
mergeDelimitedFrom
Description copied from interface:MessageLite.BuilderLikeMessageLite.Builder.mergeFrom(InputStream), but does not read until EOF. Instead, the size of the message (encoded as a varint) is read first, then the message data. UseMessageLite.writeDelimitedTo(OutputStream)to write messages in this format.- Specified by:
mergeDelimitedFromin interfaceMessageLite.Builder- Returns:
- True if successful, or false if the stream is at EOF when the method starts. Any other error (including reaching EOF during parsing) will cause an exception to be thrown.
- Throws:
IOException
-
mergeDelimitedFrom
public boolean mergeDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry) throws IOException Description copied from interface:MessageLite.BuilderLikeMessageLite.Builder.mergeDelimitedFrom(InputStream)but supporting extensions.- Specified by:
mergeDelimitedFromin interfaceMessageLite.Builder- Throws:
IOException
-
mergeFrom
public UnknownFieldSet.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry) throws IOException Description copied from interface:MessageLite.BuilderLikeMessageLite.Builder.mergeFrom(CodedInputStream), but also parses extensions. The extensions that you want to be able to parse must be registered inextensionRegistry. Extensions not in the registry will be treated as unknown fields.- Specified by:
mergeFromin interfaceMessageLite.Builder- Throws:
IOException
-
mergeFrom
public UnknownFieldSet.Builder mergeFrom(ByteString data, ExtensionRegistryLite extensionRegistry) throws InvalidProtocolBufferException Description copied from interface:MessageLite.BuilderParsedataas a message of this type and merge it with the message being built. This is just a small wrapper aroundMessageLite.Builder.mergeFrom(CodedInputStream,ExtensionRegistryLite).- Specified by:
mergeFromin interfaceMessageLite.Builder- Returns:
- this
- Throws:
InvalidProtocolBufferException
-
mergeFrom
public UnknownFieldSet.Builder mergeFrom(byte[] data, int off, int len) throws InvalidProtocolBufferException Description copied from interface:MessageLite.BuilderParsedataas a message of this type and merge it with the message being built. This is just a small wrapper aroundMessageLite.Builder.mergeFrom(CodedInputStream).- Specified by:
mergeFromin interfaceMessageLite.Builder- Returns:
- this
- Throws:
InvalidProtocolBufferException
-
mergeFrom
public UnknownFieldSet.Builder mergeFrom(byte[] data, ExtensionRegistryLite extensionRegistry) throws InvalidProtocolBufferException Description copied from interface:MessageLite.BuilderParsedataas a message of this type and merge it with the message being built. This is just a small wrapper aroundMessageLite.Builder.mergeFrom(CodedInputStream,ExtensionRegistryLite).- Specified by:
mergeFromin interfaceMessageLite.Builder- Returns:
- this
- Throws:
InvalidProtocolBufferException
-
mergeFrom
public UnknownFieldSet.Builder mergeFrom(byte[] data, int off, int len, ExtensionRegistryLite extensionRegistry) throws InvalidProtocolBufferException Description copied from interface:MessageLite.BuilderParsedataas a message of this type and merge it with the message being built. This is just a small wrapper aroundMessageLite.Builder.mergeFrom(CodedInputStream,ExtensionRegistryLite).- Specified by:
mergeFromin interfaceMessageLite.Builder- Returns:
- this
- Throws:
InvalidProtocolBufferException
-
mergeFrom
public UnknownFieldSet.Builder mergeFrom(InputStream input, ExtensionRegistryLite extensionRegistry) throws IOException Description copied from interface:MessageLite.BuilderParse a message of this type frominputand merge it with the message being built. This is just a small wrapper aroundMessageLite.Builder.mergeFrom(CodedInputStream,ExtensionRegistryLite).- Specified by:
mergeFromin interfaceMessageLite.Builder- Returns:
- this
- Throws:
IOException
-
isInitialized
public boolean isInitialized()Description copied from interface:MessageLiteOrBuilderReturns true if all required fields in the message and all embedded messages are set, false otherwise.- Specified by:
isInitializedin interfaceMessageLiteOrBuilder
-