Class RoutingRule (2.29.0)

Version 2.29.0

• 2.48.0 (latest)
• 2.46.0
• 2.45.1
• 2.44.0
• 2.43.0
• 2.42.0
• 2.41.0
• 2.40.0
• 2.39.1
• 2.38.0
• 2.37.1
• 2.36.0
• 2.34.0
• 2.33.0
• 2.32.0
• 2.30.0
• 2.29.0
• 2.28.0
• 2.27.0
• 2.26.0
• 2.25.1
• 2.24.0
• 2.23.1
• 2.22.1
• 2.21.1
• 2.15.0
• 2.14.3
• 2.13.0
• 2.12.0
• 2.11.0
• 2.10.0
• 2.9.6
• 2.8.4
• 2.7.4

public final class RoutingRule extends GeneratedMessageV3 implements RoutingRuleOrBuilder

Specifies the routing information that should be sent along with the request in the form of routing header. NOTE: All service configuration rules follow the "last one wins" order.

The examples below will apply to an RPC which has the following request type:

Message Definition:

 message Request {
   // The name of the Table
   // Values can be of the following formats:
   // - <code>projects/&lt;project&gt;/tables/&lt;table&gt;</code>
   // - <code>projects/&lt;project&gt;/instances/&lt;instance&gt;/tables/&lt;table&gt;</code>
   // - <code>region/&lt;region&gt;/zones/&lt;zone&gt;/tables/&lt;table&gt;</code>
   string table_name = 1;

   // This value specifies routing for replication.
   // It can be in the following formats:
   // - <code>profiles/&lt;profile_id&gt;</code>
   // - a legacy <code>profile_id</code> that can be any string
   string app_profile_id = 2;
 }

Example message:

 {
   table_name: projects/proj_foo/instances/instance_bar/table/table_baz,
   app_profile_id: profiles/prof_qux
 }

The routing header consists of one or multiple key-value pairs. Every key and value must be percent-encoded, and joined together in the format of key1=value1&key2=value2. In the examples below I am skipping the percent-encoding for readablity.

Example 1

Extracting a field from the request to put into the routing header unchanged, with the key equal to the field name.

annotation:

 option (google.api.routing) = {
   // Take the <code>app_profile_id</code>.
   routing_parameters {
     field: "app_profile_id"
   }
 };

result:

 x-goog-request-params: app_profile_id=profiles/prof_qux

Example 2

Extracting a field from the request to put into the routing header unchanged, with the key different from the field name.

annotation:

 option (google.api.routing) = {
   // Take the <code>app_profile_id</code>, but name it <code>routing_id</code> in the header.
   routing_parameters {
     field: "app_profile_id"
     path_template: "{routing_id=**}"
   }
 };

result:

 x-goog-request-params: routing_id=profiles/prof_qux

Example 3

Extracting a field from the request to put into the routing header, while matching a path template syntax on the field's value.

NB: it is more useful to send nothing than to send garbage for the purpose of dynamic routing, since garbage pollutes cache. Thus the matching.

Sub-example 3a

The field matches the template.

annotation:

 option (google.api.routing) = {
   // Take the <code>table_name</code>, if it's well-formed (with project-based
   // syntax).
   routing_parameters {
     field: "table_name"
     path_template: "{table_name=projects/&#42;&#47;instances/&#42;&#47;&#42;*}"
   }
 };

result:

 x-goog-request-params:
 table_name=projects/proj_foo/instances/instance_bar/table/table_baz

Sub-example 3b

The field does not match the template.

annotation:

 option (google.api.routing) = {
   // Take the <code>table_name</code>, if it's well-formed (with region-based
   // syntax).
   routing_parameters {
     field: "table_name"
     path_template: "{table_name=regions/&#42;&#47;zones/&#42;&#47;&#42;*}"
   }
 };

result:

 <no routing header will be sent>

Sub-example 3c

Multiple alternative conflictingly named path templates are specified. The one that matches is used to construct the header.

