votorola.a.register
Interface Registration

All Superinterfaces:

Serializable

All Known Implementing Classes:

Registration1, RegistrationC

public interface Registration
extends Serializable

A voter's input to a register, backed by a row of the register's voter input table.

Field Summary

static short	TRUST_DESTINATIONS_MAX Limiting the number of trust destinations, in order to prevent a DoS attack.
static boolean	WRITEABLE_ALL_DEFAULT

Method Summary

String	getLink() A Web link in URI format, pointing to general information about the voter.
String	getName() The name of the voter.
String	getNote() A short note explaining or commenting on this registration.
String	getResidence() The primary residential address of the voter.
boolean	isWriteableAll() Returns true if the simple fields of this registration are generally writeable by other registrants, or false if they are exclusively writeable by the owning registrant.
List<String>	trustDestinations() Returns the list of voters to whom trust edges are to be extended.
String	voterEmail() Identifies the voter (registrant) by email address.

Field Detail

WRITEABLE_ALL_DEFAULT

static final boolean WRITEABLE_ALL_DEFAULT

See Also:

Constant Field Values

TRUST_DESTINATIONS_MAX

static final short TRUST_DESTINATIONS_MAX

Limiting the number of trust destinations, in order to prevent a DoS attack.

See Also:

Constant Field Values

Method Detail

getLink

String getLink()

A Web link in URI format, pointing to general information about the voter.

Returns:

link, or null if there is none

getName

String getName()

The name of the voter.

Returns:

name, or null if unknown

getNote

String getNote()

A short note explaining or commenting on this registration.

Returns:

note, or null if there is none

getResidence

String getResidence()

The primary residential address of the voter.

Returns:

residential address, or null if unknown

isWriteableAll

boolean isWriteableAll()

Returns true if the simple fields of this registration are generally writeable by other registrants, or false if they are exclusively writeable by the owning registrant. If the fields are generally writeable (the initial state of a new registration), then any authenticated registrant with sufficient trust may alter them. However, as soon as any field is altered by the owning registrant, then the state of this variable switches permanently to false.

The main purpose of this feature is to support pre-registration of candidates, by voters.

See Also:

WRITEABLE_ALL_DEFAULT

trustDestinations

List<String> trustDestinations()

Returns the list of voters to whom trust edges are to be extended. The list is backed by this instance of registration, and will reflect any subsequent changes to it.

Returns:

unmodifiable list of voter email addresses

See Also:

TRUST_DESTINATIONS_MAX

voterEmail

String voterEmail()

Identifies the voter (registrant) by email address. The identifier is case sensitive.

Some parts of an email address (the domain name) are technically case insensitive. It is therefore possible for two identifiers to refer to the same mailbox (user@domain.dom and user@DoMain.com for example). Whether or not the two refer to the same person is a question for the trust network to sort out. The authentication issues are equivalent to those of someone posing under two separate mailboxes.

Returns:

canonical email address (having no personal part)

See Also:

http://en.wikipedia.org/wiki/E-mail_address