Class CacheKeyPolicy.Builder (1.24.0)

public static final class CacheKeyPolicy.Builder extends GeneratedMessageV3.Builder<CacheKeyPolicy.Builder> implements CacheKeyPolicyOrBuilder

Message containing what to include in the cache key for a request for Cloud CDN.

Protobuf type google.cloud.compute.v1.CacheKeyPolicy

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

Methods

addAllIncludeHttpHeaders(Iterable<String> values)

public CacheKeyPolicy.Builder addAllIncludeHttpHeaders(Iterable<String> values)

Allows HTTP request headers (by name) to be used in the cache key.

repeated string include_http_headers = 2489606;

Parameter
NameDescription
valuesIterable<String>

The includeHttpHeaders to add.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

addAllIncludeNamedCookies(Iterable<String> values)

public CacheKeyPolicy.Builder addAllIncludeNamedCookies(Iterable<String> values)

Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.

repeated string include_named_cookies = 87316530;

Parameter
NameDescription
valuesIterable<String>

The includeNamedCookies to add.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

addAllQueryStringBlacklist(Iterable<String> values)

public CacheKeyPolicy.Builder addAllQueryStringBlacklist(Iterable<String> values)

Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_blacklist = 354964742;

Parameter
NameDescription
valuesIterable<String>

The queryStringBlacklist to add.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

addAllQueryStringWhitelist(Iterable<String> values)

public CacheKeyPolicy.Builder addAllQueryStringWhitelist(Iterable<String> values)

Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_whitelist = 52456496;

Parameter
NameDescription
valuesIterable<String>

The queryStringWhitelist to add.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

addIncludeHttpHeaders(String value)

public CacheKeyPolicy.Builder addIncludeHttpHeaders(String value)

Allows HTTP request headers (by name) to be used in the cache key.

repeated string include_http_headers = 2489606;

Parameter
NameDescription
valueString

The includeHttpHeaders to add.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

addIncludeHttpHeadersBytes(ByteString value)

public CacheKeyPolicy.Builder addIncludeHttpHeadersBytes(ByteString value)

Allows HTTP request headers (by name) to be used in the cache key.

repeated string include_http_headers = 2489606;

Parameter
NameDescription
valueByteString

The bytes of the includeHttpHeaders to add.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

addIncludeNamedCookies(String value)

public CacheKeyPolicy.Builder addIncludeNamedCookies(String value)

Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.

repeated string include_named_cookies = 87316530;

Parameter
NameDescription
valueString

The includeNamedCookies to add.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

addIncludeNamedCookiesBytes(ByteString value)

public CacheKeyPolicy.Builder addIncludeNamedCookiesBytes(ByteString value)

Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.

repeated string include_named_cookies = 87316530;

Parameter
NameDescription
valueByteString

The bytes of the includeNamedCookies to add.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

addQueryStringBlacklist(String value)

public CacheKeyPolicy.Builder addQueryStringBlacklist(String value)

Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_blacklist = 354964742;

Parameter
NameDescription
valueString

The queryStringBlacklist to add.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

addQueryStringBlacklistBytes(ByteString value)

public CacheKeyPolicy.Builder addQueryStringBlacklistBytes(ByteString value)

Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_blacklist = 354964742;

Parameter
NameDescription
valueByteString

The bytes of the queryStringBlacklist to add.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

addQueryStringWhitelist(String value)

public CacheKeyPolicy.Builder addQueryStringWhitelist(String value)

Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_whitelist = 52456496;

Parameter
NameDescription
valueString

The queryStringWhitelist to add.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

addQueryStringWhitelistBytes(ByteString value)

public CacheKeyPolicy.Builder addQueryStringWhitelistBytes(ByteString value)

Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_whitelist = 52456496;

Parameter
NameDescription
valueByteString

The bytes of the queryStringWhitelist to add.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public CacheKeyPolicy.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
CacheKeyPolicy.Builder
Overrides

build()

public CacheKeyPolicy build()
Returns
TypeDescription
CacheKeyPolicy

buildPartial()

public CacheKeyPolicy buildPartial()
Returns
TypeDescription
CacheKeyPolicy

clear()

public CacheKeyPolicy.Builder clear()
Returns
TypeDescription
CacheKeyPolicy.Builder
Overrides

clearField(Descriptors.FieldDescriptor field)

public CacheKeyPolicy.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
NameDescription
fieldFieldDescriptor
Returns
TypeDescription
CacheKeyPolicy.Builder
Overrides

clearIncludeHost()

public CacheKeyPolicy.Builder clearIncludeHost()

If true, requests to different hosts will be cached separately.

optional bool include_host = 486867679;

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

clearIncludeHttpHeaders()

public CacheKeyPolicy.Builder clearIncludeHttpHeaders()

Allows HTTP request headers (by name) to be used in the cache key.

repeated string include_http_headers = 2489606;

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

clearIncludeNamedCookies()

public CacheKeyPolicy.Builder clearIncludeNamedCookies()

Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.

repeated string include_named_cookies = 87316530;

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

clearIncludeProtocol()

public CacheKeyPolicy.Builder clearIncludeProtocol()

