Class ResourceLocator.Directive

java.lang.Object
com.google.protobuf.AbstractMessageLite
com.google.protobuf.AbstractMessage
com.google.protobuf.GeneratedMessage
com.github.xds.core.v3.ResourceLocator.Directive
All Implemented Interfaces:
ResourceLocator.DirectiveOrBuilder, com.google.protobuf.Message, com.google.protobuf.MessageLite, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, Serializable
Enclosing class:
ResourceLocator

public static final class ResourceLocator.Directive extends com.google.protobuf.GeneratedMessage implements ResourceLocator.DirectiveOrBuilder
 Directives provide information to data-plane load balancers on how xDS
 resource names are to be interpreted and potentially further resolved. For
 example, they may provide alternative resource locators for when primary
 resolution fails. Directives are not part of resource names and do not
 appear in a xDS transport discovery request.

 When encoding to URIs, directives take the form:

 <directive name>=<string representation of directive value>

 For example, we can have alt=xdstp://foo/bar or entry=some%20thing. Each
 directive value type may have its own string encoding, in the case of
 ResourceLocator there is a recursive URI encoding.

 Percent encoding applies to the URI encoding of the directive value.
 Multiple directives are comma-separated, so the reserved characters that
 require percent encoding in a directive value are [',', '#', '[', ']',
 '%']. These are the RFC3986 fragment reserved characters with the addition
 of the xDS scheme specific ','. See
 https://tools.ietf.org/html/rfc3986#page-49 for further details on URI ABNF
 and reserved characters.
 