annotation:

 option (google.api.routing) = {
   // Take the <code>table_name</code>, if it's well-formed, whether
   // using the region- or projects-based syntax.

   routing_parameters {
     field: "table_name"
     path_template: "{table_name=regions/&#42;&#47;zones/&#42;&#47;&#42;*}"
   }
   routing_parameters {
     field: "table_name"
     path_template: "{table_name=projects/&#42;&#47;instances/&#42;&#47;&#42;*}"
   }
 };

result:

 x-goog-request-params:
 table_name=projects/proj_foo/instances/instance_bar/table/table_baz

Example 4

Extracting a single routing header key-value pair by matching a template syntax on (a part of) a single request field.

annotation:

 option (google.api.routing) = {
   // Take just the project id from the <code>table_name</code> field.
   routing_parameters {
     field: "table_name"
     path_template: "{routing_id=projects/&#42;}/&#42;*"
   }
 };

result:

 x-goog-request-params: routing_id=projects/proj_foo

Example 5

Extracting a single routing header key-value pair by matching several conflictingly named path templates on (parts of) a single request field. The last template to match "wins" the conflict.

annotation:

 option (google.api.routing) = {
   // If the <code>table_name</code> does not have instances information,
   // take just the project id for routing.
   // Otherwise take project + instance.

   routing_parameters {
     field: "table_name"
     path_template: "{routing_id=projects/&#42;}/&#42;*"
   }
   routing_parameters {
     field: "table_name"
     path_template: "{routing_id=projects/&#42;&#47;instances/&#42;}/&#42;*"
   }
 };

result:

 x-goog-request-params:
 routing_id=projects/proj_foo/instances/instance_bar

Example 6

Extracting multiple routing header key-value pairs by matching several non-conflicting path templates on (parts of) a single request field.

Sub-example 6a

Make the templates strict, so that if the table_name does not have an instance information, nothing is sent.

annotation:

 option (google.api.routing) = {
   // The routing code needs two keys instead of one composite
   // but works only for the tables with the "project-instance" name
   // syntax.

   routing_parameters {
     field: "table_name"
     path_template: "{project_id=projects/*}/instances/*/**"
   }
   routing_parameters {
     field: "table_name"
     path_template: "projects/*/{instance_id=instances/*}/**"
   }
 };

result:

 x-goog-request-params:
 project_id=projects/proj_foo&instance_id=instances/instance_bar

Sub-example 6b

Make the templates loose, so that if the table_name does not have an instance information, just the project id part is sent.

annotation:

 option (google.api.routing) = {
   // The routing code wants two keys instead of one composite
   // but will work with just the <code>project_id</code> for tables without
   // an instance in the <code>table_name</code>.

   routing_parameters {
     field: "table_name"
     path_template: "{project_id=projects/&#42;}/&#42;*"
   }
   routing_parameters {
     field: "table_name"
     path_template: "projects/&#42;&#47;{instance_id=instances/&#42;}/&#42;*"
   }
 };

result (is the same as 6a for our example message because it has the instance information):

 x-goog-request-params:
 project_id=projects/proj_foo&instance_id=instances/instance_bar

Example 7

Extracting multiple routing header key-value pairs by matching several path templates on multiple request fields.

NB: note that here there is no way to specify sending nothing if one of the fields does not match its template. E.g. if the table_name is in the wrong format, the project_id will not be sent, but the routing_id will be. The backend routing code has to be aware of that and be prepared to not receive a full complement of keys if it expects multiple.

annotation:

 option (google.api.routing) = {
   // The routing needs both <code>project_id</code> and <code>routing_id</code>
   // (from the <code>app_profile_id</code> field) for routing.

   routing_parameters {
     field: "table_name"
     path_template: "{project_id=projects/&#42;}/&#42;*"
   }
   routing_parameters {
     field: "app_profile_id"
     path_template: "{routing_id=**}"
   }
 };

result:

 x-goog-request-params:
 project_id=projects/proj_foo&routing_id=profiles/prof_qux

