Package com.google.protobuf
Class UnknownFieldSet
- java.lang.Object
-
- com.google.protobuf.UnknownFieldSet
-
- All Implemented Interfaces:
MessageLite
,MessageLiteOrBuilder
public final class UnknownFieldSet extends Object implements MessageLite
UnknownFieldSet
keeps track of fields which were seen when parsing a protocol message but whose field numbers or types are unrecognized. This most frequently occurs when new fields are added to a message type and then messages containing those fields are read by old software that was compiled before the new types were added.Every
Message
contains anUnknownFieldSet
(and everyMessage.Builder
contains aUnknownFieldSet.Builder
).Most users will never need to use this class.
- Author:
- [email protected] Kenton Varda
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
UnknownFieldSet.Builder
Builder forUnknownFieldSet
s.static class
UnknownFieldSet.Field
Represents a single field in anUnknownFieldSet
.static class
UnknownFieldSet.Parser
Parser to implement MessageLite interface.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description Map<Integer,UnknownFieldSet.Field>
asMap()
Get a map of fields in the set by number.boolean
equals(Object other)
static UnknownFieldSet
getDefaultInstance()
Get an emptyUnknownFieldSet
.UnknownFieldSet
getDefaultInstanceForType()
Get an instance of the type with no fields set.UnknownFieldSet.Field
getField(int number)
Get a field by number.UnknownFieldSet.Parser
getParserForType()
Gets the parser for a message of the same type as this message.int
getSerializedSize()
Get the number of bytes required to encode this set.int
getSerializedSizeAsMessageSet()
Get the number of bytes required to encode this set usingMessageSet
wire format.boolean
hasField(int number)
Check if the given field number is present in the set.int
hashCode()
boolean
isInitialized()
Returns true if all required fields in the message and all embedded messages are set, false otherwise.static UnknownFieldSet.Builder
newBuilder()
Create a newUnknownFieldSet.Builder
.static UnknownFieldSet.Builder
newBuilder(UnknownFieldSet copyFrom)
Create a newUnknownFieldSet.Builder
and initialize it to be a copy ofcopyFrom
.UnknownFieldSet.Builder
newBuilderForType()
Constructs a new builder for a message of the same type as this message.static UnknownFieldSet
parseFrom(byte[] data)
Parsedata
as anUnknownFieldSet
and return it.static UnknownFieldSet
parseFrom(ByteString data)
Parsedata
as anUnknownFieldSet
and return it.static UnknownFieldSet
parseFrom(CodedInputStream input)
Parse anUnknownFieldSet
from the given input stream.static UnknownFieldSet
parseFrom(InputStream input)
Parse anUnknownFieldSet
frominput
and return it.UnknownFieldSet.Builder
toBuilder()
Constructs a builder initialized with the current message.byte[]
toByteArray()
Serializes the message to abyte
array and returns it.ByteString
toByteString()
Serializes the message to aByteString
and returns it.String
toString()
Converts the set to a string in protocol buffer text format.void
writeAsMessageSetTo(CodedOutputStream output)
Serializes the set and writes it tooutput
usingMessageSet
wire format.void
writeDelimitedTo(OutputStream output)
LikeMessageLite.writeTo(OutputStream)
, but writes the size of the message as a varint before writing the data.void
writeTo(CodedOutputStream output)
Serializes the set and writes it tooutput
.void
writeTo(OutputStream output)
Serializes the message and writes it tooutput
.
-
-
-
Method Detail
-
newBuilder
public static UnknownFieldSet.Builder newBuilder()
Create a newUnknownFieldSet.Builder
.
-
newBuilder
public static UnknownFieldSet.Builder newBuilder(UnknownFieldSet copyFrom)
Create a newUnknownFieldSet.Builder
and initialize it to be a copy ofcopyFrom
.
-
getDefaultInstance
public static UnknownFieldSet getDefaultInstance()
Get an emptyUnknownFieldSet
.
-
getDefaultInstanceForType
public UnknownFieldSet getDefaultInstanceForType()
Description copied from interface:MessageLiteOrBuilder
Get 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 theMessageLite
interface whereasgetDefaultInstance()
is a static method of a specific class. They return the same thing.- Specified by:
getDefaultInstanceForType
in interfaceMessageLiteOrBuilder
-
asMap
public Map<Integer,UnknownFieldSet.Field> asMap()
Get a map of fields in the set by number.
-
hasField
public boolean hasField(int number)
Check if the given field number is present in the set.
-
getField
public UnknownFieldSet.Field getField(int number)
Get a field by number. Returns an empty field if not present. Never returnsnull
.
-
writeTo
public void writeTo(CodedOutputStream output) throws IOException
Serializes the set and writes it tooutput
.- Specified by:
writeTo
in interfaceMessageLite
- Throws:
IOException
-
toString
public String toString()
Converts the set to a string in protocol buffer text format. This is just a trivial wrapper aroundTextFormat.Printer.printToString(UnknownFieldSet)
.
-
toByteString
public ByteString toByteString()
Serializes the message to aByteString
and returns it. This is just a trivial wrapper aroundwriteTo(CodedOutputStream)
.- Specified by:
toByteString
in interfaceMessageLite
-
toByteArray
public byte[] toByteArray()
Serializes the message to abyte
array and returns it. This is just a trivial wrapper aroundwriteTo(CodedOutputStream)
.- Specified by:
toByteArray
in interfaceMessageLite
-
writeTo
public void writeTo(OutputStream output) throws IOException
Serializes the message and writes it tooutput
. This is just a trivial wrapper aroundwriteTo(CodedOutputStream)
.- Specified by:
writeTo
in interfaceMessageLite
- Throws:
IOException
-
writeDelimitedTo
public void writeDelimitedTo(OutputStream output) throws IOException
Description copied from interface:MessageLite
LikeMessageLite.writeTo(OutputStream)
, but writes the size of the message as a varint before writing the data. This allows more data to be written to the stream after the message without the need to delimit the message data yourself. UseMessageLite.Builder.mergeDelimitedFrom(InputStream)
(or the static methodYourMessageType.parseDelimitedFrom(InputStream)
) to parse messages written by this method.- Specified by:
writeDelimitedTo
in interfaceMessageLite
- Throws:
IOException
-
getSerializedSize
public int getSerializedSize()
Get the number of bytes required to encode this set.- Specified by:
getSerializedSize
in interfaceMessageLite
-
writeAsMessageSetTo
public void writeAsMessageSetTo(CodedOutputStream output) throws IOException
Serializes the set and writes it tooutput
usingMessageSet
wire format.- Throws:
IOException
-
getSerializedSizeAsMessageSet
public int getSerializedSizeAsMessageSet()
Get the number of bytes required to encode this set usingMessageSet
wire format.
-
isInitialized
public boolean isInitialized()
Description copied from interface:MessageLiteOrBuilder
Returns true if all required fields in the message and all embedded messages are set, false otherwise.- Specified by:
isInitialized
in interfaceMessageLiteOrBuilder
-
parseFrom
public static UnknownFieldSet parseFrom(CodedInputStream input) throws IOException
Parse anUnknownFieldSet
from the given input stream.- Throws:
IOException
-
parseFrom
public static UnknownFieldSet parseFrom(ByteString data) throws InvalidProtocolBufferException
Parsedata
as anUnknownFieldSet
and return it.- Throws:
InvalidProtocolBufferException
-
parseFrom
public static UnknownFieldSet parseFrom(byte[] data) throws InvalidProtocolBufferException
Parsedata
as anUnknownFieldSet
and return it.- Throws:
InvalidProtocolBufferException
-
parseFrom
public static UnknownFieldSet parseFrom(InputStream input) throws IOException
Parse anUnknownFieldSet
frominput
and return it.- Throws:
IOException
-
newBuilderForType
public UnknownFieldSet.Builder newBuilderForType()
Description copied from interface:MessageLite
Constructs a new builder for a message of the same type as this message.- Specified by:
newBuilderForType
in interfaceMessageLite
-
toBuilder
public UnknownFieldSet.Builder toBuilder()
Description copied from interface:MessageLite
Constructs a builder initialized with the current message. Use this to derive a new message from the current one.- Specified by:
toBuilder
in interfaceMessageLite
-
getParserForType
public final UnknownFieldSet.Parser getParserForType()
Description copied from interface:MessageLite
Gets the parser for a message of the same type as this message.- Specified by:
getParserForType
in interfaceMessageLite
-
-