votorola.s.gwt.stage

Class ReferrerRelayer

java.lang.Object

ReferrerRelayer

public final class ReferrerRelayer
extends Object

The relayer of state across an active link from one theatre page (referrer) to another (destination). A single instance is created for use during stage initialization.

Field Summary

Fields

Modifier and Type	Field and Description
static String	COOKIE_PATH The path for all relay cookies.
static boolean	COOKIE_SECURE The security mode for all relay cookies.
static String	KEY The key under which the state of the stage is stored.
static String	KEY_HREF The key under which the URL of the link target (stripped of any fragment) is stored.
(package private) static int	MAX_REFERRER_RESOLUTION_MS The time limit for resolving the referrer in cases of deferred resolution, which is 5000 ms.

Constructor Summary

Constructors

Constructor and Description
ReferrerRelayer() Creates the single instance of ReferrerRelayer.

Method Summary

Methods

Modifier and Type	Method and Description
(package private) void	activate() Attempts to enable the forward relayer, which will then store the state of the stage on detection of each link gesture.
static String	cookieDomain(String host) Returns a cookie domain (e.g. ".mydomain.dom") suitable for use in a relay cookie, or null if no domain can be determined from the provided host specification.
(package private) void	resolveReferrer(Stage stage) Attempts to resolve the referrer and immediately calls back to stage.

Methods inherited from class java.lang.Object

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

Field Detail

COOKIE_PATH

public static final String COOKIE_PATH

The path for all relay cookies.

See Also:

Constant Field Values

COOKIE_SECURE

public static final boolean COOKIE_SECURE

The security mode for all relay cookies.

See Also:

Constant Field Values

KEY

public static final String KEY

The key under which the state of the stage is stored.

See Also:

Constant Field Values

KEY_HREF

public static final String KEY_HREF

The key under which the URL of the link target (stripped of any fragment) is stored. This is set either by the referrer or redirection services it employs, such as WP_Draft.maybeRedirectToDraft. It is crucial that no subsequent redirection alter the destination URL or the destination page will reject the relay because of a URL mismatch.

See Also:

Constant Field Values

MAX_REFERRER_RESOLUTION_MS

static final int MAX_REFERRER_RESOLUTION_MS

The time limit for resolving the referrer in cases of deferred resolution, which is 5000 ms.

See Also:

Constant Field Values

Constructor Detail

ReferrerRelayer

ReferrerRelayer()

Creates the single instance of ReferrerRelayer.

Method Detail

activate

void activate()

Attempts to enable the forward relayer, which will then store the state of the stage on detection of each link gesture.

cookieDomain

public static String cookieDomain(String host)

Returns a cookie domain (e.g. ".mydomain.dom") suitable for use in a relay cookie, or null if no domain can be determined from the provided host specification.

Parameters:

host - the host specification per Net.widestCookieDomain, or null. If this is an Internet address ("206.248.142.181") or "localhost", then the host ought to have no siblings under the same domain that serve theatre pages to which it links.

resolveReferrer

void resolveReferrer(Stage stage)

Attempts to resolve the referrer and immediately calls back to stage.init1 with the result.