Package org.apache.juneau.http.header

Class Age

java.lang.Object
org.apache.juneau.http.header.BasicHeader
org.apache.juneau.http.header.BasicIntegerHeader
org.apache.juneau.http.header.Age
All Implemented Interfaces:
Serializable, Cloneable, Header, NameValuePair
@Header("Age") public class Age extends BasicIntegerHeader
Represents a parsed Age HTTP response header.

The age the object has been in a proxy cache in seconds.

Example

Age: 12

RFC2616 Specification
The Age response-header field conveys the sender's estimate of the amount of time since the response (or its revalidation) was generated at the origin server. A cached response is "fresh" if its age does not exceed its freshness lifetime. Age values are calculated as specified in section 13.2.3.

Age = "Age" ":" age-value age-value = delta-seconds

Age values are non-negative decimal integers, representing time in seconds.

If a cache receives a value larger than the largest positive integer it can represent, or if any of its age calculations overflows, it MUST transmit an Age header with a value of 2147483648 (2^31).

An HTTP/1.1 server that includes a cache MUST include an Age header field in every response generated from its own cache.

Caches SHOULD use an arithmetic type of at least 31 bits of range.

See Also:

  • Constructor Details

    • Age

      public Age(String value)
      Constructor.
      Parameters:
      value - The header value.
      Must be parsable using Integer.parseInt(String).
      Can be null.

    • Age

      public Age(Integer value)
      Constructor.
      Parameters:
      value - The header value.
      Can be null.

    • Age

      public Age(Supplier<Integer> value)
      Constructor with delayed value.

      Header value is re-evaluated on each call to BasicIntegerHeader.getValue().

      Parameters:
      value - The supplier of the header value.
      Can be null.

  • Method Details

    • of

      public static Age of(String value)
      Static creator.
      Parameters:
      value - The header value.
      Must be parsable using Integer.parseInt(String).
      Can be null.
      Returns:
      A new header bean, or null if the value is null.

    • of

      public static Age of(Integer value)
      Static creator.
      Parameters:
      value - The header value.
      Can be null.
      Returns:
      A new header bean, or null if the value is null.

    • of

      public static Age of(Supplier<Integer> value)
      Static creator with delayed value.

      Header value is re-evaluated on each call to BasicIntegerHeader.getValue().

      Parameters:
      value - The supplier of the header value.
      Can be null.
      Returns:
      A new header bean, or null if the value is null.