If true, http and https requests will be cached separately.

optional bool include_protocol = 303507535;

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

clearIncludeQueryString()

public CacheKeyPolicy.Builder clearIncludeQueryString()

If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.

optional bool include_query_string = 474036639;

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public CacheKeyPolicy.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
NameDescription
oneofOneofDescriptor
Returns
TypeDescription
CacheKeyPolicy.Builder
Overrides

clearQueryStringBlacklist()

public CacheKeyPolicy.Builder clearQueryStringBlacklist()

Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_blacklist = 354964742;

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

clearQueryStringWhitelist()

public CacheKeyPolicy.Builder clearQueryStringWhitelist()

Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_whitelist = 52456496;

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

clone()

public CacheKeyPolicy.Builder clone()
Returns
TypeDescription
CacheKeyPolicy.Builder
Overrides

getDefaultInstanceForType()

public CacheKeyPolicy getDefaultInstanceForType()
Returns
TypeDescription
CacheKeyPolicy

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
TypeDescription
Descriptor
Overrides

getIncludeHost()

public boolean getIncludeHost()

If true, requests to different hosts will be cached separately.

optional bool include_host = 486867679;

Returns
TypeDescription
boolean

The includeHost.

getIncludeHttpHeaders(int index)

public String getIncludeHttpHeaders(int index)

Allows HTTP request headers (by name) to be used in the cache key.

repeated string include_http_headers = 2489606;

Parameter
NameDescription
indexint

The index of the element to return.

Returns
TypeDescription
String

The includeHttpHeaders at the given index.

getIncludeHttpHeadersBytes(int index)

public ByteString getIncludeHttpHeadersBytes(int index)

Allows HTTP request headers (by name) to be used in the cache key.

repeated string include_http_headers = 2489606;

Parameter
NameDescription
indexint

The index of the value to return.

Returns
TypeDescription
ByteString

The bytes of the includeHttpHeaders at the given index.

getIncludeHttpHeadersCount()

public int getIncludeHttpHeadersCount()

Allows HTTP request headers (by name) to be used in the cache key.

repeated string include_http_headers = 2489606;

Returns
TypeDescription
int

The count of includeHttpHeaders.

getIncludeHttpHeadersList()

public ProtocolStringList getIncludeHttpHeadersList()

Allows HTTP request headers (by name) to be used in the cache key.

repeated string include_http_headers = 2489606;

Returns
TypeDescription
ProtocolStringList

A list containing the includeHttpHeaders.

getIncludeNamedCookies(int index)

public String getIncludeNamedCookies(int index)

Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.

repeated string include_named_cookies = 87316530;

Parameter
NameDescription
indexint

The index of the element to return.

Returns
TypeDescription
String

The includeNamedCookies at the given index.

getIncludeNamedCookiesBytes(int index)

public ByteString getIncludeNamedCookiesBytes(int index)

Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.

repeated string include_named_cookies = 87316530;

Parameter
NameDescription
indexint

The index of the value to return.

Returns
TypeDescription
ByteString

The bytes of the includeNamedCookies at the given index.

getIncludeNamedCookiesCount()

public int getIncludeNamedCookiesCount()

Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.

repeated string include_named_cookies = 87316530;

Returns
TypeDescription
int

The count of includeNamedCookies.

getIncludeNamedCookiesList()

public ProtocolStringList getIncludeNamedCookiesList()

Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.

repeated string include_named_cookies = 87316530;

Returns
TypeDescription
ProtocolStringList

A list containing the includeNamedCookies.

getIncludeProtocol()

public boolean getIncludeProtocol()

If true, http and https requests will be cached separately.

optional bool include_protocol = 303507535;

Returns
TypeDescription
boolean

The includeProtocol.

getIncludeQueryString()

public boolean getIncludeQueryString()

If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.

optional bool include_query_string = 474036639;

Returns
TypeDescription
boolean

The includeQueryString.

getQueryStringBlacklist(int index)

public String getQueryStringBlacklist(int index)

Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_blacklist = 354964742;

Parameter
NameDescription
indexint

The index of the element to return.

Returns
TypeDescription
String

The queryStringBlacklist at the given index.

getQueryStringBlacklistBytes(int index)

public ByteString getQueryStringBlacklistBytes(int index)

Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_blacklist = 354964742;

Parameter
NameDescription
indexint

The index of the value to return.

Returns
TypeDescription
ByteString

The bytes of the queryStringBlacklist at the given index.

getQueryStringBlacklistCount()

public int getQueryStringBlacklistCount()

Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_blacklist = 354964742;

Returns
TypeDescription
int

The count of queryStringBlacklist.

getQueryStringBlacklistList()

public ProtocolStringList getQueryStringBlacklistList()

Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_blacklist = 354964742;

Returns
TypeDescription
ProtocolStringList

A list containing the queryStringBlacklist.

getQueryStringWhitelist(int index)

public String getQueryStringWhitelist(int index)

Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_whitelist = 52456496;

Parameter
NameDescription
indexint

The index of the element to return.

Returns
TypeDescription
String

The queryStringWhitelist at the given index.

getQueryStringWhitelistBytes(int index)

