votorola.a.count

Class VoteCastingContext

java.lang.Object

VoteCastingContext

public final class VoteCastingContext
extends Object

A context for restricting the casting of votes.

Constructor Summary

Constructors

Constructor and Description
VoteCastingContext(boolean _isRealCount, TraceNodeW _voterTraceNode, Set<String> _voterDivisions) Constructs a VoteCastingContext.

Method Summary

Methods

Modifier and Type	Method and Description
String	getBar() Describes the bar against the voter, if any has been set.
boolean	isRealCount() Answers whether eligibility is being determined for the purpose of a real poll count, or merely in order to echo a change in the voter interface.
void	setBar(String newBar) Sets a bar against the voter.
Set<String>	voterDivisions() The set of divisions of which the voter is a registered member, as determined from the latest trace of the trust network, if any.
TraceNode	voterTraceNode() The voter's node from the latest trace of the trust network, if any.

Methods inherited from class java.lang.Object

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

Constructor Detail

VoteCastingContext

VoteCastingContext(boolean _isRealCount,
                  TraceNodeW _voterTraceNode,
                  Set<String> _voterDivisions)

Constructs a VoteCastingContext.

Throws:

IllegalStateException - if isRealCount is true and voterTraceNode is null

Method Detail

getBar

public String getBar()

Describes the bar against the voter, if any has been set. The description is intended for users to read. It should include details that may be of help in overcoming the bar. For instance, if the voter is barred because of insufficient trust, then the bar should state the required level of trust and how to obtain it.

Returns:

description of bar, or null if no bar is set.

See Also:

setBar(String), CountNodeW.getBar()

setBar

public void setBar(String newBar)

Sets a bar against the voter.

See Also:

getBar()

isRealCount

public boolean isRealCount()

Answers whether eligibility is being determined for the purpose of a real poll count, or merely in order to echo a change in the voter interface.

Returns:

true if eligibility is being determined for the purpose of a real poll count.

voterDivisions

public Set<String> voterDivisions()

The set of divisions of which the voter is a registered member, as determined from the latest trace of the trust network, if any. A null value indicates that no trace is mounted, or the voter was unregistered at mount time. [FIX per voterTraceNode().] A null value will never occur for a real count.

Returns:

unmodifiable set of zero or more wiki pagenames and/or URLs; or null if no trace is mounted.

See Also:

Registration.divisions()

voterTraceNode

public TraceNode voterTraceNode()

The voter's node from the latest trace of the trust network, if any. A null value indicates that no trace is mounted, or the voter was unregistered at mount time. [FIX, so that client can discriminate between the these states. Can use TraceNodeIC for this.] A null value will never occur for a real count.

Returns:

voter's trace node, or null if no trace is mounted.