Protobuf type xds.core.v3.ResourceLocator.Directive
See Also:
  • Field Details

    • serialVersionUID

      private static final long serialVersionUID
      See Also:
    • directiveCase_

      private int directiveCase_
    • directive_

      private Object directive_
    • ALT_FIELD_NUMBER

      public static final int ALT_FIELD_NUMBER
      See Also:
    • ENTRY_FIELD_NUMBER

      public static final int ENTRY_FIELD_NUMBER
      See Also:
    • memoizedIsInitialized

      private byte memoizedIsInitialized
    • DEFAULT_INSTANCE

      private static final ResourceLocator.Directive DEFAULT_INSTANCE
    • PARSER

      private static final com.google.protobuf.Parser<ResourceLocator.Directive> PARSER
  • Constructor Details

    • Directive

      private Directive(com.google.protobuf.GeneratedMessage.Builder<?> builder)
    • Directive

      private Directive()
  • Method Details

    • getDescriptor

      public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()
    • internalGetFieldAccessorTable

      protected com.google.protobuf.GeneratedMessage.FieldAccessorTable internalGetFieldAccessorTable()
      Specified by:
      internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessage
    • getDirectiveCase

      public ResourceLocator.Directive.DirectiveCase getDirectiveCase()
      Specified by:
      getDirectiveCase in interface ResourceLocator.DirectiveOrBuilder
    • hasAlt

      public boolean hasAlt()
       An alternative resource locator for fallback if the resource is
       unavailable. For example, take the resource locator:
      
       xdstp://foo/some-type/some-route-table#alt=xdstp://bar/some-type/another-route-table
      
       If the data-plane load balancer is unable to reach `foo` to fetch the
       resource, it will fallback to `bar`. Alternative resources do not need
       to have equivalent content, but they should be functional substitutes.
       
      .xds.core.v3.ResourceLocator alt = 1;
      Specified by:
      hasAlt in interface ResourceLocator.DirectiveOrBuilder
      Returns:
      Whether the alt field is set.
    • getAlt

      public ResourceLocator getAlt()
       An alternative resource locator for fallback if the resource is
       unavailable. For example, take the resource locator:
      
       xdstp://foo/some-type/some-route-table#alt=xdstp://bar/some-type/another-route-table
      
       If the data-plane load balancer is unable to reach `foo` to fetch the
       resource, it will fallback to `bar`. Alternative resources do not need
       to have equivalent content, but they should be functional substitutes.
       
      .xds.core.v3.ResourceLocator alt = 1;
      Specified by:
      getAlt in interface ResourceLocator.DirectiveOrBuilder
      Returns:
      The alt.
    • getAltOrBuilder

      public ResourceLocatorOrBuilder getAltOrBuilder()
       An alternative resource locator for fallback if the resource is
       unavailable. For example, take the resource locator:
      
       xdstp://foo/some-type/some-route-table#alt=xdstp://bar/some-type/another-route-table
      
       If the data-plane load balancer is unable to reach `foo` to fetch the
       resource, it will fallback to `bar`. Alternative resources do not need
       to have equivalent content, but they should be functional substitutes.
       
      .xds.core.v3.ResourceLocator alt = 1;
      Specified by:
      getAltOrBuilder in interface ResourceLocator.DirectiveOrBuilder
    • hasEntry

      public boolean hasEntry()
       List collections support inlining of resources via the entry field in
       Resource. These inlined Resource objects may have an optional name
       field specified. When specified, the entry directive allows
       ResourceLocator to directly reference these inlined resources, e.g.
       xdstp://.../foo#entry=bar.
       
      string entry = 2 [(.validate.rules) = { ... }
      Specified by:
      hasEntry in interface ResourceLocator.DirectiveOrBuilder
      Returns:
      Whether the entry field is set.
    • getEntry

      public String getEntry()
       List collections support inlining of resources via the entry field in
       Resource. These inlined Resource objects may have an optional name
       field specified. When specified, the entry directive allows
       ResourceLocator to directly reference these inlined resources, e.g.
       xdstp://.../foo#entry=bar.
       
      string entry = 2 [(.validate.rules) = { ... }
      Specified by:
      getEntry in interface ResourceLocator.DirectiveOrBuilder
      Returns:
      The entry.
    • getEntryBytes

      public com.google.protobuf.ByteString getEntryBytes()
       List collections support inlining of resources via the entry field in
       Resource. These inlined Resource objects may have an optional name
       field specified. When specified, the entry directive allows
       ResourceLocator to directly reference these inlined resources, e.g.
       xdstp://.../foo#entry=bar.
       
      string entry = 2 [(.validate.rules) = { ... }
      Specified by:
      getEntryBytes in interface ResourceLocator.DirectiveOrBuilder
      Returns:
      The bytes for entry.
    • isInitialized

      public final boolean isInitialized()
      Specified by:
      isInitialized in interface com.google.protobuf.MessageLiteOrBuilder
      Overrides:
      isInitialized in class com.google.protobuf.GeneratedMessage
    • writeTo

      public void writeTo(com.google.protobuf.CodedOutputStream output) throws IOException
      Specified by:
      writeTo in interface com.google.protobuf.MessageLite
      Overrides:
      writeTo in class com.google.protobuf.GeneratedMessage
      Throws:
      IOException
    • getSerializedSize

      public int getSerializedSize()
      Specified by:
      getSerializedSize in interface com.google.protobuf.MessageLite
      Overrides:
      getSerializedSize in class com.google.protobuf.GeneratedMessage
    • equals

      public boolean equals(Object obj)
      Specified by:
      equals in interface com.google.protobuf.Message
      Overrides:
      equals in class com.google.protobuf.AbstractMessage
    • hashCode

      public int hashCode()
      Specified by:
      hashCode in interface com.google.protobuf.Message
      Overrides:
      hashCode in class com.google.protobuf.AbstractMessage
    • parseFrom

      public static ResourceLocator.Directive parseFrom(ByteBuffer data) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException
    • parseFrom

      public static ResourceLocator.Directive parseFrom(ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException
    • parseFrom

      public static ResourceLocator.Directive parseFrom(com.google.protobuf.ByteString data) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException
    • parseFrom

      public static ResourceLocator.Directive parseFrom(com.google.protobuf.ByteString data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException
    • parseFrom

      public static ResourceLocator.Directive parseFrom(byte[] data) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException
    • parseFrom

      public static ResourceLocator.Directive parseFrom(byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws com.google.protobuf.InvalidProtocolBufferException
      Throws:
      com.google.protobuf.InvalidProtocolBufferException
    • parseFrom

      public static ResourceLocator.Directive parseFrom(InputStream input) throws IOException
      Throws:
      IOException
    • parseFrom

      public static ResourceLocator.Directive parseFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Throws:
      IOException
    • parseDelimitedFrom

      public static ResourceLocator.Directive parseDelimitedFrom(InputStream input) throws IOException
      Throws:
      IOException
    • parseDelimitedFrom

      public static ResourceLocator.Directive parseDelimitedFrom(InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Throws:
      IOException
    • parseFrom

      public static ResourceLocator.Directive parseFrom(com.google.protobuf.CodedInputStream input) throws IOException
      Throws:
      IOException
    • parseFrom

      public static ResourceLocator.Directive parseFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Throws:
      IOException
    • newBuilderForType

      public ResourceLocator.Directive.Builder newBuilderForType()
      Specified by:
      newBuilderForType in interface com.google.protobuf.Message
      Specified by:
      newBuilderForType in interface com.google.protobuf.MessageLite
    • newBuilder

      public static ResourceLocator.Directive.Builder newBuilder()
    • newBuilder

      public static ResourceLocator.Directive.Builder newBuilder(ResourceLocator.Directive prototype)
    • toBuilder

      Specified by:
      toBuilder in interface com.google.protobuf.Message
      Specified by:
      toBuilder in interface com.google.protobuf.MessageLite
    • newBuilderForType

      protected ResourceLocator.Directive.Builder newBuilderForType(com.google.protobuf.AbstractMessage.BuilderParent parent)
      Overrides:
      newBuilderForType in class com.google.protobuf.AbstractMessage
    • getDefaultInstance

      public static ResourceLocator.Directive getDefaultInstance()
    • parser

      public static com.google.protobuf.Parser<ResourceLocator.Directive> parser()
    • getParserForType

      public com.google.protobuf.Parser<ResourceLocator.Directive> getParserForType()
      Specified by:
      getParserForType in interface com.google.protobuf.Message
      Specified by:
      getParserForType in interface com.google.protobuf.MessageLite
      Overrides:
      getParserForType in class com.google.protobuf.GeneratedMessage
    • getDefaultInstanceForType

      public ResourceLocator.Directive getDefaultInstanceForType()
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder