Package com.google.protobuf
Class Struct
- java.lang.Object
-
- com.google.protobuf.AbstractMessageLite
-
- com.google.protobuf.AbstractMessage
-
- com.google.protobuf.GeneratedMessage
-
- com.google.protobuf.Struct
-
- All Implemented Interfaces:
Message,MessageLite,MessageLiteOrBuilder,MessageOrBuilder,StructOrBuilder,java.io.Serializable
public final class Struct extends GeneratedMessage implements StructOrBuilder
`Struct` represents a structured data value, consisting of fields which map to dynamically typed values. In some languages, `Struct` might be supported by a native representation. For example, in scripting languages like JS a struct is represented as an object. The details of that representation are described together with the proto support for the language. The JSON representation for `Struct` is JSON object.
Protobuf typegoogle.protobuf.Struct- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classStruct.Builder`Struct` represents a structured data value, consisting of fields which map to dynamically typed values.private static classStruct.FieldsDefaultEntryHolder-
Nested classes/interfaces inherited from class com.google.protobuf.GeneratedMessage
GeneratedMessage.ExtendableBuilder<MessageT extends GeneratedMessage.ExtendableMessage<MessageT>,BuilderT extends GeneratedMessage.ExtendableBuilder<MessageT,BuilderT>>, GeneratedMessage.ExtendableMessage<MessageT extends GeneratedMessage.ExtendableMessage<MessageT>>, GeneratedMessage.ExtendableMessageOrBuilder<MessageT extends GeneratedMessage.ExtendableMessage<MessageT>>, GeneratedMessage.ExtensionDescriptorRetriever, GeneratedMessage.FieldAccessorTable, GeneratedMessage.GeneratedExtension<ContainingT extends Message,T>, GeneratedMessage.UnusedPrivateParameter
-
Nested classes/interfaces inherited from class com.google.protobuf.AbstractMessage
AbstractMessage.BuilderParent
-
Nested classes/interfaces inherited from class com.google.protobuf.AbstractMessageLite
AbstractMessageLite.InternalOneOfEnum
-
-
Field Summary
Fields Modifier and Type Field Description private static StructDEFAULT_INSTANCEprivate MapField<java.lang.String,Value>fields_static intFIELDS_FIELD_NUMBERprivate bytememoizedIsInitializedprivate static Parser<Struct>PARSERprivate static longserialVersionUID-
Fields inherited from class com.google.protobuf.GeneratedMessage
alwaysUseFieldBuilders, unknownFields
-
Fields inherited from class com.google.protobuf.AbstractMessage
memoizedSize
-
Fields inherited from class com.google.protobuf.AbstractMessageLite
memoizedHashCode
-
-
Constructor Summary
Constructors Modifier Constructor Description privateStruct()privateStruct(GeneratedMessage.Builder<?> builder)
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description booleancontainsFields(java.lang.String key)Unordered map of dynamically typed values.booleanequals(java.lang.Object obj)Compares the specified object with this message for equality.static StructgetDefaultInstance()StructgetDefaultInstanceForType()Get an instance of the type with no fields set.static Descriptors.DescriptorgetDescriptor()java.util.Map<java.lang.String,Value>getFields()Deprecated.intgetFieldsCount()Unordered map of dynamically typed values.java.util.Map<java.lang.String,Value>getFieldsMap()Unordered map of dynamically typed values.ValuegetFieldsOrDefault(java.lang.String key, Value defaultValue)Unordered map of dynamically typed values.ValuegetFieldsOrThrow(java.lang.String key)Unordered map of dynamically typed values.Parser<Struct>getParserForType()TODO: Remove this unnecessary intermediate implementation of this method.intgetSerializedSize()Get the number of bytes required to encode this message.inthashCode()Returns the hash code value for this message.protected GeneratedMessage.FieldAccessorTableinternalGetFieldAccessorTable()Get the FieldAccessorTable for this type.private MapField<java.lang.String,Value>internalGetFields()protected MapFieldReflectionAccessorinternalGetMapFieldReflection(int number)Gets the map field with the given field number.booleanisInitialized()Returns true if all required fields in the message and all embedded messages are set, false otherwise.static Struct.BuildernewBuilder()static Struct.BuildernewBuilder(Struct prototype)Struct.BuildernewBuilderForType()Constructs a new builder for a message of the same type as this message.protected Struct.BuildernewBuilderForType(AbstractMessage.BuilderParent parent)Create a nested builder.static StructparseDelimitedFrom(java.io.InputStream input)static StructparseDelimitedFrom(java.io.InputStream input, ExtensionRegistryLite extensionRegistry)static StructparseFrom(byte[] data)static StructparseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)static StructparseFrom(ByteString data)static StructparseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)static StructparseFrom(CodedInputStream input)static StructparseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)static StructparseFrom(java.io.InputStream input)static StructparseFrom(java.io.InputStream input, ExtensionRegistryLite extensionRegistry)static StructparseFrom(java.nio.ByteBuffer data)static StructparseFrom(java.nio.ByteBuffer data, ExtensionRegistryLite extensionRegistry)static Parser<Struct>parser()Struct.BuildertoBuilder()Constructs a builder initialized with the current message.voidwriteTo(CodedOutputStream output)Serializes the message and writes it tooutput.-
Methods inherited from class com.google.protobuf.GeneratedMessage
canUseUnsafe, computeStringSize, computeStringSizeNoTag, emptyBooleanList, emptyDoubleList, emptyFloatList, emptyIntList, emptyList, emptyLongList, enableAlwaysUseFieldBuildersForTesting, getAllFields, getAllFieldsRaw, getDescriptorForType, getField, getFieldRaw, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof, internalGetMapField, isStringEmpty, makeMutableCopy, makeMutableCopy, mergeFromAndMakeImmutableInternal, newFileScopedGeneratedExtension, newInstance, newMessageScopedGeneratedExtension, parseDelimitedWithIOException, parseDelimitedWithIOException, parseUnknownField, parseUnknownFieldProto3, parseWithIOException, parseWithIOException, parseWithIOException, parseWithIOException, serializeBooleanMapTo, serializeIntegerMapTo, serializeLongMapTo, serializeStringMapTo, setAlwaysUseFieldBuildersForTesting, setUnknownFields, writeReplace, writeString, writeStringNoTag
-
Methods inherited from class com.google.protobuf.AbstractMessage
compareFields, findInitializationErrors, getInitializationErrorString, getMemoizedSerializedSize, hashFields, newUninitializedMessageException, setMemoizedSerializedSize, toString
-
Methods inherited from class com.google.protobuf.AbstractMessageLite
addAll, checkByteStringIsUtf8, getSerializedSize, toByteArray, toByteString, writeDelimitedTo, writeTo
-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface com.google.protobuf.MessageLite
toByteArray, toByteString, writeDelimitedTo, writeTo
-
Methods inherited from interface com.google.protobuf.MessageOrBuilder
findInitializationErrors, getAllFields, getDescriptorForType, getField, getInitializationErrorString, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, getUnknownFields, hasField, hasOneof
-
-
-
-
Field Detail
-
serialVersionUID
private static final long serialVersionUID
- See Also:
- Constant Field Values
-
FIELDS_FIELD_NUMBER
public static final int FIELDS_FIELD_NUMBER
- See Also:
- Constant Field Values
-
memoizedIsInitialized
private byte memoizedIsInitialized
-
DEFAULT_INSTANCE
private static final Struct DEFAULT_INSTANCE
-
-
Constructor Detail
-
Struct
private Struct(GeneratedMessage.Builder<?> builder)
-
Struct
private Struct()
-
-
Method Detail
-
getDescriptor
public static final Descriptors.Descriptor getDescriptor()
-
internalGetMapFieldReflection
protected MapFieldReflectionAccessor internalGetMapFieldReflection(int number)
Description copied from class:GeneratedMessageGets the map field with the given field number. This method should be overridden in the generated message class if the message contains map fields.Unlike other field types, reflection support for map fields can't be implemented based on generated public API because we need to access a map field as a list in reflection API but the generated API only allows us to access it as a map. This method returns the underlying map field directly and thus enables us to access the map field as a list.
- Overrides:
internalGetMapFieldReflectionin classGeneratedMessage
-
internalGetFieldAccessorTable
protected GeneratedMessage.FieldAccessorTable internalGetFieldAccessorTable()
Description copied from class:GeneratedMessageGet the FieldAccessorTable for this type. We can't have the message class pass this in to the constructor because of bootstrapping trouble with DescriptorProtos.- Specified by:
internalGetFieldAccessorTablein classGeneratedMessage
-
getFieldsCount
public int getFieldsCount()
Description copied from interface:StructOrBuilderUnordered map of dynamically typed values.
map<string, .google.protobuf.Value> fields = 1;- Specified by:
getFieldsCountin interfaceStructOrBuilder
-
containsFields
public boolean containsFields(java.lang.String key)
Unordered map of dynamically typed values.
map<string, .google.protobuf.Value> fields = 1;- Specified by:
containsFieldsin interfaceStructOrBuilder
-
getFields
@Deprecated public java.util.Map<java.lang.String,Value> getFields()
Deprecated.UsegetFieldsMap()instead.- Specified by:
getFieldsin interfaceStructOrBuilder
-
getFieldsMap
public java.util.Map<java.lang.String,Value> getFieldsMap()
Unordered map of dynamically typed values.
map<string, .google.protobuf.Value> fields = 1;- Specified by:
getFieldsMapin interfaceStructOrBuilder
-
getFieldsOrDefault
public Value getFieldsOrDefault(java.lang.String key, Value defaultValue)
Unordered map of dynamically typed values.
map<string, .google.protobuf.Value> fields = 1;- Specified by:
getFieldsOrDefaultin interfaceStructOrBuilder
-
getFieldsOrThrow
public Value getFieldsOrThrow(java.lang.String key)
Unordered map of dynamically typed values.
map<string, .google.protobuf.Value> fields = 1;- Specified by:
getFieldsOrThrowin interfaceStructOrBuilder
-
isInitialized
public final 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- Overrides:
isInitializedin classGeneratedMessage
-
writeTo
public void writeTo(CodedOutputStream output) throws java.io.IOException
Description copied from interface:MessageLiteSerializes the message and writes it tooutput. This does not flush or close the stream.- Specified by:
writeToin interfaceMessageLite- Overrides:
writeToin classGeneratedMessage- Throws:
java.io.IOException
-
getSerializedSize
public int getSerializedSize()
Description copied from interface:MessageLiteGet the number of bytes required to encode this message. The result is only computed on the first call and memoized after that. If this message requires more than Integer.MAX_VALUE bytes to encode, the return value will be smaller than the actual number of bytes required and might be negative.- Specified by:
getSerializedSizein interfaceMessageLite- Overrides:
getSerializedSizein classGeneratedMessage
-
equals
public boolean equals(java.lang.Object obj)
Description copied from interface:MessageCompares the specified object with this message for equality. Returnstrueif the given object is a message of the same type (as defined bygetDescriptorForType()) and has identical values for all of its fields. Subclasses must implement this; inheritingObject.equals()is incorrect.- Specified by:
equalsin interfaceMessage- Overrides:
equalsin classAbstractMessage- Parameters:
obj- object to be compared for equality with this message- Returns:
trueif the specified object is equal to this message
-
hashCode
public int hashCode()
Description copied from interface:MessageReturns the hash code value for this message. The hash code of a message should mix the message's type (object identity of the descriptor) with its contents (known and unknown field values). Subclasses must implement this; inheritingObject.hashCode()is incorrect.- Specified by:
hashCodein interfaceMessage- Overrides:
hashCodein classAbstractMessage- Returns:
- the hash code value for this message
- See Also:
Map.hashCode()
-
parseFrom
public static Struct parseFrom(java.nio.ByteBuffer data) throws InvalidProtocolBufferException
- Throws:
InvalidProtocolBufferException
-
parseFrom
public static Struct parseFrom(java.nio.ByteBuffer data, ExtensionRegistryLite extensionRegistry) throws InvalidProtocolBufferException
- Throws:
InvalidProtocolBufferException
-
parseFrom
public static Struct parseFrom(ByteString data) throws InvalidProtocolBufferException
- Throws:
InvalidProtocolBufferException
-
parseFrom
public static Struct parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry) throws InvalidProtocolBufferException
- Throws:
InvalidProtocolBufferException
-
parseFrom
public static Struct parseFrom(byte[] data) throws InvalidProtocolBufferException
- Throws:
InvalidProtocolBufferException
-
parseFrom
public static Struct parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry) throws InvalidProtocolBufferException
- Throws:
InvalidProtocolBufferException
-
parseFrom
public static Struct parseFrom(java.io.InputStream input) throws java.io.IOException
- Throws:
java.io.IOException
-
parseFrom
public static Struct parseFrom(java.io.InputStream input, ExtensionRegistryLite extensionRegistry) throws java.io.IOException
- Throws:
java.io.IOException
-
parseDelimitedFrom
public static Struct parseDelimitedFrom(java.io.InputStream input) throws java.io.IOException
- Throws:
java.io.IOException
-
parseDelimitedFrom
public static Struct parseDelimitedFrom(java.io.InputStream input, ExtensionRegistryLite extensionRegistry) throws java.io.IOException
- Throws:
java.io.IOException
-
parseFrom
public static Struct parseFrom(CodedInputStream input) throws java.io.IOException
- Throws:
java.io.IOException
-
parseFrom
public static Struct parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry) throws java.io.IOException
- Throws:
java.io.IOException
-
newBuilderForType
public Struct.Builder newBuilderForType()
Description copied from interface:MessageLiteConstructs a new builder for a message of the same type as this message.- Specified by:
newBuilderForTypein interfaceMessage- Specified by:
newBuilderForTypein interfaceMessageLite
-
newBuilder
public static Struct.Builder newBuilder()
-
newBuilder
public static Struct.Builder newBuilder(Struct prototype)
-
toBuilder
public Struct.Builder toBuilder()
Description copied from interface:MessageLiteConstructs a builder initialized with the current message. Use this to derive a new message from the current one.- Specified by:
toBuilderin interfaceMessage- Specified by:
toBuilderin interfaceMessageLite
-
newBuilderForType
protected Struct.Builder newBuilderForType(AbstractMessage.BuilderParent parent)
Description copied from class:AbstractMessageCreate a nested builder.- Overrides:
newBuilderForTypein classAbstractMessage
-
getDefaultInstance
public static Struct getDefaultInstance()
-
getParserForType
public Parser<Struct> getParserForType()
Description copied from class:GeneratedMessageTODO: Remove this unnecessary intermediate implementation of this method.- Specified by:
getParserForTypein interfaceMessage- Specified by:
getParserForTypein interfaceMessageLite- Overrides:
getParserForTypein classGeneratedMessage
-
getDefaultInstanceForType
public Struct 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- Specified by:
getDefaultInstanceForTypein interfaceMessageOrBuilder
-
-