Package com.google.protobuf
Class Descriptors.FieldDescriptor
- java.lang.Object
-
- com.google.protobuf.Descriptors.GenericDescriptor
-
- com.google.protobuf.Descriptors.FieldDescriptor
-
- All Implemented Interfaces:
com.google.protobuf.FieldSet.FieldDescriptorLite<Descriptors.FieldDescriptor>,java.lang.Comparable<Descriptors.FieldDescriptor>
- Enclosing class:
- Descriptors
public static final class Descriptors.FieldDescriptor extends Descriptors.GenericDescriptor implements java.lang.Comparable<Descriptors.FieldDescriptor>, com.google.protobuf.FieldSet.FieldDescriptorLite<Descriptors.FieldDescriptor>
Describes a field of a message type.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classDescriptors.FieldDescriptor.JavaTypestatic classDescriptors.FieldDescriptor.Type
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description intcompareTo(Descriptors.FieldDescriptor other)Compare with anotherFieldDescriptor.Descriptors.OneofDescriptorgetContainingOneof()Get the field's containing oneof.Descriptors.DescriptorgetContainingType()Get the field's containing type.java.lang.ObjectgetDefaultValue()Returns the field's default value.Descriptors.EnumDescriptorgetEnumType()For enum fields, gets the field's type.Descriptors.DescriptorgetExtensionScope()For extensions defined nested within message types, gets the outer type.Descriptors.FileDescriptorgetFile()Get theFileDescriptorcontaining this descriptor.java.lang.StringgetFullName()Get the field's fully-qualified name.intgetIndex()Get the index of this descriptor within its parent.Descriptors.FieldDescriptor.JavaTypegetJavaType()Get the field's java type.java.lang.StringgetJsonName()Get the JSON name of this field.WireFormat.JavaTypegetLiteJavaType()For internal use only.WireFormat.FieldTypegetLiteType()For internal use only.Descriptors.DescriptorgetMessageType()For embedded message and group fields, gets the field's type.java.lang.StringgetName()Get the field's unqualified name.intgetNumber()Get the field's number.DescriptorProtos.FieldOptionsgetOptions()Get theFieldOptions, defined indescriptor.proto.Descriptors.OneofDescriptorgetRealContainingOneof()Get the field's containing oneof, only if non-synthetic.Descriptors.FieldDescriptor.TypegetType()Get the field's declared type.booleanhasDefaultValue()Returns true if the field had an explicitly-defined default value.booleanhasOptionalKeyword()Returns true if this field was syntactically written with "optional" in the .proto file.booleanhasPresence()Returns true if this field tracks presence, ie.MessageLite.BuilderinternalMergeFrom(MessageLite.Builder to, MessageLite from)For internal use only.booleanisExtension()Is this field an extension?booleanisMapField()booleanisOptional()Is this field declared optional?booleanisPackable()Can this field be packed? That is, is it a repeated primitive field?booleanisPacked()Does this field have the[packed = true]option or is this field packable in proto3 and not explicitly set to unpacked?booleanisRepeated()Is this field declared repeated?booleanisRequired()Is this field declared required?booleanneedsUtf8Check()For internal use only.DescriptorProtos.FieldDescriptorPrototoProto()Convert the descriptor to its protocol message representation.java.lang.StringtoString()
-
-
-
Method Detail
-
getIndex
public int getIndex()
Get the index of this descriptor within its parent.- See Also:
Descriptors.Descriptor.getIndex()
-
toProto
public DescriptorProtos.FieldDescriptorProto toProto()
Convert the descriptor to its protocol message representation.- Specified by:
toProtoin classDescriptors.GenericDescriptor
-
getName
public java.lang.String getName()
Get the field's unqualified name.- Specified by:
getNamein classDescriptors.GenericDescriptor
-
getNumber
public int getNumber()
Get the field's number.- Specified by:
getNumberin interfacecom.google.protobuf.FieldSet.FieldDescriptorLite<Descriptors.FieldDescriptor>
-
getFullName
public java.lang.String getFullName()
Get the field's fully-qualified name.- Specified by:
getFullNamein classDescriptors.GenericDescriptor- See Also:
Descriptors.Descriptor.getFullName()
-
getJsonName
public java.lang.String getJsonName()
Get the JSON name of this field.
-
getJavaType
public Descriptors.FieldDescriptor.JavaType getJavaType()
Get the field's java type. This is just for convenience. EveryFieldDescriptorProto.Typemaps to exactly one Java type.
-
getLiteJavaType
public WireFormat.JavaType getLiteJavaType()
For internal use only.- Specified by:
getLiteJavaTypein interfacecom.google.protobuf.FieldSet.FieldDescriptorLite<Descriptors.FieldDescriptor>
-
getFile
public Descriptors.FileDescriptor getFile()
Get theFileDescriptorcontaining this descriptor.- Specified by:
getFilein classDescriptors.GenericDescriptor
-
getType
public Descriptors.FieldDescriptor.Type getType()
Get the field's declared type.
-
getLiteType
public WireFormat.FieldType getLiteType()
For internal use only.- Specified by:
getLiteTypein interfacecom.google.protobuf.FieldSet.FieldDescriptorLite<Descriptors.FieldDescriptor>
-
needsUtf8Check
public boolean needsUtf8Check()
For internal use only.
-
isMapField
public boolean isMapField()
-
isRequired
public boolean isRequired()
Is this field declared required?
-
isOptional
public boolean isOptional()
Is this field declared optional?
-
isRepeated
public boolean isRepeated()
Is this field declared repeated?- Specified by:
isRepeatedin interfacecom.google.protobuf.FieldSet.FieldDescriptorLite<Descriptors.FieldDescriptor>
-
isPacked
public boolean isPacked()
Does this field have the[packed = true]option or is this field packable in proto3 and not explicitly set to unpacked?- Specified by:
isPackedin interfacecom.google.protobuf.FieldSet.FieldDescriptorLite<Descriptors.FieldDescriptor>
-
isPackable
public boolean isPackable()
Can this field be packed? That is, is it a repeated primitive field?
-
hasDefaultValue
public boolean hasDefaultValue()
Returns true if the field had an explicitly-defined default value.
-
getDefaultValue
public java.lang.Object getDefaultValue()
Returns the field's default value. Valid for all types except for messages and groups. For all other types, the object returned is of the same class that would returned by Message.getField(this).
-
getOptions
public DescriptorProtos.FieldOptions getOptions()
Get theFieldOptions, defined indescriptor.proto.
-
isExtension
public boolean isExtension()
Is this field an extension?
-
getContainingType
public Descriptors.Descriptor getContainingType()
Get the field's containing type. For extensions, this is the type being extended, not the location where the extension was defined. SeegetExtensionScope().
-
getContainingOneof
public Descriptors.OneofDescriptor getContainingOneof()
Get the field's containing oneof.
-
getRealContainingOneof
public Descriptors.OneofDescriptor getRealContainingOneof()
Get the field's containing oneof, only if non-synthetic.
-
hasOptionalKeyword
public boolean hasOptionalKeyword()
Returns true if this field was syntactically written with "optional" in the .proto file. Excludes singular proto3 fields that do not have a label.
-
hasPresence
public boolean hasPresence()
Returns true if this field tracks presence, ie. does the field distinguish between "unset" and "present with default value."This includes required, optional, and oneof fields. It excludes maps, repeated fields, and singular proto3 fields without "optional".
For fields where hasPresence() == true, the return value of msg.hasField() is semantically meaningful.
-
getExtensionScope
public Descriptors.Descriptor getExtensionScope()
For extensions defined nested within message types, gets the outer type. Not valid for non-extension fields. For example, consider this.protofile:message Foo { extensions 1000 to max; } extend Foo { optional int32 baz = 1234; } message Bar { extend Foo { optional int32 moo = 4321; } }Bothbaz's andmoo's containing type isFoo. However,baz's extension scope isnullwhilemoo's extension scope isBar.
-
getMessageType
public Descriptors.Descriptor getMessageType()
For embedded message and group fields, gets the field's type.
-
getEnumType
public Descriptors.EnumDescriptor getEnumType()
For enum fields, gets the field's type.- Specified by:
getEnumTypein interfacecom.google.protobuf.FieldSet.FieldDescriptorLite<Descriptors.FieldDescriptor>
-
compareTo
public int compareTo(Descriptors.FieldDescriptor other)
Compare with anotherFieldDescriptor. This orders fields in "canonical" order, which simply means ascending order by field number.othermust be a field of the same type. That is,getContainingType()must return the sameDescriptorfor both fields.- Specified by:
compareToin interfacejava.lang.Comparable<Descriptors.FieldDescriptor>- Returns:
- negative, zero, or positive if
thisis less than, equal to, or greater thanother, respectively
-
toString
public java.lang.String toString()
- Overrides:
toStringin classjava.lang.Object
-
internalMergeFrom
public MessageLite.Builder internalMergeFrom(MessageLite.Builder to, MessageLite from)
For internal use only. This is to satisfy the FieldDescriptorLite interface.- Specified by:
internalMergeFromin interfacecom.google.protobuf.FieldSet.FieldDescriptorLite<Descriptors.FieldDescriptor>
-
-