Example 8

Extracting a single routing header key-value pair by matching several conflictingly named path templates on several request fields. The last template to match "wins" the conflict.

annotation:

 option (google.api.routing) = {
   // The <code>routing_id</code> can be a project id or a region id depending on
   // the table name format, but only if the <code>app_profile_id</code> is not set.
   // If <code>app_profile_id</code> is set it should be used instead.

   routing_parameters {
     field: "table_name"
     path_template: "{routing_id=projects/&#42;}/&#42;*"
   }
   routing_parameters {
      field: "table_name"
      path_template: "{routing_id=regions/&#42;}/&#42;*"
   }
   routing_parameters {
     field: "app_profile_id"
     path_template: "{routing_id=**}"
   }
 };

result:

 x-goog-request-params: routing_id=profiles/prof_qux

Example 9

Bringing it all together.

annotation:

 option (google.api.routing) = {
   // For routing both <code>table_location</code> and a <code>routing_id</code> are needed.
   //
   // table_location can be either an instance id or a region+zone id.
   //
   // For <code>routing_id</code>, take the value of <code>app_profile_id</code>
   // - If it's in the format <code>profiles/&lt;profile_id&gt;</code>, send
   // just the <code>&lt;profile_id&gt;</code> part.
   // - If it's any other literal, send it as is.
   // If the <code>app_profile_id</code> is empty, and the <code>table_name</code> starts with
   // the project_id, send that instead.

   routing_parameters {
     field: "table_name"
     path_template: "projects/&#42;&#47;{table_location=instances/&#42;}/tables/&#42;"
   }
   routing_parameters {
     field: "table_name"
     path_template: "{table_location=regions/&#42;&#47;zones/&#42;}/tables/&#42;"
   }
   routing_parameters {
     field: "table_name"
     path_template: "{routing_id=projects/&#42;}/&#42;*"
   }
   routing_parameters {
     field: "app_profile_id"
     path_template: "{routing_id=**}"
   }
   routing_parameters {
     field: "app_profile_id"
     path_template: "profiles/{routing_id=*}"
   }
 };

result:

 x-goog-request-params:
 table_location=instances/instance_bar&routing_id=prof_qux

Protobuf type google.api.RoutingRule

Inheritance

Object > AbstractMessageLite<MessageType,BuilderType> > AbstractMessage > GeneratedMessageV3 > RoutingRule

Implements

RoutingRuleOrBuilder

Inherited Members

AbstractMessage.equals(Object)

AbstractMessage.findInitializationErrors()

AbstractMessage.getInitializationErrorString()

AbstractMessage.hashBoolean(boolean)

AbstractMessage.hashCode()

AbstractMessage.hashEnum(Internal.EnumLite)

AbstractMessage.hashEnumList(List<? extends Internal.EnumLite>)

AbstractMessage.hashFields(int,Map<Descriptors.FieldDescriptor,Object>)

AbstractMessage.hashLong(long)

AbstractMessage.toString()

AbstractMessageLite.<T>addAll(Iterable<T>,Collection<? super T>)

AbstractMessageLite.<T>addAll(Iterable<T>,List<? super T>)

AbstractMessageLite.checkByteStringIsUtf8(ByteString)

AbstractMessageLite.toByteArray()

AbstractMessageLite.toByteString()

AbstractMessageLite.writeDelimitedTo(OutputStream)

AbstractMessageLite.writeTo(OutputStream)

com.google.protobuf.GeneratedMessageV3.<ListT>makeMutableCopy(ListT)

com.google.protobuf.GeneratedMessageV3.<ListT>makeMutableCopy(ListT,int)

GeneratedMessageV3.<M>parseDelimitedWithIOException(Parser<M>,InputStream)

GeneratedMessageV3.<M>parseDelimitedWithIOException(Parser<M>,InputStream,ExtensionRegistryLite)

GeneratedMessageV3.<M>parseWithIOException(Parser<M>,CodedInputStream)