public ByteString getQueryStringWhitelistBytes(int index)

Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_whitelist = 52456496;

Parameter
NameDescription
indexint

The index of the value to return.

Returns
TypeDescription
ByteString

The bytes of the queryStringWhitelist at the given index.

getQueryStringWhitelistCount()

public int getQueryStringWhitelistCount()

Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_whitelist = 52456496;

Returns
TypeDescription
int

The count of queryStringWhitelist.

getQueryStringWhitelistList()

public ProtocolStringList getQueryStringWhitelistList()

Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_whitelist = 52456496;

Returns
TypeDescription
ProtocolStringList

A list containing the queryStringWhitelist.

hasIncludeHost()

public boolean hasIncludeHost()

If true, requests to different hosts will be cached separately.

optional bool include_host = 486867679;

Returns
TypeDescription
boolean

Whether the includeHost field is set.

hasIncludeProtocol()

public boolean hasIncludeProtocol()

If true, http and https requests will be cached separately.

optional bool include_protocol = 303507535;

Returns
TypeDescription
boolean

Whether the includeProtocol field is set.

hasIncludeQueryString()

public boolean hasIncludeQueryString()

If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.

optional bool include_query_string = 474036639;

Returns
TypeDescription
boolean

Whether the includeQueryString field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

mergeFrom(CacheKeyPolicy other)

public CacheKeyPolicy.Builder mergeFrom(CacheKeyPolicy other)
Parameter
NameDescription
otherCacheKeyPolicy
Returns
TypeDescription
CacheKeyPolicy.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public CacheKeyPolicy.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
CacheKeyPolicy.Builder
Overrides
Exceptions
TypeDescription
IOException

mergeFrom(Message other)

public CacheKeyPolicy.Builder mergeFrom(Message other)
Parameter
NameDescription
otherMessage
Returns
TypeDescription
CacheKeyPolicy.Builder
Overrides

mergeUnknownFields(UnknownFieldSet unknownFields)

public final CacheKeyPolicy.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
CacheKeyPolicy.Builder
Overrides

setField(Descriptors.FieldDescriptor field, Object value)

public CacheKeyPolicy.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
CacheKeyPolicy.Builder
Overrides

setIncludeHost(boolean value)

public CacheKeyPolicy.Builder setIncludeHost(boolean value)

If true, requests to different hosts will be cached separately.

optional bool include_host = 486867679;

Parameter
NameDescription
valueboolean

The includeHost to set.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

setIncludeHttpHeaders(int index, String value)

public CacheKeyPolicy.Builder setIncludeHttpHeaders(int index, String value)

Allows HTTP request headers (by name) to be used in the cache key.

repeated string include_http_headers = 2489606;

Parameters
NameDescription
indexint

The index to set the value at.

valueString

The includeHttpHeaders to set.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

setIncludeNamedCookies(int index, String value)

public CacheKeyPolicy.Builder setIncludeNamedCookies(int index, String value)

Allows HTTP cookies (by name) to be used in the cache key. The name=value pair will be used in the cache key Cloud CDN generates.

repeated string include_named_cookies = 87316530;

Parameters
NameDescription
indexint

The index to set the value at.

valueString

The includeNamedCookies to set.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

setIncludeProtocol(boolean value)

public CacheKeyPolicy.Builder setIncludeProtocol(boolean value)

If true, http and https requests will be cached separately.

optional bool include_protocol = 303507535;

Parameter
NameDescription
valueboolean

The includeProtocol to set.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

setIncludeQueryString(boolean value)

public CacheKeyPolicy.Builder setIncludeQueryString(boolean value)

If true, include query string parameters in the cache key according to query_string_whitelist and query_string_blacklist. If neither is set, the entire query string will be included. If false, the query string will be excluded from the cache key entirely.

optional bool include_query_string = 474036639;

Parameter
NameDescription
valueboolean

The includeQueryString to set.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

setQueryStringBlacklist(int index, String value)

public CacheKeyPolicy.Builder setQueryStringBlacklist(int index, String value)

Names of query string parameters to exclude in cache keys. All other parameters will be included. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_blacklist = 354964742;

Parameters
NameDescription
indexint

The index to set the value at.

valueString

The queryStringBlacklist to set.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

setQueryStringWhitelist(int index, String value)

public CacheKeyPolicy.Builder setQueryStringWhitelist(int index, String value)

Names of query string parameters to include in cache keys. All other parameters will be excluded. Either specify query_string_whitelist or query_string_blacklist, not both. '&' and '=' will be percent encoded and not treated as delimiters.

repeated string query_string_whitelist = 52456496;

Parameters
NameDescription
indexint

The index to set the value at.

valueString

The queryStringWhitelist to set.

Returns
TypeDescription
CacheKeyPolicy.Builder

This builder for chaining.

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public CacheKeyPolicy.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
NameDescription
fieldFieldDescriptor
indexint
valueObject
Returns
TypeDescription
CacheKeyPolicy.Builder
Overrides

setUnknownFields(UnknownFieldSet unknownFields)

public final CacheKeyPolicy.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
CacheKeyPolicy.Builder
Overrides