@Header(value="If-Range") public class IfRange extends BasicDateHeader
If the entity is unchanged, send me the part(s) that I am missing; otherwise, send me the entire new entity.
If-Range: "737060cd8c284d8af7ad3082f209582d"
The If-Range header allows a client to "short-circuit" the second request. Informally, its meaning is `if the entity is unchanged, send me the part(s) that I am missing; otherwise, send me the entire new entity'.
If-Range = "If-Range" ":" ( entity-tag | HTTP-date )
If the client has no entity tag for an entity, but does have a Last- Modified date, it MAY use that date in an If-Range header. (The server can distinguish between a valid HTTP-date and any form of entity-tag by examining no more than two characters.) The If-Range header SHOULD only be used together with a Range header, and MUST be ignored if the request does not include a Range header, or if the server does not support the sub-range operation.
If the entity tag given in the If-Range header matches the current entity tag for the entity, then the server SHOULD provide the specified sub-range of the entity using a 206 (Partial content) response. If the entity tag does not match, then the server SHOULD return the entire entity using a 200 (OK) response.
Constructor and Description |
---|
IfRange(Object value)
Constructor.
|
IfRange(String value)
Constructor
|
Modifier and Type | Method and Description |
---|---|
EntityTag |
asEntityTag()
Returns this header as an
EntityTag . |
String |
getValue() |
static IfRange |
of(Object value)
Convenience creator.
|
static IfRange |
of(Supplier<?> value)
Convenience creator using supplier.
|
asCalendar, asDate, assertZonedDateTime, asZonedDateTime, of, of
assertName, assertValue, canCast, cast, eqIC, equals, getElements, getName, getRawValue, hashCode, isSupplier, of, ofPair, toString, unwrap
public static IfRange of(Supplier<?> value)
Header value is re-evaluated on each call to getValue()
.
public String getValue()
getValue
in interface NameValuePair
getValue
in class BasicDateHeader
public EntityTag asEntityTag()
EntityTag
.EntityTag
.Copyright © 2016–2020 The Apache Software Foundation. All rights reserved.