GeneratedMessageV3.<M>parseWithIOException(Parser<M>,CodedInputStream,ExtensionRegistryLite)

GeneratedMessageV3.<M>parseWithIOException(Parser<M>,InputStream)

GeneratedMessageV3.<M>parseWithIOException(Parser<M>,InputStream,ExtensionRegistryLite)

com.google.protobuf.GeneratedMessageV3.<T>emptyList(java.lang.Class<T>)

GeneratedMessageV3.<V>serializeBooleanMapTo(CodedOutputStream,MapField<Boolean,V>,MapEntry<Boolean,V>,int)

GeneratedMessageV3.<V>serializeIntegerMapTo(CodedOutputStream,MapField<Integer,V>,MapEntry<Integer,V>,int)

GeneratedMessageV3.<V>serializeLongMapTo(CodedOutputStream,MapField<Long,V>,MapEntry<Long,V>,int)

GeneratedMessageV3.<V>serializeStringMapTo(CodedOutputStream,MapField<String,V>,MapEntry<String,V>,int)

GeneratedMessageV3.canUseUnsafe()

GeneratedMessageV3.computeStringSize(int,Object)

GeneratedMessageV3.computeStringSizeNoTag(Object)

GeneratedMessageV3.emptyBooleanList()

GeneratedMessageV3.emptyDoubleList()

GeneratedMessageV3.emptyFloatList()

GeneratedMessageV3.emptyIntList()

GeneratedMessageV3.emptyLongList()

GeneratedMessageV3.getAllFields()

GeneratedMessageV3.getDescriptorForType()

GeneratedMessageV3.getField(Descriptors.FieldDescriptor)

GeneratedMessageV3.getOneofFieldDescriptor(Descriptors.OneofDescriptor)

GeneratedMessageV3.getParserForType()

GeneratedMessageV3.getRepeatedField(Descriptors.FieldDescriptor,int)

GeneratedMessageV3.getRepeatedFieldCount(Descriptors.FieldDescriptor)

GeneratedMessageV3.getSerializedSize()

GeneratedMessageV3.getUnknownFields()

GeneratedMessageV3.hasField(Descriptors.FieldDescriptor)

GeneratedMessageV3.hasOneof(Descriptors.OneofDescriptor)

GeneratedMessageV3.internalGetFieldAccessorTable()

GeneratedMessageV3.internalGetMapField(int)

com.google.protobuf.GeneratedMessageV3.internalGetMapFieldReflection(int)

GeneratedMessageV3.isInitialized()

GeneratedMessageV3.isStringEmpty(Object)

GeneratedMessageV3.makeExtensionsImmutable()

GeneratedMessageV3.mergeFromAndMakeImmutableInternal(CodedInputStream,ExtensionRegistryLite)

GeneratedMessageV3.mutableCopy(Internal.BooleanList)

GeneratedMessageV3.mutableCopy(Internal.DoubleList)

GeneratedMessageV3.mutableCopy(Internal.FloatList)

GeneratedMessageV3.mutableCopy(Internal.IntList)

GeneratedMessageV3.mutableCopy(Internal.LongList)

GeneratedMessageV3.newBooleanList()

GeneratedMessageV3.newBuilderForType(AbstractMessage.BuilderParent)

GeneratedMessageV3.newBuilderForType(GeneratedMessageV3.BuilderParent)

GeneratedMessageV3.newDoubleList()

GeneratedMessageV3.newFloatList()

GeneratedMessageV3.newInstance(GeneratedMessageV3.UnusedPrivateParameter)

GeneratedMessageV3.newIntList()

GeneratedMessageV3.newLongList()

GeneratedMessageV3.parseUnknownField(CodedInputStream,UnknownFieldSet.Builder,ExtensionRegistryLite,int)

GeneratedMessageV3.parseUnknownFieldProto3(CodedInputStream,UnknownFieldSet.Builder,ExtensionRegistryLite,int)

