votorola.s.gwt.mediawiki

Class DifferenceShadows

java.lang.Object

DifferenceShadows

final class DifferenceShadows
extends Object

The set of all shadowed differences for an anchoring author. Acknowledgement: The need for something like difference shadows was first pointed out by Ed Pastore in the Metagovernent mailing list. See this post.

See Also:

DifferenceShadowsV

Constructor Summary

Constructors

Constructor and Description
DifferenceShadows(CountJS _count, CountNodeJS _anchor, ShadowedDiff[] _voterDiffBoard, JsArray<CountNodeJS> _peers, ShadowedDiff[] _peerDiffBoard, CountNodeJS _candidate, ShadowedDiff _candidateDiff, TheatrePage referrer) Constructs an instance of DifferenceShadows that co-exists permanently with the stage.

Method Summary

Methods

Modifier and Type	Method and Description
(package private) CountNodeJS	anchor() The count node of the anchoring author complete with voters.
(package private) CountNodeJS	candidate() The count node of the anchor's candidate complete with her voters, or null if there is no candidate.
(package private) ShadowedDiff	candidateDiff() Returns the difference between the anchor's position draft and the candidate's; or null if there is no candidate, or the difference is unknown.
(package private) CountJS	count() The overall count for the anchor and other count nodes.
(package private) ShadowedDiff	diffFor(DiffLook d1) Returns the shadowed version of the specified difference, or null if there is none.
(package private) ShadowedDiff	diffFor(String personName, String pollName) Returns the shadowed difference for the specified person and poll, or null if there is none.
(package private) ShadowedDiff	peerDiff(int n) Returns the difference between the position drafts of the anchor and her peer at the specified index; or null if there is no such peer, or the difference is unknown.
(package private) JsArray<CountNodeJS>	peers() A sparse array of the anchor's dart sectored peers.
(package private) void	run(LightableDifference.Runner<ShadowedDiff> runner) Passes all shadowed differences through the specified runner.
(package private) void	setReferrer(TheatrePage referrer) Stages and lights the HTTP referrer's difference, if it is shadowed.
(package private) ShadowedDiff	voterDiff(int n) Returns the difference between the anchor's position draft and the voter's at the specified index; or null if there is no such voter, or the difference is unknown.

Methods inherited from class java.lang.Object

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

Constructor Detail

DifferenceShadows

DifferenceShadows(CountJS _count,
                 CountNodeJS _anchor,
                 ShadowedDiff[] _voterDiffBoard,
                 JsArray<CountNodeJS> _peers,
                 ShadowedDiff[] _peerDiffBoard,
                 CountNodeJS _candidate,
                 ShadowedDiff _candidateDiff,
                 TheatrePage referrer)

Constructs an instance of DifferenceShadows that co-exists permanently with the stage.

Parameters:

_voterDiffBoard - a sparse array of length 20 containing the differences between the anchor and her voters.

_peerDiffBoard - a sparse array of length 20 containing the differences between the anchor and her peers.

See Also:

count(), anchor(), peers(), candidate(), candidateDiff()

Method Detail

anchor

CountNodeJS anchor()

The count node of the anchoring author complete with voters.

candidate

CountNodeJS candidate()

The count node of the anchor's candidate complete with her voters, or null if there is no candidate.

candidateDiff

ShadowedDiff candidateDiff()

Returns the difference between the anchor's position draft and the candidate's; or null if there is no candidate, or the difference is unknown.

count

CountJS count()

The overall count for the anchor and other count nodes.

diffFor

ShadowedDiff diffFor(DiffLook d1)

Returns the shadowed version of the specified difference, or null if there is none.

diffFor

ShadowedDiff diffFor(String personName,
                   String pollName)

Returns the shadowed difference for the specified person and poll, or null if there is none.

peers

JsArray<CountNodeJS> peers()

A sparse array of the anchor's dart sectored peers. These are her co-voters unless she is a root candidate, in which case they are her fellow base candidates. The array is indexed from zero with null elements for empty sectors.

Returns:

an array of length 20.

peerDiff

ShadowedDiff peerDiff(int n)

Returns the difference between the position drafts of the anchor and her peer at the specified index; or null if there is no such peer, or the difference is unknown. If there is no candidate and the anchor is a root candidate, then the peers will be fellow base candidates.

Parameters:

n - the dart sector of the peer less one, from zero (inclusive) to 20 (non-inclusive).

run

void run(LightableDifference.Runner<ShadowedDiff> runner)

Passes all shadowed differences through the specified runner.

setReferrer

@Warning(value="init call")
final void setReferrer(TheatrePage referrer)

Stages and lights the HTTP referrer's difference, if it is shadowed.

voterDiff

ShadowedDiff voterDiff(int n)

Returns the difference between the anchor's position draft and the voter's at the specified index; or null if there is no such voter, or the difference is unknown.

Parameters:

n - the dart sector of the voter less one, from zero (inclusive) to 20 (non-inclusive).