Package com.google.protobuf

Class Descriptors

java.lang.Object

com.google.protobuf.Descriptors

@CheckReturnValue
public final class Descriptors
extends java.lang.Object

Contains a collection of classes which describe protocol message types.

Every message type has a Descriptors.Descriptor, which lists all its fields and other information about a type. You can get a message type's descriptor by calling MessageType.getDescriptor(), or (given a message object of the type) message.getDescriptorForType(). Furthermore, each message is associated with a Descriptors.FileDescriptor for a relevant .proto file. You can obtain it by calling Descriptor.getFile(). A Descriptors.FileDescriptor contains descriptors for all the messages defined in that file, and file descriptors for all the imported .proto files.

Descriptors are built from DescriptorProtos, as defined in google/protobuf/descriptor.proto.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Descriptors.Descriptor	Describes a message type.
private static class	Descriptors.DescriptorPool	A private helper class which contains lookup tables containing all the descriptors defined in a particular file.
static class	Descriptors.DescriptorValidationException	Thrown when building descriptors fails because the source DescriptorProtos are not valid.
static class	Descriptors.EnumDescriptor	Describes an enum type.
static class	Descriptors.EnumValueDescriptor	Describes one value within an enum type.
static class	Descriptors.FieldDescriptor	Describes a field of a message type.
static class	Descriptors.FileDescriptor	Describes a .proto file, including everything defined within.
static class	Descriptors.GenericDescriptor	All descriptors implement this to make it easier to implement tools like DescriptorPool.
static class	Descriptors.MethodDescriptor	Describes one method within a service type.
private static interface	Descriptors.NumberGetter<T>
static class	Descriptors.OneofDescriptor	Describes a oneof of a message type.
static class	Descriptors.ServiceDescriptor	Describes a service type.

Field Summary

Fields

Modifier and Type	Field	Description
private static Descriptors.Descriptor[]	EMPTY_DESCRIPTORS
private static Descriptors.EnumDescriptor[]	EMPTY_ENUM_DESCRIPTORS
private static Descriptors.FieldDescriptor[]	EMPTY_FIELD_DESCRIPTORS
private static int[]	EMPTY_INT_ARRAY
private static Descriptors.OneofDescriptor[]	EMPTY_ONEOF_DESCRIPTORS
private static Descriptors.ServiceDescriptor[]	EMPTY_SERVICE_DESCRIPTORS
private static java.util.concurrent.ConcurrentHashMap<java.lang.Integer,DescriptorProtos.FeatureSet>	FEATURE_CACHE
private static DescriptorProtos.FeatureSetDefaults	javaEditionDefaults
private static java.util.logging.Logger	logger

Constructor Summary

Constructors

Constructor	Description
Descriptors()

Method Summary

Modifier and Type	Method	Description
private static <T> T	binarySearch(T[] array, int size, Descriptors.NumberGetter<T> getter, int number)
private static java.lang.String	computeFullName(Descriptors.FileDescriptor file, Descriptors.Descriptor parent, java.lang.String name)
(package private) static DescriptorProtos.FeatureSet	getEditionDefaults(DescriptorProtos.Edition edition)
(package private) static DescriptorProtos.FeatureSetDefaults	getJavaEditionDefaults()	Gets the default feature mappings used during the build.
private static DescriptorProtos.FeatureSet	internFeatures(DescriptorProtos.FeatureSet features)
(package private) static void	setTestJavaEditionDefaults(DescriptorProtos.FeatureSetDefaults defaults)	Sets the default feature mappings used during the build.

Methods inherited from class java.lang.Object

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

Field Detail

logger

private static final java.util.logging.Logger logger

EMPTY_INT_ARRAY

private static final int[] EMPTY_INT_ARRAY

EMPTY_DESCRIPTORS

private static final Descriptors.Descriptor[] EMPTY_DESCRIPTORS

EMPTY_FIELD_DESCRIPTORS

private static final Descriptors.FieldDescriptor[] EMPTY_FIELD_DESCRIPTORS

EMPTY_ENUM_DESCRIPTORS

private static final Descriptors.EnumDescriptor[] EMPTY_ENUM_DESCRIPTORS

EMPTY_SERVICE_DESCRIPTORS

private static final Descriptors.ServiceDescriptor[] EMPTY_SERVICE_DESCRIPTORS

EMPTY_ONEOF_DESCRIPTORS

private static final Descriptors.OneofDescriptor[] EMPTY_ONEOF_DESCRIPTORS

FEATURE_CACHE

private static final java.util.concurrent.ConcurrentHashMap<java.lang.Integer,DescriptorProtos.FeatureSet> FEATURE_CACHE

javaEditionDefaults

private static volatile DescriptorProtos.FeatureSetDefaults javaEditionDefaults

Constructor Detail

Descriptors

public Descriptors()

Method Detail

setTestJavaEditionDefaults

static void setTestJavaEditionDefaults(DescriptorProtos.FeatureSetDefaults defaults)

Sets the default feature mappings used during the build. Exposed for tests.

getJavaEditionDefaults

static DescriptorProtos.FeatureSetDefaults getJavaEditionDefaults()

Gets the default feature mappings used during the build.

getEditionDefaults

static DescriptorProtos.FeatureSet getEditionDefaults(DescriptorProtos.Edition edition)

internFeatures

private static DescriptorProtos.FeatureSet internFeatures(DescriptorProtos.FeatureSet features)

computeFullName

private static java.lang.String computeFullName(Descriptors.FileDescriptor file,
                                                Descriptors.Descriptor parent,
                                                java.lang.String name)

binarySearch

private static <T> T binarySearch(T[] array,
                                  int size,
                                  Descriptors.NumberGetter<T> getter,
                                  int number)