votorola.s.gwt.stage.link

Class NominalDifferenceTargeter

java.lang.Object

TheatreInitializer0

LinkTrackV.StageListener

LinkTrackV.Targeter

LinkTrackV.TargeterN

NominalDifferenceTargeter

All Implemented Interfaces:

Scheduler.ScheduledCommand, EventHandler, AsyncCallback<JavaScriptObject>, ChangeHandler, PropertyChangeHandler, TheatreInitializer

public final class NominalDifferenceTargeter
extends LinkTrackV.TargeterN
implements AsyncCallback<JavaScriptObject>, ChangeHandler

A targeter for a difference link with support for nominal targeting. Nominal targeting specifies differences in terms of poll and author names (aAuthor and bAuthor in WP_D) as opposed to the revision numbers of draft pages. A nominal target always refers to the latest difference of the two authors. This particular targeter is restricted to differences between the anchor and his/her direct cast relations. It nominally targets the link whenever the following conditions are met:

• The link would not otherwise be targeted to an actual page location, either because there is no staged difference, the staged difference is already nominal, or it is already shown in the present page (as for instance in the bridge).
• A poll is staged.
• An actor is staged who is a direct cast relation within that poll of the anchor.
• Both anchor and actor have formal positions in the poll and so assumedly drafts.

Under these conditions, the link is nominally targeted and the stage is set to NOMINAL_DIFF.

Field Summary

Fields

Modifier and Type	Field and Description
(package private) Object	diffMapS The source of change events for diffMap.
static DiffLook	NOMINAL_DIFF The difference that is staged whenever the difference link is nominally targeted.

Fields inherited from class LinkTrackV.TargeterN

coalescer

Constructor Summary

Constructors

Constructor and Description
NominalDifferenceTargeter(LinkTrackV trackV, AnchorElement diffLink) Creates a NominalDifferenceTargeter.

Method Summary

Methods

Modifier and Type	Method and Description
(package private) Map<String,LightableDifference1>	diffMap() The map of lightable differences keyed by author name.
static void	forceInitClass() Does nothing itself but the call forces static initialization of this class.
static boolean	isEnabled() Answers whether nominal targeting is enabled.
void	onChange(Change _e) Handles the event.
void	onFailure(Throwable x)
void	onPropertyChange(PropertyChange e) Handles the event.
void	onSuccess(JavaScriptObject response)
(package private) void	retarget()
static void	setEnabled() Enables nominal targeting.
(package private) VoteTrack	voteTrack() The staged instance of the vote track.

Methods inherited from class LinkTrackV.TargeterN

execute

Methods inherited from class LinkTrackV.Targeter

adjustedTarget, init, setTarget

Methods inherited from class LinkTrackV.StageListener

initFromComplete, initToComplete

Methods inherited from class TheatreInitializer0

initFrom, initTo, initTo, initUltimately

Methods inherited from class java.lang.Object

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

Field Detail

diffMapS

final Object diffMapS

The source of change events for diffMap.

NOMINAL_DIFF

public static final DiffLook NOMINAL_DIFF

The difference that is staged whenever the difference link is nominally targeted. The diff key is fabricated and very unlikely to correspond to an actual difference in the wiki.

Constructor Detail

NominalDifferenceTargeter

NominalDifferenceTargeter(LinkTrackV trackV,
                         AnchorElement diffLink)

Creates a NominalDifferenceTargeter. Create at most one for the entire life of the document, as currently it does not unregister its listeners or otherwise clean up after itself.

Method Detail

forceInitClass

public static void forceInitClass()

Does nothing itself but the call forces static initialization of this class.

diffMap

Map<String,LightableDifference1> diffMap()

The map of lightable differences keyed by author name. Changes to map state are signalled by change events on the bus. The event source is diffMapS.

isEnabled

public static boolean isEnabled()

Answers whether nominal targeting is enabled.

setEnabled

@GWTConfigCallback
public static void setEnabled()

Enables nominal targeting. Call this method from the global configuration function voGWTConfig.s_gwt_stage in this fashion:

   s_gwt_stage_link_NominalDifferenceTargeter_setEnabled();

retarget

void retarget()

Specified by:

retarget in class LinkTrackV.Targeter

voteTrack

VoteTrack voteTrack()

The staged instance of the vote track.

onFailure

public void onFailure(Throwable x)

Specified by:

onFailure in interface AsyncCallback<JavaScriptObject>

onSuccess

public void onSuccess(JavaScriptObject response)

Specified by:

onSuccess in interface AsyncCallback<JavaScriptObject>

onChange

public void onChange(Change _e)

Description copied from interface: ChangeHandler

Handles the event.

Specified by:

onChange in interface ChangeHandler

onPropertyChange

public void onPropertyChange(PropertyChange e)

Description copied from interface: PropertyChangeHandler

Handles the event.

Specified by:

onPropertyChange in interface PropertyChangeHandler

Overrides:

onPropertyChange in class LinkTrackV.StageListener