Package org.apache.juneau.http.classic.header

Class Age

java.lang.Object

org.apache.juneau.http.classic.header.BasicHeader

org.apache.juneau.http.classic.header.BasicIntegerHeader

org.apache.juneau.http.classic.header.Age

All Implemented Interfaces:

Serializable, 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:

• juneau-rest-common
• Hypertext Transfer Protocol -- HTTP/1.1

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
static Age	of(Integer value)	Static creator.
static Age	of(String value)	Static creator.
static Age	of(Supplier<Integer> value)	Static creator with delayed value.

Methods inherited from class org.apache.juneau.http.classic.header.BasicIntegerHeader

asInteger, assertInteger, getValue, of, of, of, orElse, toInteger

Methods inherited from class org.apache.juneau.http.classic.header.BasicHeader

assertName, assertStringValue, asString, copy, equals, equalsIgnoreCase, get, getElements, getName, hashCode, isNotEmpty, isPresent, of, of, orElse, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Details

Age

public Age(Integer value)

Constructor.

Parameters:

value - The header value.
Can be null to create a header with no value.

Age

public Age(String value)

Constructor.

Parameters:

value - The header value.
Must be parsable using Integer.parseInt(String).
Can be null to create a header with no value.

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 to create a header with no value.

Method Details

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(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(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.