GeneratedMessageV3.writeReplace()

GeneratedMessageV3.writeString(CodedOutputStream,int,Object)

GeneratedMessageV3.writeStringNoTag(CodedOutputStream,Object)

GeneratedMessageV3.writeTo(CodedOutputStream)

Object.clone()

Object.finalize()

Object.getClass()

Object.notify()

Object.notifyAll()

Object.wait()

Object.wait(long)

Object.wait(long,int)

Static Fields

ROUTING_PARAMETERS_FIELD_NUMBER

public static final int ROUTING_PARAMETERS_FIELD_NUMBER

Field Value
Type	Description
int

Static Methods

getDefaultInstance()

public static RoutingRule getDefaultInstance()

Returns
Type	Description
RoutingRule

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()

Returns
Type	Description
Descriptor

newBuilder()

public static RoutingRule.Builder newBuilder()

Returns
Type	Description
RoutingRule.Builder

newBuilder(RoutingRule prototype)

public static RoutingRule.Builder newBuilder(RoutingRule prototype)

Parameter
Name	Description
prototype	RoutingRule

Returns
Type	Description
RoutingRule.Builder

parseDelimitedFrom(InputStream input)

public static RoutingRule parseDelimitedFrom(InputStream input)

Parameter
Name	Description
input	InputStream

Returns
Type	Description
RoutingRule

Exceptions
Type	Description
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static RoutingRule parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

Parameters
Name	Description
input	InputStream
extensionRegistry	ExtensionRegistryLite

Returns
Type	Description
RoutingRule

Exceptions
Type	Description
IOException

parseFrom(byte[] data)

public static RoutingRule parseFrom(byte[] data)

Parameter
Name	Description
data	byte[]

Returns
Type	Description
RoutingRule

Exceptions
Type	Description
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static RoutingRule parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

Parameters
Name	Description
data	byte[]
extensionRegistry	ExtensionRegistryLite

Returns
Type	Description
RoutingRule

Exceptions
Type	Description
InvalidProtocolBufferException

parseFrom(ByteString data)

public static RoutingRule parseFrom(ByteString data)

Parameter
Name	Description
data	ByteString

Returns
Type	Description
RoutingRule

Exceptions
Type	Description
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static RoutingRule parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

Parameters
Name	Description
data	ByteString
extensionRegistry	ExtensionRegistryLite

Returns
Type	Description
RoutingRule

Exceptions
Type	Description
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static RoutingRule parseFrom(CodedInputStream input)

Parameter
Name	Description
input	CodedInputStream

Returns
Type	Description
RoutingRule

Exceptions
Type	Description
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static RoutingRule parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

Parameters
Name	Description
input	CodedInputStream
extensionRegistry	ExtensionRegistryLite

Returns
Type	Description
RoutingRule

Exceptions
Type	Description
IOException

parseFrom(InputStream input)

public static RoutingRule parseFrom(InputStream input)

Parameter
Name	Description
input	InputStream

Returns
Type	Description
RoutingRule

Exceptions
Type	Description
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static RoutingRule parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

Parameters
Name	Description
input	InputStream
extensionRegistry	ExtensionRegistryLite

Returns
Type	Description
RoutingRule

Exceptions
Type	Description
IOException

parseFrom(ByteBuffer data)

public static RoutingRule parseFrom(ByteBuffer data)

Parameter
Name	Description
data	ByteBuffer

Returns
Type	Description
RoutingRule

Exceptions
Type	Description
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static RoutingRule parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

Parameters
Name	Description
data	ByteBuffer
extensionRegistry	ExtensionRegistryLite

Returns
Type	Description
RoutingRule

Exceptions
Type	Description
InvalidProtocolBufferException

parser()

public static Parser<RoutingRule> parser()

Returns
Type	Description
Parser<RoutingRule>

Methods

equals(Object obj)

public boolean equals(Object obj)

Parameter
Name	Description
obj	Object

Returns
Type	Description
boolean

Overrides

