org.apache.juneau.http

Class Location

java.lang.Object

org.apache.juneau.http.HeaderUri

org.apache.juneau.http.Location

@Header(value="Location")
public final class Location
extends HeaderUri

Represents a parsed Location HTTP response header.

Used in redirection, or when a new resource has been created.

Example

Location: http://www.w3.org/pub/WWW/People.html

RFC2616 Specification

The Location response-header field is used to redirect the recipient to a location other than the Request-URI for completion of the request or identification of a new resource. For 201 (Created) responses, the Location is that of the new resource which was created by the request. For 3xx responses, the location SHOULD indicate the server's preferred URI for automatic redirection to the resource. The field value consists of a single absolute URI.

Location = "Location" ":" absoluteURI

An example is:

Location: http://www.w3.org/pub/WWW/People.html

Note: The Content-Location header field (section 14.14) differs from Location in that the Content-Location identifies the original location of the entity enclosed in the request. It is therefore possible for a response to contain header fields for both Location and Content-Location. Also see section 13.10 for cache requirements of some methods.

• Hypertext Transfer Protocol -- HTTP/1.1

Method Summary

Modifier and Type	Method and Description
static Location	forString(String value) Returns a parsed Location header.

Methods inherited from class org.apache.juneau.http.HeaderUri

asString, asURI, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

forString

public static Location forString(String value)

Returns a parsed Location header.

Parameters:

value - The Location header string.

Returns:

The parsed Location header, or null if the string was null.