votorola.a.register
Class ListNode0

java.lang.Object
  ListNode0

All Implemented Interfaces:

Serializable, ListNode

@ThreadSafe
public final class ListNode0
extends Object
implements ListNode

A null implementation of a node in a compiled voter list.

See Also:

Serialized Form

Constructor Summary

ListNode0(String voterEmail)
Creates a ListNode0.

Method Summary

int	doubterCount() The number of doubt signals extended to this voter, from unbarred voters.
String	getBar() The list bar against the voter, if any.
String	getNeighbourhoodPath() The path to the voter's leaf neighbourhood, where she resides.
String	getResidence() The primary residential address of the voter.
String	leafRegisterPath() Returns the slash-delimited (/) path to the voter's leaf register, within the sub-hierarchy of electoral offices.
int	primaryTrustEdgeCount() The number of primary trust extending to this node.
String	toString() Returns the voter email address.
int	trustLevel() Calculates the trust level of this node.
String	voterEmail() Identifies the voter.

Methods inherited from class java.lang.Object

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

Constructor Detail

ListNode0

public ListNode0(String voterEmail)

Creates a ListNode0.

Parameters:

voterEmail - per voterEmail()

Method Detail

doubterCount

public int doubterCount()

Description copied from interface: ListNode

The number of doubt signals extended to this voter, from unbarred voters. Doubt signals from list-barred voters are excluded from this count.

Specified by:

doubterCount in interface ListNode

Returns:

zero

See Also:

DoubtSignal

getBar

public String getBar()

Description copied from interface: ListNode

The list bar against the voter, if any. A barred voter does not appear in the compiled voter list (unless clearly marked as barred), and is ineligible to vote in any of the elections. Criteria for list bars include, for example, the voter being registered; living in the general electoral district that the office serves; and having sufficient trust to appear in the list.

The bar is intended for voters to read. It ought to include the email address of the barred voter. It ought to provide information that will be helpful in allowing the voter to overcome the bar, where possible (for instance, by correcting a registration error).

Specified by:

getBar in interface ListNode

Returns:

a default bar

See Also:

ListNodeC.defaultRootNeighbourhoodBar(String)

getNeighbourhoodPath

public String getNeighbourhoodPath()

Description copied from interface: ListNode

The path to the voter's leaf neighbourhood, where she resides. It is used during indexing of the voter list, and determines where her name will appear in the compiled list.

If the path is empty (root leaf), then the bar is guaranteed to be non-null, barring the voter from the list. Because the list browsing facilities cannot display voters at the root leaf, we avoid confusion by barring them from the outset.

Specified by:

getNeighbourhoodPath in interface ListNode

Returns:

empty string

See Also:

Neighbourhood

getResidence

public String getResidence()

Description copied from interface: ListNode

The primary residential address of the voter.

Specified by:

getResidence in interface ListNode

Returns:

null

See Also:

Registration.getResidence()

leafRegisterPath

public String leafRegisterPath()

Description copied from interface: ListNode

Returns the slash-delimited (/) path to the voter's leaf register, within the sub-hierarchy of electoral offices. Each element of the path is a service email identifier designating a single sub-register. The path is anchored in the trace register of this electoral office (which is not itself expressed as an element), and terminates with the voter's most immediate register (i.e. the leaf register). For example, if this is the Canadian national office, then the path to its Toronto leaf register might be:

register@v4ontario.ca/register@v2toronto.ca

If the trace register is the leaf register (if this is the Toronto office, for example), then a dot (.) is returned.

Specified by:

leafRegisterPath in interface ListNode

Returns:

path to voter's leaf register, or '.' if the trace register is the leaf

primaryTrustEdgeCount

public int primaryTrustEdgeCount()

Description copied from interface: ListNode

The number of primary trust extending to this node.

Specified by:

primaryTrustEdgeCount in interface ListNode

Returns:

zero

trustLevel

public int trustLevel()

Description copied from interface: ListNode

Calculates the trust level of this node. The trust level is the highest level (T) among all immediate trust sources, such that the count of sources at that level or higher (nT) is at least equal to T (nT >= T). For example, to have a trust level of 3, this node must have 3 or more immediate trust sources, each itself at level 3 or higher.

Specified by:

trustLevel in interface ListNode

Returns:

zero

voterEmail

public String voterEmail()

Description copied from interface: ListNode

Identifies the voter.

Specified by:

voterEmail in interface ListNode

Returns:

canonical email address (having no personal part)

See Also:

Registration.voterEmail()

toString

public String toString()

Returns the voter email address.

Overrides:

toString in class Object