AbstractMessage.equals(Object other)

getDefaultInstanceForType()

public RoutingRule getDefaultInstanceForType()

Returns
Type	Description
RoutingRule

getParserForType()

public Parser<RoutingRule> getParserForType()

Returns
Type	Description
Parser<RoutingRule>

Overrides

GeneratedMessageV3.getParserForType()

getRoutingParameters(int index)

public RoutingParameter getRoutingParameters(int index)

A collection of Routing Parameter specifications. NOTE: If multiple Routing Parameters describe the same key (via the path_template field or via the field field when path_template is not provided), "last one wins" rule determines which Parameter gets used. See the examples for more details.

repeated .google.api.RoutingParameter routing_parameters = 2;

Parameter
Name	Description
index	int

Returns
Type	Description
RoutingParameter

getRoutingParametersCount()

public int getRoutingParametersCount()

A collection of Routing Parameter specifications. NOTE: If multiple Routing Parameters describe the same key (via the path_template field or via the field field when path_template is not provided), "last one wins" rule determines which Parameter gets used. See the examples for more details.

repeated .google.api.RoutingParameter routing_parameters = 2;

Returns
Type	Description
int

getRoutingParametersList()

public List<RoutingParameter> getRoutingParametersList()

A collection of Routing Parameter specifications. NOTE: If multiple Routing Parameters describe the same key (via the path_template field or via the field field when path_template is not provided), "last one wins" rule determines which Parameter gets used. See the examples for more details.

repeated .google.api.RoutingParameter routing_parameters = 2;

Returns
Type	Description
List<RoutingParameter>

getRoutingParametersOrBuilder(int index)

public RoutingParameterOrBuilder getRoutingParametersOrBuilder(int index)

A collection of Routing Parameter specifications. NOTE: If multiple Routing Parameters describe the same key (via the path_template field or via the field field when path_template is not provided), "last one wins" rule determines which Parameter gets used. See the examples for more details.

repeated .google.api.RoutingParameter routing_parameters = 2;

Parameter
Name	Description
index	int

Returns
Type	Description
RoutingParameterOrBuilder

getRoutingParametersOrBuilderList()

public List<? extends RoutingParameterOrBuilder> getRoutingParametersOrBuilderList()

A collection of Routing Parameter specifications. NOTE: If multiple Routing Parameters describe the same key (via the path_template field or via the field field when path_template is not provided), "last one wins" rule determines which Parameter gets used. See the examples for more details.

repeated .google.api.RoutingParameter routing_parameters = 2;

Returns
Type	Description
List<? extends com.google.api.RoutingParameterOrBuilder>

getSerializedSize()

public int getSerializedSize()

Returns
Type	Description
int

Overrides

GeneratedMessageV3.getSerializedSize()

hashCode()

public int hashCode()

Returns
Type	Description
int

Overrides

AbstractMessage.hashCode()

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()

Returns
Type	Description
FieldAccessorTable

Overrides

GeneratedMessageV3.internalGetFieldAccessorTable()

isInitialized()

public final boolean isInitialized()

Returns
Type	Description
boolean

Overrides

GeneratedMessageV3.isInitialized()

newBuilderForType()

public RoutingRule.Builder newBuilderForType()

Returns
Type	Description
RoutingRule.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected RoutingRule.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)

Parameter
Name	Description
parent	BuilderParent

Returns
Type	Description
RoutingRule.Builder

Overrides

GeneratedMessageV3.newBuilderForType(GeneratedMessageV3.BuilderParent parent)

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

Parameter
Name	Description
unused	UnusedPrivateParameter

Returns
Type	Description
Object

Overrides

GeneratedMessageV3.newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

toBuilder()

public RoutingRule.Builder toBuilder()

Returns
Type	Description
RoutingRule.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)

Parameter
Name	Description
output	CodedOutputStream

Overrides

GeneratedMessageV3.writeTo(CodedOutputStream output)

Exceptions
Type	Description
IOException