CacheControl

A Cache-Control header with cache directives from a server or client. These directives set policy on what responses can be stored, and which requests can be satisfied by those stored responses.

See RFC 7234, 5.2.

Types

Builder

class Builder

Builds a Cache-Control request header.

Companion

object Companion

Properties

immutable

val immutable: Boolean

isPrivate

val isPrivate: Boolean

isPublic

val isPublic: Boolean

maxAgeSeconds

val maxAgeSeconds: Int

The duration past the response's served date that it can be served without validation.

maxStaleSeconds

val maxStaleSeconds: Int

minFreshSeconds

val minFreshSeconds: Int

mustRevalidate

val mustRevalidate: Boolean

noCache

val noCache: Boolean

In a response, this field's name "no-cache" is misleading. It doesn't prevent us from caching the response; it only means we have to validate the response with the origin server before returning it. We can do this with a conditional GET.

noStore

val noStore: Boolean

If true, this response should not be cached.

noTransform

val noTransform: Boolean

onlyIfCached

val onlyIfCached: Boolean

This field's name "only-if-cached" is misleading. It actually means "do not use the network". It is set by a client who only wants to make a request if it can be fully satisfied by the cache. Cached responses that would require validation (ie. conditional gets) are not permitted if this header is set.

sMaxAgeSeconds

val sMaxAgeSeconds: Int

The "s-maxage" directive is the max age for shared caches. Not to be confused with "max-age" for non-shared caches, As in Firefox and Chrome, this directive is not honored by this cache.

Functions

toString

open override fun toString(): String