org.apache.juneau.http

Class Referer

java.lang.Object

org.apache.juneau.http.HeaderUri

org.apache.juneau.http.Referer

public final class Referer
extends HeaderUri

Represents a parsed Referer HTTP request header.

This is the address of the previous web page from which a link to the currently requested page was followed. (The word “referrer” has been misspelled in the RFC as well as in most implementations to the point that it has become standard usage and is considered correct terminology)

Example

Referer: http://en.wikipedia.org/wiki/Main_Page

RFC2616 Specification

The Referer[sic] request-header field allows the client to specify, for the server's benefit, the address (URI) of the resource from which the Request-URI was obtained (the "referrer", although the header field is misspelled.) The Referer request-header allows a server to generate lists of back-links to resources for interest, logging, optimized caching, etc. It also allows obsolete or mistyped links to be traced for maintenance. The Referer field MUST NOT be sent if the Request-URI was obtained from a source that does not have its own URI, such as input from the user keyboard.

Referer = "Referer" ":" ( absoluteURI | relativeURI )

Example:

Referer: http://www.w3.org/hypertext/DataSources/Overview.html

If the field value is a relative URI, it SHOULD be interpreted relative to the Request-URI. The URI MUST NOT include a fragment. See section 15.1.3 for security considerations.

See Also:

• Hypertext Transfer Protocol -- HTTP/1.1

Method Summary

Modifier and Type	Method and Description
static Referer	forString(String value) Returns a parsed Referer 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 Referer forString(String value)

Returns a parsed Referer header.

Parameters:

value - The Referer header string.

Returns:

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