+ * A projection from an input message to the GRPC or REST header. + *+ * + * Protobuf type {@code google.api.RoutingParameter} + */ +public final class RoutingParameter extends com.google.protobuf.GeneratedMessageV3 + implements + // @@protoc_insertion_point(message_implements:google.api.RoutingParameter) + RoutingParameterOrBuilder { + private static final long serialVersionUID = 0L; + // Use RoutingParameter.newBuilder() to construct. + private RoutingParameter(com.google.protobuf.GeneratedMessageV3.Builder builder) { + super(builder); + } + + private RoutingParameter() { + field_ = ""; + pathTemplate_ = ""; + } + + @java.lang.Override + @SuppressWarnings({"unused"}) + protected java.lang.Object newInstance(UnusedPrivateParameter unused) { + return new RoutingParameter(); + } + + @java.lang.Override + public final com.google.protobuf.UnknownFieldSet getUnknownFields() { + return this.unknownFields; + } + + private RoutingParameter( + com.google.protobuf.CodedInputStream input, + com.google.protobuf.ExtensionRegistryLite extensionRegistry) + throws com.google.protobuf.InvalidProtocolBufferException { + this(); + if (extensionRegistry == null) { + throw new java.lang.NullPointerException(); + } + com.google.protobuf.UnknownFieldSet.Builder unknownFields = + com.google.protobuf.UnknownFieldSet.newBuilder(); + try { + boolean done = false; + while (!done) { + int tag = input.readTag(); + switch (tag) { + case 0: + done = true; + break; + case 10: + { + java.lang.String s = input.readStringRequireUtf8(); + + field_ = s; + break; + } + case 18: + { + java.lang.String s = input.readStringRequireUtf8(); + + pathTemplate_ = s; + break; + } + default: + { + if (!parseUnknownField(input, unknownFields, extensionRegistry, tag)) { + done = true; + } + break; + } + } + } + } catch (com.google.protobuf.InvalidProtocolBufferException e) { + throw e.setUnfinishedMessage(this); + } catch (java.io.IOException e) { + throw new com.google.protobuf.InvalidProtocolBufferException(e).setUnfinishedMessage(this); + } finally { + this.unknownFields = unknownFields.build(); + makeExtensionsImmutable(); + } + } + + public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { + return com.google.api.RoutingProto.internal_static_google_api_RoutingParameter_descriptor; + } + + @java.lang.Override + protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable + internalGetFieldAccessorTable() { + return com.google.api.RoutingProto + .internal_static_google_api_RoutingParameter_fieldAccessorTable + .ensureFieldAccessorsInitialized( + com.google.api.RoutingParameter.class, com.google.api.RoutingParameter.Builder.class); + } + + public static final int FIELD_FIELD_NUMBER = 1; + private volatile java.lang.Object field_; + /** + * + * + *
+ * A request field to extract the header key-value pair from. + *+ * + *
string field = 1;
+ *
+ * @return The field.
+ */
+ @java.lang.Override
+ public java.lang.String getField() {
+ java.lang.Object ref = field_;
+ if (ref instanceof java.lang.String) {
+ return (java.lang.String) ref;
+ } else {
+ com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+ java.lang.String s = bs.toStringUtf8();
+ field_ = s;
+ return s;
+ }
+ }
+ /**
+ *
+ *
+ * + * A request field to extract the header key-value pair from. + *+ * + *
string field = 1;
+ *
+ * @return The bytes for field.
+ */
+ @java.lang.Override
+ public com.google.protobuf.ByteString getFieldBytes() {
+ java.lang.Object ref = field_;
+ if (ref instanceof java.lang.String) {
+ com.google.protobuf.ByteString b =
+ com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+ field_ = b;
+ return b;
+ } else {
+ return (com.google.protobuf.ByteString) ref;
+ }
+ }
+
+ public static final int PATH_TEMPLATE_FIELD_NUMBER = 2;
+ private volatile java.lang.Object pathTemplate_;
+ /**
+ *
+ *
+ *
+ * A pattern matching the key-value field. Optional.
+ * If not specified, the whole field specified in the `field` field will be
+ * taken as value, and its name used as key. If specified, it MUST contain
+ * exactly one named segment (along with any number of unnamed segments) The
+ * pattern will be matched over the field specified in the `field` field, then
+ * if the match is successful:
+ * - the name of the single named segment will be used as a header name,
+ * - the match value of the segment will be used as a header value;
+ * if the match is NOT successful, nothing will be sent.
+ * Example:
+ * -- This is a field in the request message
+ * | that the header value will be extracted from.
+ * |
+ * | -- This is the key name in the
+ * | | routing header.
+ * V |
+ * field: "table_name" v
+ * path_template: "projects/*/{table_location=instances/*}/tables/*"
+ * ^ ^
+ * | |
+ * In the {} brackets is the pattern that -- |
+ * specifies what to extract from the |
+ * field as a value to be sent. |
+ * |
+ * The string in the field must match the whole pattern --
+ * before brackets, inside brackets, after brackets.
+ * When looking at this specific example, we can see that:
+ * - A key-value pair with the key `table_location`
+ * and the value matching `instances/*` should be added
+ * to the x-goog-request-params routing header.
+ * - The value is extracted from the request message's `table_name` field
+ * if it matches the full pattern specified:
+ * `projects/*/instances/*/tables/*`.
+ * **NB:** If the `path_template` field is not provided, the key name is
+ * equal to the field name, and the whole field should be sent as a value.
+ * This makes the pattern for the field and the value functionally equivalent
+ * to `**`, and the configuration
+ * {
+ * field: "table_name"
+ * }
+ * is a functionally equivalent shorthand to:
+ * {
+ * field: "table_name"
+ * path_template: "{table_name=**}"
+ * }
+ * See Example 1 for more details.
+ *
+ *
+ * string path_template = 2;
+ *
+ * @return The pathTemplate.
+ */
+ @java.lang.Override
+ public java.lang.String getPathTemplate() {
+ java.lang.Object ref = pathTemplate_;
+ if (ref instanceof java.lang.String) {
+ return (java.lang.String) ref;
+ } else {
+ com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+ java.lang.String s = bs.toStringUtf8();
+ pathTemplate_ = s;
+ return s;
+ }
+ }
+ /**
+ *
+ *
+ *
+ * A pattern matching the key-value field. Optional.
+ * If not specified, the whole field specified in the `field` field will be
+ * taken as value, and its name used as key. If specified, it MUST contain
+ * exactly one named segment (along with any number of unnamed segments) The
+ * pattern will be matched over the field specified in the `field` field, then
+ * if the match is successful:
+ * - the name of the single named segment will be used as a header name,
+ * - the match value of the segment will be used as a header value;
+ * if the match is NOT successful, nothing will be sent.
+ * Example:
+ * -- This is a field in the request message
+ * | that the header value will be extracted from.
+ * |
+ * | -- This is the key name in the
+ * | | routing header.
+ * V |
+ * field: "table_name" v
+ * path_template: "projects/*/{table_location=instances/*}/tables/*"
+ * ^ ^
+ * | |
+ * In the {} brackets is the pattern that -- |
+ * specifies what to extract from the |
+ * field as a value to be sent. |
+ * |
+ * The string in the field must match the whole pattern --
+ * before brackets, inside brackets, after brackets.
+ * When looking at this specific example, we can see that:
+ * - A key-value pair with the key `table_location`
+ * and the value matching `instances/*` should be added
+ * to the x-goog-request-params routing header.
+ * - The value is extracted from the request message's `table_name` field
+ * if it matches the full pattern specified:
+ * `projects/*/instances/*/tables/*`.
+ * **NB:** If the `path_template` field is not provided, the key name is
+ * equal to the field name, and the whole field should be sent as a value.
+ * This makes the pattern for the field and the value functionally equivalent
+ * to `**`, and the configuration
+ * {
+ * field: "table_name"
+ * }
+ * is a functionally equivalent shorthand to:
+ * {
+ * field: "table_name"
+ * path_template: "{table_name=**}"
+ * }
+ * See Example 1 for more details.
+ *
+ *
+ * string path_template = 2;
+ *
+ * @return The bytes for pathTemplate.
+ */
+ @java.lang.Override
+ public com.google.protobuf.ByteString getPathTemplateBytes() {
+ java.lang.Object ref = pathTemplate_;
+ if (ref instanceof java.lang.String) {
+ com.google.protobuf.ByteString b =
+ com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+ pathTemplate_ = b;
+ return b;
+ } else {
+ return (com.google.protobuf.ByteString) ref;
+ }
+ }
+
+ private byte memoizedIsInitialized = -1;
+
+ @java.lang.Override
+ public final boolean isInitialized() {
+ byte isInitialized = memoizedIsInitialized;
+ if (isInitialized == 1) return true;
+ if (isInitialized == 0) return false;
+
+ memoizedIsInitialized = 1;
+ return true;
+ }
+
+ @java.lang.Override
+ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
+ if (!getFieldBytes().isEmpty()) {
+ com.google.protobuf.GeneratedMessageV3.writeString(output, 1, field_);
+ }
+ if (!getPathTemplateBytes().isEmpty()) {
+ com.google.protobuf.GeneratedMessageV3.writeString(output, 2, pathTemplate_);
+ }
+ unknownFields.writeTo(output);
+ }
+
+ @java.lang.Override
+ public int getSerializedSize() {
+ int size = memoizedSize;
+ if (size != -1) return size;
+
+ size = 0;
+ if (!getFieldBytes().isEmpty()) {
+ size += com.google.protobuf.GeneratedMessageV3.computeStringSize(1, field_);
+ }
+ if (!getPathTemplateBytes().isEmpty()) {
+ size += com.google.protobuf.GeneratedMessageV3.computeStringSize(2, pathTemplate_);
+ }
+ size += unknownFields.getSerializedSize();
+ memoizedSize = size;
+ return size;
+ }
+
+ @java.lang.Override
+ public boolean equals(final java.lang.Object obj) {
+ if (obj == this) {
+ return true;
+ }
+ if (!(obj instanceof com.google.api.RoutingParameter)) {
+ return super.equals(obj);
+ }
+ com.google.api.RoutingParameter other = (com.google.api.RoutingParameter) obj;
+
+ if (!getField().equals(other.getField())) return false;
+ if (!getPathTemplate().equals(other.getPathTemplate())) return false;
+ if (!unknownFields.equals(other.unknownFields)) return false;
+ return true;
+ }
+
+ @java.lang.Override
+ public int hashCode() {
+ if (memoizedHashCode != 0) {
+ return memoizedHashCode;
+ }
+ int hash = 41;
+ hash = (19 * hash) + getDescriptor().hashCode();
+ hash = (37 * hash) + FIELD_FIELD_NUMBER;
+ hash = (53 * hash) + getField().hashCode();
+ hash = (37 * hash) + PATH_TEMPLATE_FIELD_NUMBER;
+ hash = (53 * hash) + getPathTemplate().hashCode();
+ hash = (29 * hash) + unknownFields.hashCode();
+ memoizedHashCode = hash;
+ return hash;
+ }
+
+ public static com.google.api.RoutingParameter parseFrom(java.nio.ByteBuffer data)
+ throws com.google.protobuf.InvalidProtocolBufferException {
+ return PARSER.parseFrom(data);
+ }
+
+ public static com.google.api.RoutingParameter parseFrom(
+ java.nio.ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+ throws com.google.protobuf.InvalidProtocolBufferException {
+ return PARSER.parseFrom(data, extensionRegistry);
+ }
+
+ public static com.google.api.RoutingParameter parseFrom(com.google.protobuf.ByteString data)
+ throws com.google.protobuf.InvalidProtocolBufferException {
+ return PARSER.parseFrom(data);
+ }
+
+ public static com.google.api.RoutingParameter parseFrom(
+ com.google.protobuf.ByteString data,
+ com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+ throws com.google.protobuf.InvalidProtocolBufferException {
+ return PARSER.parseFrom(data, extensionRegistry);
+ }
+
+ public static com.google.api.RoutingParameter parseFrom(byte[] data)
+ throws com.google.protobuf.InvalidProtocolBufferException {
+ return PARSER.parseFrom(data);
+ }
+
+ public static com.google.api.RoutingParameter parseFrom(
+ byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+ throws com.google.protobuf.InvalidProtocolBufferException {
+ return PARSER.parseFrom(data, extensionRegistry);
+ }
+
+ public static com.google.api.RoutingParameter parseFrom(java.io.InputStream input)
+ throws java.io.IOException {
+ return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+ }
+
+ public static com.google.api.RoutingParameter parseFrom(
+ java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+ throws java.io.IOException {
+ return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+ PARSER, input, extensionRegistry);
+ }
+
+ public static com.google.api.RoutingParameter parseDelimitedFrom(java.io.InputStream input)
+ throws java.io.IOException {
+ return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(PARSER, input);
+ }
+
+ public static com.google.api.RoutingParameter parseDelimitedFrom(
+ java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+ throws java.io.IOException {
+ return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(
+ PARSER, input, extensionRegistry);
+ }
+
+ public static com.google.api.RoutingParameter parseFrom(
+ com.google.protobuf.CodedInputStream input) throws java.io.IOException {
+ return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+ }
+
+ public static com.google.api.RoutingParameter parseFrom(
+ com.google.protobuf.CodedInputStream input,
+ com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+ throws java.io.IOException {
+ return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+ PARSER, input, extensionRegistry);
+ }
+
+ @java.lang.Override
+ public Builder newBuilderForType() {
+ return newBuilder();
+ }
+
+ public static Builder newBuilder() {
+ return DEFAULT_INSTANCE.toBuilder();
+ }
+
+ public static Builder newBuilder(com.google.api.RoutingParameter prototype) {
+ return DEFAULT_INSTANCE.toBuilder().mergeFrom(prototype);
+ }
+
+ @java.lang.Override
+ public Builder toBuilder() {
+ return this == DEFAULT_INSTANCE ? new Builder() : new Builder().mergeFrom(this);
+ }
+
+ @java.lang.Override
+ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+ Builder builder = new Builder(parent);
+ return builder;
+ }
+ /**
+ *
+ *
+ * + * A projection from an input message to the GRPC or REST header. + *+ * + * Protobuf type {@code google.api.RoutingParameter} + */ + public static final class Builder extends com.google.protobuf.GeneratedMessageV3.Builder
+ * A request field to extract the header key-value pair from. + *+ * + *
string field = 1;
+ *
+ * @return The field.
+ */
+ public java.lang.String getField() {
+ java.lang.Object ref = field_;
+ if (!(ref instanceof java.lang.String)) {
+ com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+ java.lang.String s = bs.toStringUtf8();
+ field_ = s;
+ return s;
+ } else {
+ return (java.lang.String) ref;
+ }
+ }
+ /**
+ *
+ *
+ * + * A request field to extract the header key-value pair from. + *+ * + *
string field = 1;
+ *
+ * @return The bytes for field.
+ */
+ public com.google.protobuf.ByteString getFieldBytes() {
+ java.lang.Object ref = field_;
+ if (ref instanceof String) {
+ com.google.protobuf.ByteString b =
+ com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+ field_ = b;
+ return b;
+ } else {
+ return (com.google.protobuf.ByteString) ref;
+ }
+ }
+ /**
+ *
+ *
+ * + * A request field to extract the header key-value pair from. + *+ * + *
string field = 1;
+ *
+ * @param value The field to set.
+ * @return This builder for chaining.
+ */
+ public Builder setField(java.lang.String value) {
+ if (value == null) {
+ throw new NullPointerException();
+ }
+
+ field_ = value;
+ onChanged();
+ return this;
+ }
+ /**
+ *
+ *
+ * + * A request field to extract the header key-value pair from. + *+ * + *
string field = 1;
+ *
+ * @return This builder for chaining.
+ */
+ public Builder clearField() {
+
+ field_ = getDefaultInstance().getField();
+ onChanged();
+ return this;
+ }
+ /**
+ *
+ *
+ * + * A request field to extract the header key-value pair from. + *+ * + *
string field = 1;
+ *
+ * @param value The bytes for field to set.
+ * @return This builder for chaining.
+ */
+ public Builder setFieldBytes(com.google.protobuf.ByteString value) {
+ if (value == null) {
+ throw new NullPointerException();
+ }
+ checkByteStringIsUtf8(value);
+
+ field_ = value;
+ onChanged();
+ return this;
+ }
+
+ private java.lang.Object pathTemplate_ = "";
+ /**
+ *
+ *
+ *
+ * A pattern matching the key-value field. Optional.
+ * If not specified, the whole field specified in the `field` field will be
+ * taken as value, and its name used as key. If specified, it MUST contain
+ * exactly one named segment (along with any number of unnamed segments) The
+ * pattern will be matched over the field specified in the `field` field, then
+ * if the match is successful:
+ * - the name of the single named segment will be used as a header name,
+ * - the match value of the segment will be used as a header value;
+ * if the match is NOT successful, nothing will be sent.
+ * Example:
+ * -- This is a field in the request message
+ * | that the header value will be extracted from.
+ * |
+ * | -- This is the key name in the
+ * | | routing header.
+ * V |
+ * field: "table_name" v
+ * path_template: "projects/*/{table_location=instances/*}/tables/*"
+ * ^ ^
+ * | |
+ * In the {} brackets is the pattern that -- |
+ * specifies what to extract from the |
+ * field as a value to be sent. |
+ * |
+ * The string in the field must match the whole pattern --
+ * before brackets, inside brackets, after brackets.
+ * When looking at this specific example, we can see that:
+ * - A key-value pair with the key `table_location`
+ * and the value matching `instances/*` should be added
+ * to the x-goog-request-params routing header.
+ * - The value is extracted from the request message's `table_name` field
+ * if it matches the full pattern specified:
+ * `projects/*/instances/*/tables/*`.
+ * **NB:** If the `path_template` field is not provided, the key name is
+ * equal to the field name, and the whole field should be sent as a value.
+ * This makes the pattern for the field and the value functionally equivalent
+ * to `**`, and the configuration
+ * {
+ * field: "table_name"
+ * }
+ * is a functionally equivalent shorthand to:
+ * {
+ * field: "table_name"
+ * path_template: "{table_name=**}"
+ * }
+ * See Example 1 for more details.
+ *
+ *
+ * string path_template = 2;
+ *
+ * @return The pathTemplate.
+ */
+ public java.lang.String getPathTemplate() {
+ java.lang.Object ref = pathTemplate_;
+ if (!(ref instanceof java.lang.String)) {
+ com.google.protobuf.ByteString bs = (com.google.protobuf.ByteString) ref;
+ java.lang.String s = bs.toStringUtf8();
+ pathTemplate_ = s;
+ return s;
+ } else {
+ return (java.lang.String) ref;
+ }
+ }
+ /**
+ *
+ *
+ *
+ * A pattern matching the key-value field. Optional.
+ * If not specified, the whole field specified in the `field` field will be
+ * taken as value, and its name used as key. If specified, it MUST contain
+ * exactly one named segment (along with any number of unnamed segments) The
+ * pattern will be matched over the field specified in the `field` field, then
+ * if the match is successful:
+ * - the name of the single named segment will be used as a header name,
+ * - the match value of the segment will be used as a header value;
+ * if the match is NOT successful, nothing will be sent.
+ * Example:
+ * -- This is a field in the request message
+ * | that the header value will be extracted from.
+ * |
+ * | -- This is the key name in the
+ * | | routing header.
+ * V |
+ * field: "table_name" v
+ * path_template: "projects/*/{table_location=instances/*}/tables/*"
+ * ^ ^
+ * | |
+ * In the {} brackets is the pattern that -- |
+ * specifies what to extract from the |
+ * field as a value to be sent. |
+ * |
+ * The string in the field must match the whole pattern --
+ * before brackets, inside brackets, after brackets.
+ * When looking at this specific example, we can see that:
+ * - A key-value pair with the key `table_location`
+ * and the value matching `instances/*` should be added
+ * to the x-goog-request-params routing header.
+ * - The value is extracted from the request message's `table_name` field
+ * if it matches the full pattern specified:
+ * `projects/*/instances/*/tables/*`.
+ * **NB:** If the `path_template` field is not provided, the key name is
+ * equal to the field name, and the whole field should be sent as a value.
+ * This makes the pattern for the field and the value functionally equivalent
+ * to `**`, and the configuration
+ * {
+ * field: "table_name"
+ * }
+ * is a functionally equivalent shorthand to:
+ * {
+ * field: "table_name"
+ * path_template: "{table_name=**}"
+ * }
+ * See Example 1 for more details.
+ *
+ *
+ * string path_template = 2;
+ *
+ * @return The bytes for pathTemplate.
+ */
+ public com.google.protobuf.ByteString getPathTemplateBytes() {
+ java.lang.Object ref = pathTemplate_;
+ if (ref instanceof String) {
+ com.google.protobuf.ByteString b =
+ com.google.protobuf.ByteString.copyFromUtf8((java.lang.String) ref);
+ pathTemplate_ = b;
+ return b;
+ } else {
+ return (com.google.protobuf.ByteString) ref;
+ }
+ }
+ /**
+ *
+ *
+ *
+ * A pattern matching the key-value field. Optional.
+ * If not specified, the whole field specified in the `field` field will be
+ * taken as value, and its name used as key. If specified, it MUST contain
+ * exactly one named segment (along with any number of unnamed segments) The
+ * pattern will be matched over the field specified in the `field` field, then
+ * if the match is successful:
+ * - the name of the single named segment will be used as a header name,
+ * - the match value of the segment will be used as a header value;
+ * if the match is NOT successful, nothing will be sent.
+ * Example:
+ * -- This is a field in the request message
+ * | that the header value will be extracted from.
+ * |
+ * | -- This is the key name in the
+ * | | routing header.
+ * V |
+ * field: "table_name" v
+ * path_template: "projects/*/{table_location=instances/*}/tables/*"
+ * ^ ^
+ * | |
+ * In the {} brackets is the pattern that -- |
+ * specifies what to extract from the |
+ * field as a value to be sent. |
+ * |
+ * The string in the field must match the whole pattern --
+ * before brackets, inside brackets, after brackets.
+ * When looking at this specific example, we can see that:
+ * - A key-value pair with the key `table_location`
+ * and the value matching `instances/*` should be added
+ * to the x-goog-request-params routing header.
+ * - The value is extracted from the request message's `table_name` field
+ * if it matches the full pattern specified:
+ * `projects/*/instances/*/tables/*`.
+ * **NB:** If the `path_template` field is not provided, the key name is
+ * equal to the field name, and the whole field should be sent as a value.
+ * This makes the pattern for the field and the value functionally equivalent
+ * to `**`, and the configuration
+ * {
+ * field: "table_name"
+ * }
+ * is a functionally equivalent shorthand to:
+ * {
+ * field: "table_name"
+ * path_template: "{table_name=**}"
+ * }
+ * See Example 1 for more details.
+ *
+ *
+ * string path_template = 2;
+ *
+ * @param value The pathTemplate to set.
+ * @return This builder for chaining.
+ */
+ public Builder setPathTemplate(java.lang.String value) {
+ if (value == null) {
+ throw new NullPointerException();
+ }
+
+ pathTemplate_ = value;
+ onChanged();
+ return this;
+ }
+ /**
+ *
+ *
+ *
+ * A pattern matching the key-value field. Optional.
+ * If not specified, the whole field specified in the `field` field will be
+ * taken as value, and its name used as key. If specified, it MUST contain
+ * exactly one named segment (along with any number of unnamed segments) The
+ * pattern will be matched over the field specified in the `field` field, then
+ * if the match is successful:
+ * - the name of the single named segment will be used as a header name,
+ * - the match value of the segment will be used as a header value;
+ * if the match is NOT successful, nothing will be sent.
+ * Example:
+ * -- This is a field in the request message
+ * | that the header value will be extracted from.
+ * |
+ * | -- This is the key name in the
+ * | | routing header.
+ * V |
+ * field: "table_name" v
+ * path_template: "projects/*/{table_location=instances/*}/tables/*"
+ * ^ ^
+ * | |
+ * In the {} brackets is the pattern that -- |
+ * specifies what to extract from the |
+ * field as a value to be sent. |
+ * |
+ * The string in the field must match the whole pattern --
+ * before brackets, inside brackets, after brackets.
+ * When looking at this specific example, we can see that:
+ * - A key-value pair with the key `table_location`
+ * and the value matching `instances/*` should be added
+ * to the x-goog-request-params routing header.
+ * - The value is extracted from the request message's `table_name` field
+ * if it matches the full pattern specified:
+ * `projects/*/instances/*/tables/*`.
+ * **NB:** If the `path_template` field is not provided, the key name is
+ * equal to the field name, and the whole field should be sent as a value.
+ * This makes the pattern for the field and the value functionally equivalent
+ * to `**`, and the configuration
+ * {
+ * field: "table_name"
+ * }
+ * is a functionally equivalent shorthand to:
+ * {
+ * field: "table_name"
+ * path_template: "{table_name=**}"
+ * }
+ * See Example 1 for more details.
+ *
+ *
+ * string path_template = 2;
+ *
+ * @return This builder for chaining.
+ */
+ public Builder clearPathTemplate() {
+
+ pathTemplate_ = getDefaultInstance().getPathTemplate();
+ onChanged();
+ return this;
+ }
+ /**
+ *
+ *
+ *
+ * A pattern matching the key-value field. Optional.
+ * If not specified, the whole field specified in the `field` field will be
+ * taken as value, and its name used as key. If specified, it MUST contain
+ * exactly one named segment (along with any number of unnamed segments) The
+ * pattern will be matched over the field specified in the `field` field, then
+ * if the match is successful:
+ * - the name of the single named segment will be used as a header name,
+ * - the match value of the segment will be used as a header value;
+ * if the match is NOT successful, nothing will be sent.
+ * Example:
+ * -- This is a field in the request message
+ * | that the header value will be extracted from.
+ * |
+ * | -- This is the key name in the
+ * | | routing header.
+ * V |
+ * field: "table_name" v
+ * path_template: "projects/*/{table_location=instances/*}/tables/*"
+ * ^ ^
+ * | |
+ * In the {} brackets is the pattern that -- |
+ * specifies what to extract from the |
+ * field as a value to be sent. |
+ * |
+ * The string in the field must match the whole pattern --
+ * before brackets, inside brackets, after brackets.
+ * When looking at this specific example, we can see that:
+ * - A key-value pair with the key `table_location`
+ * and the value matching `instances/*` should be added
+ * to the x-goog-request-params routing header.
+ * - The value is extracted from the request message's `table_name` field
+ * if it matches the full pattern specified:
+ * `projects/*/instances/*/tables/*`.
+ * **NB:** If the `path_template` field is not provided, the key name is
+ * equal to the field name, and the whole field should be sent as a value.
+ * This makes the pattern for the field and the value functionally equivalent
+ * to `**`, and the configuration
+ * {
+ * field: "table_name"
+ * }
+ * is a functionally equivalent shorthand to:
+ * {
+ * field: "table_name"
+ * path_template: "{table_name=**}"
+ * }
+ * See Example 1 for more details.
+ *
+ *
+ * string path_template = 2;
+ *
+ * @param value The bytes for pathTemplate to set.
+ * @return This builder for chaining.
+ */
+ public Builder setPathTemplateBytes(com.google.protobuf.ByteString value) {
+ if (value == null) {
+ throw new NullPointerException();
+ }
+ checkByteStringIsUtf8(value);
+
+ pathTemplate_ = value;
+ onChanged();
+ return this;
+ }
+
+ @java.lang.Override
+ public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
+ return super.setUnknownFields(unknownFields);
+ }
+
+ @java.lang.Override
+ public final Builder mergeUnknownFields(
+ final com.google.protobuf.UnknownFieldSet unknownFields) {
+ return super.mergeUnknownFields(unknownFields);
+ }
+
+ // @@protoc_insertion_point(builder_scope:google.api.RoutingParameter)
+ }
+
+ // @@protoc_insertion_point(class_scope:google.api.RoutingParameter)
+ private static final com.google.api.RoutingParameter DEFAULT_INSTANCE;
+
+ static {
+ DEFAULT_INSTANCE = new com.google.api.RoutingParameter();
+ }
+
+ public static com.google.api.RoutingParameter getDefaultInstance() {
+ return DEFAULT_INSTANCE;
+ }
+
+ private static final com.google.protobuf.Parser+ * A request field to extract the header key-value pair from. + *+ * + *
string field = 1;
+ *
+ * @return The field.
+ */
+ java.lang.String getField();
+ /**
+ *
+ *
+ * + * A request field to extract the header key-value pair from. + *+ * + *
string field = 1;
+ *
+ * @return The bytes for field.
+ */
+ com.google.protobuf.ByteString getFieldBytes();
+
+ /**
+ *
+ *
+ *
+ * A pattern matching the key-value field. Optional.
+ * If not specified, the whole field specified in the `field` field will be
+ * taken as value, and its name used as key. If specified, it MUST contain
+ * exactly one named segment (along with any number of unnamed segments) The
+ * pattern will be matched over the field specified in the `field` field, then
+ * if the match is successful:
+ * - the name of the single named segment will be used as a header name,
+ * - the match value of the segment will be used as a header value;
+ * if the match is NOT successful, nothing will be sent.
+ * Example:
+ * -- This is a field in the request message
+ * | that the header value will be extracted from.
+ * |
+ * | -- This is the key name in the
+ * | | routing header.
+ * V |
+ * field: "table_name" v
+ * path_template: "projects/*/{table_location=instances/*}/tables/*"
+ * ^ ^
+ * | |
+ * In the {} brackets is the pattern that -- |
+ * specifies what to extract from the |
+ * field as a value to be sent. |
+ * |
+ * The string in the field must match the whole pattern --
+ * before brackets, inside brackets, after brackets.
+ * When looking at this specific example, we can see that:
+ * - A key-value pair with the key `table_location`
+ * and the value matching `instances/*` should be added
+ * to the x-goog-request-params routing header.
+ * - The value is extracted from the request message's `table_name` field
+ * if it matches the full pattern specified:
+ * `projects/*/instances/*/tables/*`.
+ * **NB:** If the `path_template` field is not provided, the key name is
+ * equal to the field name, and the whole field should be sent as a value.
+ * This makes the pattern for the field and the value functionally equivalent
+ * to `**`, and the configuration
+ * {
+ * field: "table_name"
+ * }
+ * is a functionally equivalent shorthand to:
+ * {
+ * field: "table_name"
+ * path_template: "{table_name=**}"
+ * }
+ * See Example 1 for more details.
+ *
+ *
+ * string path_template = 2;
+ *
+ * @return The pathTemplate.
+ */
+ java.lang.String getPathTemplate();
+ /**
+ *
+ *
+ *
+ * A pattern matching the key-value field. Optional.
+ * If not specified, the whole field specified in the `field` field will be
+ * taken as value, and its name used as key. If specified, it MUST contain
+ * exactly one named segment (along with any number of unnamed segments) The
+ * pattern will be matched over the field specified in the `field` field, then
+ * if the match is successful:
+ * - the name of the single named segment will be used as a header name,
+ * - the match value of the segment will be used as a header value;
+ * if the match is NOT successful, nothing will be sent.
+ * Example:
+ * -- This is a field in the request message
+ * | that the header value will be extracted from.
+ * |
+ * | -- This is the key name in the
+ * | | routing header.
+ * V |
+ * field: "table_name" v
+ * path_template: "projects/*/{table_location=instances/*}/tables/*"
+ * ^ ^
+ * | |
+ * In the {} brackets is the pattern that -- |
+ * specifies what to extract from the |
+ * field as a value to be sent. |
+ * |
+ * The string in the field must match the whole pattern --
+ * before brackets, inside brackets, after brackets.
+ * When looking at this specific example, we can see that:
+ * - A key-value pair with the key `table_location`
+ * and the value matching `instances/*` should be added
+ * to the x-goog-request-params routing header.
+ * - The value is extracted from the request message's `table_name` field
+ * if it matches the full pattern specified:
+ * `projects/*/instances/*/tables/*`.
+ * **NB:** If the `path_template` field is not provided, the key name is
+ * equal to the field name, and the whole field should be sent as a value.
+ * This makes the pattern for the field and the value functionally equivalent
+ * to `**`, and the configuration
+ * {
+ * field: "table_name"
+ * }
+ * is a functionally equivalent shorthand to:
+ * {
+ * field: "table_name"
+ * path_template: "{table_name=**}"
+ * }
+ * See Example 1 for more details.
+ *
+ *
+ * string path_template = 2;
+ *
+ * @return The bytes for pathTemplate.
+ */
+ com.google.protobuf.ByteString getPathTemplateBytes();
+}
diff --git a/proto-google-common-protos/src/main/java/com/google/api/RoutingProto.java b/proto-google-common-protos/src/main/java/com/google/api/RoutingProto.java
new file mode 100644
index 00000000..31189bf5
--- /dev/null
+++ b/proto-google-common-protos/src/main/java/com/google/api/RoutingProto.java
@@ -0,0 +1,102 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler. DO NOT EDIT!
+// source: google/api/routing.proto
+
+package com.google.api;
+
+public final class RoutingProto {
+ private RoutingProto() {}
+
+ public static void registerAllExtensions(com.google.protobuf.ExtensionRegistryLite registry) {
+ registry.add(com.google.api.RoutingProto.routing);
+ }
+
+ public static void registerAllExtensions(com.google.protobuf.ExtensionRegistry registry) {
+ registerAllExtensions((com.google.protobuf.ExtensionRegistryLite) registry);
+ }
+
+ public static final int ROUTING_FIELD_NUMBER = 72295729;
+ /**
+ *
+ *
+ * + * See RoutingRule. + *+ * + *
extend .google.protobuf.MethodOptions { ... }
+ */
+ public static final com.google.protobuf.GeneratedMessage.GeneratedExtension<
+ com.google.protobuf.DescriptorProtos.MethodOptions, com.google.api.RoutingRule>
+ routing =
+ com.google.protobuf.GeneratedMessage.newFileScopedGeneratedExtension(
+ com.google.api.RoutingRule.class, com.google.api.RoutingRule.getDefaultInstance());
+
+ static final com.google.protobuf.Descriptors.Descriptor
+ internal_static_google_api_RoutingRule_descriptor;
+ static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+ internal_static_google_api_RoutingRule_fieldAccessorTable;
+ static final com.google.protobuf.Descriptors.Descriptor
+ internal_static_google_api_RoutingParameter_descriptor;
+ static final com.google.protobuf.GeneratedMessageV3.FieldAccessorTable
+ internal_static_google_api_RoutingParameter_fieldAccessorTable;
+
+ public static com.google.protobuf.Descriptors.FileDescriptor getDescriptor() {
+ return descriptor;
+ }
+
+ private static com.google.protobuf.Descriptors.FileDescriptor descriptor;
+
+ static {
+ java.lang.String[] descriptorData = {
+ "\n\030google/api/routing.proto\022\ngoogle.api\032 "
+ + "google/protobuf/descriptor.proto\"G\n\013Rout"
+ + "ingRule\0228\n\022routing_parameters\030\002 \003(\0132\034.go"
+ + "ogle.api.RoutingParameter\"8\n\020RoutingPara"
+ + "meter\022\r\n\005field\030\001 \001(\t\022\025\n\rpath_template\030\002 "
+ + "\001(\t:K\n\007routing\022\036.google.protobuf.MethodO"
+ + "ptions\030\261\312\274\" \001(\0132\027.google.api.RoutingRule"
+ + "Bj\n\016com.google.apiB\014RoutingProtoP\001ZAgoog"
+ + "le.golang.org/genproto/googleapis/api/an"
+ + "notations;annotations\242\002\004GAPIb\006proto3"
+ };
+ descriptor =
+ com.google.protobuf.Descriptors.FileDescriptor.internalBuildGeneratedFileFrom(
+ descriptorData,
+ new com.google.protobuf.Descriptors.FileDescriptor[] {
+ com.google.protobuf.DescriptorProtos.getDescriptor(),
+ });
+ internal_static_google_api_RoutingRule_descriptor = getDescriptor().getMessageTypes().get(0);
+ internal_static_google_api_RoutingRule_fieldAccessorTable =
+ new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
+ internal_static_google_api_RoutingRule_descriptor,
+ new java.lang.String[] {
+ "RoutingParameters",
+ });
+ internal_static_google_api_RoutingParameter_descriptor =
+ getDescriptor().getMessageTypes().get(1);
+ internal_static_google_api_RoutingParameter_fieldAccessorTable =
+ new com.google.protobuf.GeneratedMessageV3.FieldAccessorTable(
+ internal_static_google_api_RoutingParameter_descriptor,
+ new java.lang.String[] {
+ "Field", "PathTemplate",
+ });
+ routing.internalInit(descriptor.getExtensions().get(0));
+ com.google.protobuf.DescriptorProtos.getDescriptor();
+ }
+
+ // @@protoc_insertion_point(outer_class_scope)
+}
diff --git a/proto-google-common-protos/src/main/java/com/google/api/RoutingRule.java b/proto-google-common-protos/src/main/java/com/google/api/RoutingRule.java
new file mode 100644
index 00000000..08e1e223
--- /dev/null
+++ b/proto-google-common-protos/src/main/java/com/google/api/RoutingRule.java
@@ -0,0 +1,1588 @@
+/*
+ * Copyright 2020 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Generated by the protocol buffer compiler. DO NOT EDIT!
+// source: google/api/routing.proto
+
+package com.google.api;
+
+/**
+ *
+ *
+ *
+ * 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:
+ * // - `projects/<project>/tables/<table>`
+ * // - `projects/<project>/instances/<instance>/tables/<table>`
+ * // - `region/<region>/zones/<zone>/tables/<table>`
+ * string table_name = 1;
+ * // This value specifies routing for replication.
+ * // It can be in the following formats:
+ * // - `profiles/<profile_id>`
+ * // - a legacy `profile_id` 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 `app_profile_id`.
+ * 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 `app_profile_id`, but name it `routing_id` 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 `table_name`, if it's well-formed (with project-based
+ * // syntax).
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{table_name=projects/*/instances/*/**}"
+ * }
+ * };
+ * 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 `table_name`, if it's well-formed (with region-based
+ * // syntax).
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{table_name=regions/*/zones/*/**}"
+ * }
+ * };
+ * 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 `table_name`, if it's well-formed, whether
+ * // using the region- or projects-based syntax.
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{table_name=regions/*/zones/*/**}"
+ * }
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{table_name=projects/*/instances/*/**}"
+ * }
+ * };
+ * 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 `table_name` field.
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{routing_id=projects/*}/**"
+ * }
+ * };
+ * 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 `table_name` 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/*}/**"
+ * }
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{routing_id=projects/*/instances/*}/**"
+ * }
+ * };
+ * 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 `project_id` for tables without
+ * // an instance in the `table_name`.
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{project_id=projects/*}/**"
+ * }
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "projects/*/{instance_id=instances/*}/**"
+ * }
+ * };
+ * 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 `project_id` and `routing_id`
+ * // (from the `app_profile_id` field) for routing.
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{project_id=projects/*}/**"
+ * }
+ * 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 `routing_id` can be a project id or a region id depending on
+ * // the table name format, but only if the `app_profile_id` is not set.
+ * // If `app_profile_id` is set it should be used instead.
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{routing_id=projects/*}/**"
+ * }
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{routing_id=regions/*}/**"
+ * }
+ * 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 `table_location` and a `routing_id` are needed.
+ * //
+ * // table_location can be either an instance id or a region+zone id.
+ * //
+ * // For `routing_id`, take the value of `app_profile_id`
+ * // - If it's in the format `profiles/<profile_id>`, send
+ * // just the `<profile_id>` part.
+ * // - If it's any other literal, send it as is.
+ * // If the `app_profile_id` is empty, and the `table_name` starts with
+ * // the project_id, send that instead.
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "projects/*/{table_location=instances/*}/tables/*"
+ * }
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{table_location=regions/*/zones/*}/tables/*"
+ * }
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{routing_id=projects/*}/**"
+ * }
+ * 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 {@code google.api.RoutingRule}
+ */
+public final class RoutingRule extends com.google.protobuf.GeneratedMessageV3
+ implements
+ // @@protoc_insertion_point(message_implements:google.api.RoutingRule)
+ RoutingRuleOrBuilder {
+ private static final long serialVersionUID = 0L;
+ // Use RoutingRule.newBuilder() to construct.
+ private RoutingRule(com.google.protobuf.GeneratedMessageV3.Builder builder) {
+ super(builder);
+ }
+
+ private RoutingRule() {
+ routingParameters_ = java.util.Collections.emptyList();
+ }
+
+ @java.lang.Override
+ @SuppressWarnings({"unused"})
+ protected java.lang.Object newInstance(UnusedPrivateParameter unused) {
+ return new RoutingRule();
+ }
+
+ @java.lang.Override
+ public final com.google.protobuf.UnknownFieldSet getUnknownFields() {
+ return this.unknownFields;
+ }
+
+ private RoutingRule(
+ com.google.protobuf.CodedInputStream input,
+ com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+ throws com.google.protobuf.InvalidProtocolBufferException {
+ this();
+ if (extensionRegistry == null) {
+ throw new java.lang.NullPointerException();
+ }
+ int mutable_bitField0_ = 0;
+ com.google.protobuf.UnknownFieldSet.Builder unknownFields =
+ com.google.protobuf.UnknownFieldSet.newBuilder();
+ try {
+ boolean done = false;
+ while (!done) {
+ int tag = input.readTag();
+ switch (tag) {
+ case 0:
+ done = true;
+ break;
+ case 18:
+ {
+ if (!((mutable_bitField0_ & 0x00000001) != 0)) {
+ routingParameters_ = new java.util.ArrayList+ * 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;
+ */
+ @java.lang.Override
+ public java.util.List+ * 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;
+ */
+ @java.lang.Override
+ public java.util.List
+ getRoutingParametersOrBuilderList() {
+ return routingParameters_;
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ @java.lang.Override
+ public int getRoutingParametersCount() {
+ return routingParameters_.size();
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ @java.lang.Override
+ public com.google.api.RoutingParameter getRoutingParameters(int index) {
+ return routingParameters_.get(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;
+ */
+ @java.lang.Override
+ public com.google.api.RoutingParameterOrBuilder getRoutingParametersOrBuilder(int index) {
+ return routingParameters_.get(index);
+ }
+
+ private byte memoizedIsInitialized = -1;
+
+ @java.lang.Override
+ public final boolean isInitialized() {
+ byte isInitialized = memoizedIsInitialized;
+ if (isInitialized == 1) return true;
+ if (isInitialized == 0) return false;
+
+ memoizedIsInitialized = 1;
+ return true;
+ }
+
+ @java.lang.Override
+ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
+ for (int i = 0; i < routingParameters_.size(); i++) {
+ output.writeMessage(2, routingParameters_.get(i));
+ }
+ unknownFields.writeTo(output);
+ }
+
+ @java.lang.Override
+ public int getSerializedSize() {
+ int size = memoizedSize;
+ if (size != -1) return size;
+
+ size = 0;
+ for (int i = 0; i < routingParameters_.size(); i++) {
+ size +=
+ com.google.protobuf.CodedOutputStream.computeMessageSize(2, routingParameters_.get(i));
+ }
+ size += unknownFields.getSerializedSize();
+ memoizedSize = size;
+ return size;
+ }
+
+ @java.lang.Override
+ public boolean equals(final java.lang.Object obj) {
+ if (obj == this) {
+ return true;
+ }
+ if (!(obj instanceof com.google.api.RoutingRule)) {
+ return super.equals(obj);
+ }
+ com.google.api.RoutingRule other = (com.google.api.RoutingRule) obj;
+
+ if (!getRoutingParametersList().equals(other.getRoutingParametersList())) return false;
+ if (!unknownFields.equals(other.unknownFields)) return false;
+ return true;
+ }
+
+ @java.lang.Override
+ public int hashCode() {
+ if (memoizedHashCode != 0) {
+ return memoizedHashCode;
+ }
+ int hash = 41;
+ hash = (19 * hash) + getDescriptor().hashCode();
+ if (getRoutingParametersCount() > 0) {
+ hash = (37 * hash) + ROUTING_PARAMETERS_FIELD_NUMBER;
+ hash = (53 * hash) + getRoutingParametersList().hashCode();
+ }
+ hash = (29 * hash) + unknownFields.hashCode();
+ memoizedHashCode = hash;
+ return hash;
+ }
+
+ public static com.google.api.RoutingRule parseFrom(java.nio.ByteBuffer data)
+ throws com.google.protobuf.InvalidProtocolBufferException {
+ return PARSER.parseFrom(data);
+ }
+
+ public static com.google.api.RoutingRule parseFrom(
+ java.nio.ByteBuffer data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+ throws com.google.protobuf.InvalidProtocolBufferException {
+ return PARSER.parseFrom(data, extensionRegistry);
+ }
+
+ public static com.google.api.RoutingRule parseFrom(com.google.protobuf.ByteString data)
+ throws com.google.protobuf.InvalidProtocolBufferException {
+ return PARSER.parseFrom(data);
+ }
+
+ public static com.google.api.RoutingRule parseFrom(
+ com.google.protobuf.ByteString data,
+ com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+ throws com.google.protobuf.InvalidProtocolBufferException {
+ return PARSER.parseFrom(data, extensionRegistry);
+ }
+
+ public static com.google.api.RoutingRule parseFrom(byte[] data)
+ throws com.google.protobuf.InvalidProtocolBufferException {
+ return PARSER.parseFrom(data);
+ }
+
+ public static com.google.api.RoutingRule parseFrom(
+ byte[] data, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+ throws com.google.protobuf.InvalidProtocolBufferException {
+ return PARSER.parseFrom(data, extensionRegistry);
+ }
+
+ public static com.google.api.RoutingRule parseFrom(java.io.InputStream input)
+ throws java.io.IOException {
+ return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+ }
+
+ public static com.google.api.RoutingRule parseFrom(
+ java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+ throws java.io.IOException {
+ return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+ PARSER, input, extensionRegistry);
+ }
+
+ public static com.google.api.RoutingRule parseDelimitedFrom(java.io.InputStream input)
+ throws java.io.IOException {
+ return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(PARSER, input);
+ }
+
+ public static com.google.api.RoutingRule parseDelimitedFrom(
+ java.io.InputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+ throws java.io.IOException {
+ return com.google.protobuf.GeneratedMessageV3.parseDelimitedWithIOException(
+ PARSER, input, extensionRegistry);
+ }
+
+ public static com.google.api.RoutingRule parseFrom(com.google.protobuf.CodedInputStream input)
+ throws java.io.IOException {
+ return com.google.protobuf.GeneratedMessageV3.parseWithIOException(PARSER, input);
+ }
+
+ public static com.google.api.RoutingRule parseFrom(
+ com.google.protobuf.CodedInputStream input,
+ com.google.protobuf.ExtensionRegistryLite extensionRegistry)
+ throws java.io.IOException {
+ return com.google.protobuf.GeneratedMessageV3.parseWithIOException(
+ PARSER, input, extensionRegistry);
+ }
+
+ @java.lang.Override
+ public Builder newBuilderForType() {
+ return newBuilder();
+ }
+
+ public static Builder newBuilder() {
+ return DEFAULT_INSTANCE.toBuilder();
+ }
+
+ public static Builder newBuilder(com.google.api.RoutingRule prototype) {
+ return DEFAULT_INSTANCE.toBuilder().mergeFrom(prototype);
+ }
+
+ @java.lang.Override
+ public Builder toBuilder() {
+ return this == DEFAULT_INSTANCE ? new Builder() : new Builder().mergeFrom(this);
+ }
+
+ @java.lang.Override
+ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
+ Builder builder = new Builder(parent);
+ return builder;
+ }
+ /**
+ *
+ *
+ *
+ * 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:
+ * // - `projects/<project>/tables/<table>`
+ * // - `projects/<project>/instances/<instance>/tables/<table>`
+ * // - `region/<region>/zones/<zone>/tables/<table>`
+ * string table_name = 1;
+ * // This value specifies routing for replication.
+ * // It can be in the following formats:
+ * // - `profiles/<profile_id>`
+ * // - a legacy `profile_id` 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 `app_profile_id`.
+ * 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 `app_profile_id`, but name it `routing_id` 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 `table_name`, if it's well-formed (with project-based
+ * // syntax).
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{table_name=projects/*/instances/*/**}"
+ * }
+ * };
+ * 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 `table_name`, if it's well-formed (with region-based
+ * // syntax).
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{table_name=regions/*/zones/*/**}"
+ * }
+ * };
+ * 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 `table_name`, if it's well-formed, whether
+ * // using the region- or projects-based syntax.
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{table_name=regions/*/zones/*/**}"
+ * }
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{table_name=projects/*/instances/*/**}"
+ * }
+ * };
+ * 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 `table_name` field.
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{routing_id=projects/*}/**"
+ * }
+ * };
+ * 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 `table_name` 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/*}/**"
+ * }
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{routing_id=projects/*/instances/*}/**"
+ * }
+ * };
+ * 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 `project_id` for tables without
+ * // an instance in the `table_name`.
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{project_id=projects/*}/**"
+ * }
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "projects/*/{instance_id=instances/*}/**"
+ * }
+ * };
+ * 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 `project_id` and `routing_id`
+ * // (from the `app_profile_id` field) for routing.
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{project_id=projects/*}/**"
+ * }
+ * 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 `routing_id` can be a project id or a region id depending on
+ * // the table name format, but only if the `app_profile_id` is not set.
+ * // If `app_profile_id` is set it should be used instead.
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{routing_id=projects/*}/**"
+ * }
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{routing_id=regions/*}/**"
+ * }
+ * 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 `table_location` and a `routing_id` are needed.
+ * //
+ * // table_location can be either an instance id or a region+zone id.
+ * //
+ * // For `routing_id`, take the value of `app_profile_id`
+ * // - If it's in the format `profiles/<profile_id>`, send
+ * // just the `<profile_id>` part.
+ * // - If it's any other literal, send it as is.
+ * // If the `app_profile_id` is empty, and the `table_name` starts with
+ * // the project_id, send that instead.
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "projects/*/{table_location=instances/*}/tables/*"
+ * }
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{table_location=regions/*/zones/*}/tables/*"
+ * }
+ * routing_parameters {
+ * field: "table_name"
+ * path_template: "{routing_id=projects/*}/**"
+ * }
+ * 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 {@code google.api.RoutingRule}
+ */
+ public static final class Builder extends com.google.protobuf.GeneratedMessageV3.Builder+ * 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;
+ */
+ public java.util.List+ * 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;
+ */
+ public int getRoutingParametersCount() {
+ if (routingParametersBuilder_ == null) {
+ return routingParameters_.size();
+ } else {
+ return routingParametersBuilder_.getCount();
+ }
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ public com.google.api.RoutingParameter getRoutingParameters(int index) {
+ if (routingParametersBuilder_ == null) {
+ return routingParameters_.get(index);
+ } else {
+ return routingParametersBuilder_.getMessage(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;
+ */
+ public Builder setRoutingParameters(int index, com.google.api.RoutingParameter value) {
+ if (routingParametersBuilder_ == null) {
+ if (value == null) {
+ throw new NullPointerException();
+ }
+ ensureRoutingParametersIsMutable();
+ routingParameters_.set(index, value);
+ onChanged();
+ } else {
+ routingParametersBuilder_.setMessage(index, value);
+ }
+ return this;
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ public Builder setRoutingParameters(
+ int index, com.google.api.RoutingParameter.Builder builderForValue) {
+ if (routingParametersBuilder_ == null) {
+ ensureRoutingParametersIsMutable();
+ routingParameters_.set(index, builderForValue.build());
+ onChanged();
+ } else {
+ routingParametersBuilder_.setMessage(index, builderForValue.build());
+ }
+ return this;
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ public Builder addRoutingParameters(com.google.api.RoutingParameter value) {
+ if (routingParametersBuilder_ == null) {
+ if (value == null) {
+ throw new NullPointerException();
+ }
+ ensureRoutingParametersIsMutable();
+ routingParameters_.add(value);
+ onChanged();
+ } else {
+ routingParametersBuilder_.addMessage(value);
+ }
+ return this;
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ public Builder addRoutingParameters(int index, com.google.api.RoutingParameter value) {
+ if (routingParametersBuilder_ == null) {
+ if (value == null) {
+ throw new NullPointerException();
+ }
+ ensureRoutingParametersIsMutable();
+ routingParameters_.add(index, value);
+ onChanged();
+ } else {
+ routingParametersBuilder_.addMessage(index, value);
+ }
+ return this;
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ public Builder addRoutingParameters(com.google.api.RoutingParameter.Builder builderForValue) {
+ if (routingParametersBuilder_ == null) {
+ ensureRoutingParametersIsMutable();
+ routingParameters_.add(builderForValue.build());
+ onChanged();
+ } else {
+ routingParametersBuilder_.addMessage(builderForValue.build());
+ }
+ return this;
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ public Builder addRoutingParameters(
+ int index, com.google.api.RoutingParameter.Builder builderForValue) {
+ if (routingParametersBuilder_ == null) {
+ ensureRoutingParametersIsMutable();
+ routingParameters_.add(index, builderForValue.build());
+ onChanged();
+ } else {
+ routingParametersBuilder_.addMessage(index, builderForValue.build());
+ }
+ return this;
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ public Builder addAllRoutingParameters(
+ java.lang.Iterable values) {
+ if (routingParametersBuilder_ == null) {
+ ensureRoutingParametersIsMutable();
+ com.google.protobuf.AbstractMessageLite.Builder.addAll(values, routingParameters_);
+ onChanged();
+ } else {
+ routingParametersBuilder_.addAllMessages(values);
+ }
+ return this;
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ public Builder clearRoutingParameters() {
+ if (routingParametersBuilder_ == null) {
+ routingParameters_ = java.util.Collections.emptyList();
+ bitField0_ = (bitField0_ & ~0x00000001);
+ onChanged();
+ } else {
+ routingParametersBuilder_.clear();
+ }
+ return this;
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ public Builder removeRoutingParameters(int index) {
+ if (routingParametersBuilder_ == null) {
+ ensureRoutingParametersIsMutable();
+ routingParameters_.remove(index);
+ onChanged();
+ } else {
+ routingParametersBuilder_.remove(index);
+ }
+ return this;
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ public com.google.api.RoutingParameter.Builder getRoutingParametersBuilder(int index) {
+ return getRoutingParametersFieldBuilder().getBuilder(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;
+ */
+ public com.google.api.RoutingParameterOrBuilder getRoutingParametersOrBuilder(int index) {
+ if (routingParametersBuilder_ == null) {
+ return routingParameters_.get(index);
+ } else {
+ return routingParametersBuilder_.getMessageOrBuilder(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;
+ */
+ public java.util.List
+ getRoutingParametersOrBuilderList() {
+ if (routingParametersBuilder_ != null) {
+ return routingParametersBuilder_.getMessageOrBuilderList();
+ } else {
+ return java.util.Collections.unmodifiableList(routingParameters_);
+ }
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ public com.google.api.RoutingParameter.Builder addRoutingParametersBuilder() {
+ return getRoutingParametersFieldBuilder()
+ .addBuilder(com.google.api.RoutingParameter.getDefaultInstance());
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ public com.google.api.RoutingParameter.Builder addRoutingParametersBuilder(int index) {
+ return getRoutingParametersFieldBuilder()
+ .addBuilder(index, com.google.api.RoutingParameter.getDefaultInstance());
+ }
+ /**
+ *
+ *
+ * + * 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;
+ */
+ public java.util.List+ * 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;
+ */
+ java.util.List+ * 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;
+ */
+ com.google.api.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;
+ */
+ 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;
+ */
+ java.util.List
+ 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;
+ */
+ com.google.api.RoutingParameterOrBuilder getRoutingParametersOrBuilder(int index);
+}
diff --git a/synth.metadata b/synth.metadata
index 65bb035e..22e23d7f 100644
--- a/synth.metadata
+++ b/synth.metadata
@@ -4,7 +4,7 @@
"git": {
"name": ".",
"remote": "https://github.com/googleapis/java-common-protos.git",
- "sha": "015cfd8b552926963aee30de019d1638133dce31"
+ "sha": "08b5c8545ed6f29a11ae4d3f061df47f40234bd1"
}
},
{
@@ -19,7 +19,7 @@
"git": {
"name": "synthtool",
"remote": "https://github.com/googleapis/synthtool.git",
- "sha": "0752ff727a19a467dffed335d5e59303689cf0d1"
+ "sha": "a4be3384ccb92364795d981f2863f6986fcee620"
}
}
],
@@ -200,6 +200,11 @@
"proto-google-common-protos/src/main/java/com/google/api/ResourceProto.java",
"proto-google-common-protos/src/main/java/com/google/api/ResourceReference.java",
"proto-google-common-protos/src/main/java/com/google/api/ResourceReferenceOrBuilder.java",
+ "proto-google-common-protos/src/main/java/com/google/api/RoutingParameter.java",
+ "proto-google-common-protos/src/main/java/com/google/api/RoutingParameterOrBuilder.java",
+ "proto-google-common-protos/src/main/java/com/google/api/RoutingProto.java",
+ "proto-google-common-protos/src/main/java/com/google/api/RoutingRule.java",
+ "proto-google-common-protos/src/main/java/com/google/api/RoutingRuleOrBuilder.java",
"proto-google-common-protos/src/main/java/com/google/api/Service.java",
"proto-google-common-protos/src/main/java/com/google/api/ServiceOrBuilder.java",
"proto-google-common-protos/src/main/java/com/google/api/ServiceProto.java",
diff --git a/synth.py b/synth.py
index bd68d39c..d90a71f7 100644
--- a/synth.py
+++ b/synth.py
@@ -106,4 +106,5 @@ def build_grpc(target):
'README.md',
'samples/*',
'.github/workflows/samples.yaml',
+ '.kokoro/dependencies.sh',
])
diff --git a/versions.txt b/versions.txt
index 351c75d7..196f4b61 100644
--- a/versions.txt
+++ b/versions.txt
@@ -1,4 +1,4 @@
# Format:
# module:released-version:current-version
-proto-google-common-protos:2.5.1:2.5.1
+proto-google-common-protos:2.6.0:2.6.0
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies: