Package com.google.protobuf
Class Api
- java.lang.Object
-
- All Implemented Interfaces:
ApiOrBuilder,Message,MessageLite,MessageLiteOrBuilder,MessageOrBuilder,java.io.Serializable
public final class Api extends GeneratedMessageV3 implements ApiOrBuilder
Api is a light-weight descriptor for an API Interface. Interfaces are also described as "protocol buffer services" in some contexts, such as by the "service" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as "APIs" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology.
Protobuf typegoogle.protobuf.Api- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static classApi.BuilderApi is a light-weight descriptor for an API Interface.-
Nested classes/interfaces inherited from class com.google.protobuf.GeneratedMessageV3
GeneratedMessageV3.BuilderParent, GeneratedMessageV3.ExtendableBuilder<MessageType extends GeneratedMessageV3.ExtendableMessage,BuilderType extends GeneratedMessageV3.ExtendableBuilder<MessageType,BuilderType>>, GeneratedMessageV3.ExtendableMessage<MessageType extends GeneratedMessageV3.ExtendableMessage>, GeneratedMessageV3.ExtendableMessageOrBuilder<MessageType extends GeneratedMessageV3.ExtendableMessage>, GeneratedMessageV3.FieldAccessorTable, GeneratedMessageV3.UnusedPrivateParameter
-
Nested classes/interfaces inherited from class com.google.protobuf.AbstractMessageLite
AbstractMessageLite.InternalOneOfEnum
-
-
Field Summary
Fields Modifier and Type Field Description static intMETHODS_FIELD_NUMBERstatic intMIXINS_FIELD_NUMBERstatic intNAME_FIELD_NUMBERstatic intOPTIONS_FIELD_NUMBERstatic intSOURCE_CONTEXT_FIELD_NUMBERstatic intSYNTAX_FIELD_NUMBERstatic intVERSION_FIELD_NUMBER-
Fields inherited from class com.google.protobuf.GeneratedMessageV3
alwaysUseFieldBuilders, unknownFields
-
Fields inherited from class com.google.protobuf.AbstractMessage
memoizedSize
-
Fields inherited from class com.google.protobuf.AbstractMessageLite
memoizedHashCode
-
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description booleanequals(java.lang.Object obj)Compares the specified object with this message for equality.static ApigetDefaultInstance()ApigetDefaultInstanceForType()Get an instance of the type with no fields set.static Descriptors.DescriptorgetDescriptor()MethodgetMethods(int index)The methods of this interface, in unspecified order.intgetMethodsCount()The methods of this interface, in unspecified order.java.util.List<Method>getMethodsList()The methods of this interface, in unspecified order.MethodOrBuildergetMethodsOrBuilder(int index)The methods of this interface, in unspecified order.java.util.List<? extends MethodOrBuilder>getMethodsOrBuilderList()The methods of this interface, in unspecified order.MixingetMixins(int index)Included interfaces.intgetMixinsCount()Included interfaces.java.util.List<Mixin>getMixinsList()Included interfaces.MixinOrBuildergetMixinsOrBuilder(int index)Included interfaces.java.util.List<? extends MixinOrBuilder>getMixinsOrBuilderList()Included interfaces.java.lang.StringgetName()The fully qualified name of this interface, including package name followed by the interface's simple name.ByteStringgetNameBytes()The fully qualified name of this interface, including package name followed by the interface's simple name.OptiongetOptions(int index)Any metadata attached to the interface.intgetOptionsCount()Any metadata attached to the interface.java.util.List<Option>getOptionsList()Any metadata attached to the interface.OptionOrBuildergetOptionsOrBuilder(int index)Any metadata attached to the interface.java.util.List<? extends OptionOrBuilder>getOptionsOrBuilderList()Any metadata attached to the interface.Parser<Api>getParserForType()Gets the parser for a message of the same type as this message.intgetSerializedSize()Get the number of bytes required to encode this message.SourceContextgetSourceContext()Source context for the protocol buffer service represented by this message.SourceContextOrBuildergetSourceContextOrBuilder()Source context for the protocol buffer service represented by this message.SyntaxgetSyntax()The source syntax of the service.intgetSyntaxValue()The source syntax of the service.UnknownFieldSetgetUnknownFields()Get theUnknownFieldSetfor this message.java.lang.StringgetVersion()A version string for this interface.ByteStringgetVersionBytes()A version string for this interface.inthashCode()Returns the hash code value for this message.booleanhasSourceContext()Source context for the protocol buffer service represented by this message.protected GeneratedMessageV3.FieldAccessorTableinternalGetFieldAccessorTable()Get the FieldAccessorTable for this type.booleanisInitialized()Returns true if all required fields in the message and all embedded messages are set, false otherwise.static Api.BuildernewBuilder()static Api.BuildernewBuilder(Api prototype)Api.BuildernewBuilderForType()Constructs a new builder for a message of the same type as this message.protected Api.BuildernewBuilderForType(GeneratedMessageV3.BuilderParent parent)TODO(xiaofeng): remove this together with GeneratedMessageV3.BuilderParent.protected java.lang.ObjectnewInstance(GeneratedMessageV3.UnusedPrivateParameter unused)Creates a new instance of this message type.static ApiparseDelimitedFrom(java.io.InputStream input)static ApiparseDelimitedFrom(java.io.InputStream input, ExtensionRegistryLite extensionRegistry)static ApiparseFrom(byte[] data)static ApiparseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)static ApiparseFrom(ByteString data)static ApiparseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)static ApiparseFrom(CodedInputStream input)static ApiparseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)static ApiparseFrom(java.io.InputStream input)static ApiparseFrom(java.io.InputStream input, ExtensionRegistryLite extensionRegistry)static ApiparseFrom(java.nio.ByteBuffer data)static ApiparseFrom(java.nio.ByteBuffer data, ExtensionRegistryLite extensionRegistry)static Parser<Api>parser()Api.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.GeneratedMessageV3
canUseUnsafe, computeStringSize, computeStringSizeNoTag, emptyBooleanList, emptyDoubleList, emptyFloatList, emptyIntList, emptyLongList, getAllFields, getDescriptorForType, getField, getOneofFieldDescriptor, getRepeatedField, getRepeatedFieldCount, hasField, hasOneof, internalGetMapField, makeExtensionsImmutable, mergeFromAndMakeImmutableInternal, mutableCopy, mutableCopy, mutableCopy, mutableCopy, mutableCopy, newBooleanList, newBuilderForType, newDoubleList, newFloatList, newIntList, newLongList, parseDelimitedWithIOException, parseDelimitedWithIOException, parseUnknownField, parseUnknownFieldProto3, parseWithIOException, parseWithIOException, parseWithIOException, parseWithIOException, serializeBooleanMapTo, serializeIntegerMapTo, serializeLongMapTo, serializeStringMapTo, writeReplace, writeString, writeStringNoTag
-
Methods inherited from class com.google.protobuf.AbstractMessage
findInitializationErrors, getInitializationErrorString, hashBoolean, hashEnum, hashEnumList, hashFields, hashLong, toString
-
Methods inherited from class com.google.protobuf.AbstractMessageLite
addAll, addAll, checkByteStringIsUtf8, 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, hasField, hasOneof
-
-
-
-
Field Detail
-
NAME_FIELD_NUMBER
public static final int NAME_FIELD_NUMBER
- See Also:
- Constant Field Values
-
METHODS_FIELD_NUMBER
public static final int METHODS_FIELD_NUMBER
- See Also:
- Constant Field Values
-
OPTIONS_FIELD_NUMBER
public static final int OPTIONS_FIELD_NUMBER
- See Also:
- Constant Field Values
-
VERSION_FIELD_NUMBER
public static final int VERSION_FIELD_NUMBER
- See Also:
- Constant Field Values
-
SOURCE_CONTEXT_FIELD_NUMBER
public static final int SOURCE_CONTEXT_FIELD_NUMBER
- See Also:
- Constant Field Values
-
MIXINS_FIELD_NUMBER
public static final int MIXINS_FIELD_NUMBER
- See Also:
- Constant Field Values
-
SYNTAX_FIELD_NUMBER
public static final int SYNTAX_FIELD_NUMBER
- See Also:
- Constant Field Values
-
-
Method Detail
-
newInstance
protected java.lang.Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Description copied from class:GeneratedMessageV3Creates a new instance of this message type. Overridden in the generated code.- Overrides:
newInstancein classGeneratedMessageV3
-
getUnknownFields
public final UnknownFieldSet getUnknownFields()
Description copied from interface:MessageOrBuilderGet theUnknownFieldSetfor this message.- Specified by:
getUnknownFieldsin interfaceMessageOrBuilder- Overrides:
getUnknownFieldsin classGeneratedMessageV3
-
getDescriptor
public static final Descriptors.Descriptor getDescriptor()
-
internalGetFieldAccessorTable
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Description copied from class:GeneratedMessageV3Get 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 classGeneratedMessageV3
-
getName
public java.lang.String getName()
The fully qualified name of this interface, including package name followed by the interface's simple name.
string name = 1;- Specified by:
getNamein interfaceApiOrBuilder- Returns:
- The name.
-
getNameBytes
public ByteString getNameBytes()
The fully qualified name of this interface, including package name followed by the interface's simple name.
string name = 1;- Specified by:
getNameBytesin interfaceApiOrBuilder- Returns:
- The bytes for name.
-
getMethodsList
public java.util.List<Method> getMethodsList()
The methods of this interface, in unspecified order.
repeated .google.protobuf.Method methods = 2;- Specified by:
getMethodsListin interfaceApiOrBuilder
-
getMethodsOrBuilderList
public java.util.List<? extends MethodOrBuilder> getMethodsOrBuilderList()
The methods of this interface, in unspecified order.
repeated .google.protobuf.Method methods = 2;- Specified by:
getMethodsOrBuilderListin interfaceApiOrBuilder
-
getMethodsCount
public int getMethodsCount()
The methods of this interface, in unspecified order.
repeated .google.protobuf.Method methods = 2;- Specified by:
getMethodsCountin interfaceApiOrBuilder
-
getMethods
public Method getMethods(int index)
The methods of this interface, in unspecified order.
repeated .google.protobuf.Method methods = 2;- Specified by:
getMethodsin interfaceApiOrBuilder
-
getMethodsOrBuilder
public MethodOrBuilder getMethodsOrBuilder(int index)
The methods of this interface, in unspecified order.
repeated .google.protobuf.Method methods = 2;- Specified by:
getMethodsOrBuilderin interfaceApiOrBuilder
-
getOptionsList
public java.util.List<Option> getOptionsList()
Any metadata attached to the interface.
repeated .google.protobuf.Option options = 3;- Specified by:
getOptionsListin interfaceApiOrBuilder
-
getOptionsOrBuilderList
public java.util.List<? extends OptionOrBuilder> getOptionsOrBuilderList()
Any metadata attached to the interface.
repeated .google.protobuf.Option options = 3;- Specified by:
getOptionsOrBuilderListin interfaceApiOrBuilder
-
getOptionsCount
public int getOptionsCount()
Any metadata attached to the interface.
repeated .google.protobuf.Option options = 3;- Specified by:
getOptionsCountin interfaceApiOrBuilder
-
getOptions
public Option getOptions(int index)
Any metadata attached to the interface.
repeated .google.protobuf.Option options = 3;- Specified by:
getOptionsin interfaceApiOrBuilder
-
getOptionsOrBuilder
public OptionOrBuilder getOptionsOrBuilder(int index)
Any metadata attached to the interface.
repeated .google.protobuf.Option options = 3;- Specified by:
getOptionsOrBuilderin interfaceApiOrBuilder
-
getVersion
public java.lang.String getVersion()
A version string for this interface. If specified, must have the form `major-version.minor-version`, as in `1.10`. If the minor version is omitted, it defaults to zero. If the entire version field is empty, the major version is derived from the package name, as outlined below. If the field is not empty, the version in the package name will be verified to be consistent with what is provided here. The versioning schema uses [semantic versioning](http://semver.org) where the major version number indicates a breaking change and the minor version an additive, non-breaking change. Both version numbers are signals to users what to expect from different versions, and should be carefully chosen based on the product plan. The major version is also reflected in the package name of the interface, which must end in `v<major-version>`, as in `google.feature.v1`. For major versions 0 and 1, the suffix can be omitted. Zero major versions must only be used for experimental, non-GA interfaces.
string version = 4;- Specified by:
getVersionin interfaceApiOrBuilder- Returns:
- The version.
-
getVersionBytes
public ByteString getVersionBytes()
A version string for this interface. If specified, must have the form `major-version.minor-version`, as in `1.10`. If the minor version is omitted, it defaults to zero. If the entire version field is empty, the major version is derived from the package name, as outlined below. If the field is not empty, the version in the package name will be verified to be consistent with what is provided here. The versioning schema uses [semantic versioning](http://semver.org) where the major version number indicates a breaking change and the minor version an additive, non-breaking change. Both version numbers are signals to users what to expect from different versions, and should be carefully chosen based on the product plan. The major version is also reflected in the package name of the interface, which must end in `v<major-version>`, as in `google.feature.v1`. For major versions 0 and 1, the suffix can be omitted. Zero major versions must only be used for experimental, non-GA interfaces.
string version = 4;- Specified by:
getVersionBytesin interfaceApiOrBuilder- Returns:
- The bytes for version.
-
hasSourceContext
public boolean hasSourceContext()
Source context for the protocol buffer service represented by this message.
.google.protobuf.SourceContext source_context = 5;- Specified by:
hasSourceContextin interfaceApiOrBuilder- Returns:
- Whether the sourceContext field is set.
-
getSourceContext
public SourceContext getSourceContext()
Source context for the protocol buffer service represented by this message.
.google.protobuf.SourceContext source_context = 5;- Specified by:
getSourceContextin interfaceApiOrBuilder- Returns:
- The sourceContext.
-
getSourceContextOrBuilder
public SourceContextOrBuilder getSourceContextOrBuilder()
Source context for the protocol buffer service represented by this message.
.google.protobuf.SourceContext source_context = 5;- Specified by:
getSourceContextOrBuilderin interfaceApiOrBuilder
-
getMixinsList
public java.util.List<Mixin> getMixinsList()
Included interfaces. See [Mixin][].
repeated .google.protobuf.Mixin mixins = 6;- Specified by:
getMixinsListin interfaceApiOrBuilder
-
getMixinsOrBuilderList
public java.util.List<? extends MixinOrBuilder> getMixinsOrBuilderList()
Included interfaces. See [Mixin][].
repeated .google.protobuf.Mixin mixins = 6;- Specified by:
getMixinsOrBuilderListin interfaceApiOrBuilder
-
getMixinsCount
public int getMixinsCount()
Included interfaces. See [Mixin][].
repeated .google.protobuf.Mixin mixins = 6;- Specified by:
getMixinsCountin interfaceApiOrBuilder
-
getMixins
public Mixin getMixins(int index)
Included interfaces. See [Mixin][].
repeated .google.protobuf.Mixin mixins = 6;- Specified by:
getMixinsin interfaceApiOrBuilder
-
getMixinsOrBuilder
public MixinOrBuilder getMixinsOrBuilder(int index)
Included interfaces. See [Mixin][].
repeated .google.protobuf.Mixin mixins = 6;- Specified by:
getMixinsOrBuilderin interfaceApiOrBuilder
-
getSyntaxValue
public int getSyntaxValue()
The source syntax of the service.
.google.protobuf.Syntax syntax = 7;- Specified by:
getSyntaxValuein interfaceApiOrBuilder- Returns:
- The enum numeric value on the wire for syntax.
-
getSyntax
public Syntax getSyntax()
The source syntax of the service.
.google.protobuf.Syntax syntax = 7;- Specified by:
getSyntaxin interfaceApiOrBuilder- Returns:
- The syntax.
-
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 classGeneratedMessageV3
-
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 classGeneratedMessageV3- 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.- Specified by:
getSerializedSizein interfaceMessageLite- Overrides:
getSerializedSizein classGeneratedMessageV3
-
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 Api parseFrom(java.nio.ByteBuffer data) throws InvalidProtocolBufferException
- Throws:
InvalidProtocolBufferException
-
parseFrom
public static Api parseFrom(java.nio.ByteBuffer data, ExtensionRegistryLite extensionRegistry) throws InvalidProtocolBufferException
- Throws:
InvalidProtocolBufferException
-
parseFrom
public static Api parseFrom(ByteString data) throws InvalidProtocolBufferException
- Throws:
InvalidProtocolBufferException
-
parseFrom
public static Api parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry) throws InvalidProtocolBufferException
- Throws:
InvalidProtocolBufferException
-
parseFrom
public static Api parseFrom(byte[] data) throws InvalidProtocolBufferException
- Throws:
InvalidProtocolBufferException
-
parseFrom
public static Api parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry) throws InvalidProtocolBufferException
- Throws:
InvalidProtocolBufferException
-
parseFrom
public static Api parseFrom(java.io.InputStream input) throws java.io.IOException
- Throws:
java.io.IOException
-
parseFrom
public static Api parseFrom(java.io.InputStream input, ExtensionRegistryLite extensionRegistry) throws java.io.IOException
- Throws:
java.io.IOException
-
parseDelimitedFrom
public static Api parseDelimitedFrom(java.io.InputStream input) throws java.io.IOException
- Throws:
java.io.IOException
-
parseDelimitedFrom
public static Api parseDelimitedFrom(java.io.InputStream input, ExtensionRegistryLite extensionRegistry) throws java.io.IOException
- Throws:
java.io.IOException
-
parseFrom
public static Api parseFrom(CodedInputStream input) throws java.io.IOException
- Throws:
java.io.IOException
-
parseFrom
public static Api parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry) throws java.io.IOException
- Throws:
java.io.IOException
-
newBuilderForType
public Api.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 Api.Builder newBuilder()
-
newBuilder
public static Api.Builder newBuilder(Api prototype)
-
toBuilder
public Api.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 Api.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Description copied from class:GeneratedMessageV3TODO(xiaofeng): remove this together with GeneratedMessageV3.BuilderParent.- Specified by:
newBuilderForTypein classGeneratedMessageV3
-
getDefaultInstance
public static Api getDefaultInstance()
-
getParserForType
public Parser<Api> getParserForType()
Description copied from interface:MessageLiteGets the parser for a message of the same type as this message.- Specified by:
getParserForTypein interfaceMessage- Specified by:
getParserForTypein interfaceMessageLite- Overrides:
getParserForTypein classGeneratedMessageV3
-
getDefaultInstanceForType
public Api 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
-
-