NoVarySearchData


@Profile.ExperimentalUrlPrefetch
class NoVarySearchData


The No-Vary-Search data specifies a set of rules that define how a URL's query parameters will affect cache matching. These rules dictate whether the same URL with different URL parameters should be saved as separate browser cache entries.

See Doc here to learn more about No-Vary-Search.

Summary

Public functions

java-static NoVarySearchData

Returns No-Vary-Search data that considers all differences in query parameters (i.e. presence and ordering) between otherwise identical URLs in cache matching.

java-static NoVarySearchData

Returns No-Vary-Search data that doesn't consider any differences in query parameters (i.e. presence or ordering) between otherwise identical URLs in cache matching.

java-static NoVarySearchData
@Profile.ExperimentalUrlPrefetch
neverVaryExcept(
    varyOnOrdering: Boolean,
    consideredQueryParameters: (Mutable)List<String!>
)

Returns No-Vary-Search data that doesn't consider differences in in query parameters present between otherwise identical URLs in cache matching with the exception of the ones provided in consideredQueryParameters.

java-static NoVarySearchData
@Profile.ExperimentalUrlPrefetch
varyExcept(
    varyOnOrdering: Boolean,
    ignoredQueryParameters: (Mutable)List<String!>
)

Returns No-Vary-Search data that considers differences in in query parameters present between otherwise identical URLs in cache matching with the exception of the ones provided in ignoredQueryParameters.

Public properties

(Mutable)List<String!>

A List of parameters that if present, will cause otherwise identical URLs to be cached as separate entries.

Boolean

A true to indicate the differences in parameters present between otherwise identical URLs will not cause them to be cached as separate entries.

(Mutable)List<String!>

A List of parameters that if present, will not cause otherwise identical URLs to be cached as separate entries.

Boolean

If true this indicates that differences in the order of parameters between otherwise identical URLs will cause them to be cached as separate entries.

Public functions

alwaysVaryData

@Profile.ExperimentalUrlPrefetch
java-static fun alwaysVaryData(): NoVarySearchData

Returns No-Vary-Search data that considers all differences in query parameters (i.e. presence and ordering) between otherwise identical URLs in cache matching.

neverVaryData

@Profile.ExperimentalUrlPrefetch
java-static fun neverVaryData(): NoVarySearchData

Returns No-Vary-Search data that doesn't consider any differences in query parameters (i.e. presence or ordering) between otherwise identical URLs in cache matching.

neverVaryExcept

@Profile.ExperimentalUrlPrefetch
java-static fun neverVaryExcept(
    varyOnOrdering: Boolean,
    consideredQueryParameters: (Mutable)List<String!>
): NoVarySearchData

Returns No-Vary-Search data that doesn't consider differences in in query parameters present between otherwise identical URLs in cache matching with the exception of the ones provided in consideredQueryParameters.

Parameters
varyOnOrdering: Boolean

true if the ordering of query parameters should be considered in cache matching, false otherwise.

consideredQueryParameters: (Mutable)List<String!>

the query parameters to consider in cache matching.

varyExcept

@Profile.ExperimentalUrlPrefetch
java-static fun varyExcept(
    varyOnOrdering: Boolean,
    ignoredQueryParameters: (Mutable)List<String!>
): NoVarySearchData

Returns No-Vary-Search data that considers differences in in query parameters present between otherwise identical URLs in cache matching with the exception of the ones provided in ignoredQueryParameters.

Parameters
varyOnOrdering: Boolean

true if the ordering of query parameters should be considered in cache matching, false otherwise.

ignoredQueryParameters: (Mutable)List<String!>

the query parameters to ignore in cache matching.

Public properties

consideredQueryParameters

val consideredQueryParameters: (Mutable)List<String!>

A List of parameters that if present, will cause otherwise identical URLs to be cached as separate entries. Any parameters present in the URLs that are not included in this list will not affect cache matching.

This list is irrelevant and not used if ignoreDifferencesInParameters is false.

ignoreDifferencesInParameters

val ignoreDifferencesInParametersBoolean

A true to indicate the differences in parameters present between otherwise identical URLs will not cause them to be cached as separate entries. false otherwise.

ignoredQueryParameters

val ignoredQueryParameters: (Mutable)List<String!>

A List of parameters that if present, will not cause otherwise identical URLs to be cached as separate entries. Any parameters present in the URLs that are not included in this list will affect cache matching.

This list is irrelevant and not used if ignoreDifferencesInParameters is true.

varyOnKeyOrder

val varyOnKeyOrderBoolean

If true this indicates that differences in the order of parameters between otherwise identical URLs will cause them to be cached as separate entries.

However, differences in the parameters present will cause them to be cached separately regardless of this flag's value.

To ignore any differences in parameters present for caching see ignoreDifferencesInParameters and ignoredQueryParameters. false otherwise.