votorola.s.gwt.scene.feed.ss

Class PersonJig

java.lang.Object

PersonJig

All Implemented Interfaces:

Person, SerialJig

public final class PersonJig
extends Object
implements Person, SerialJig

A mutable and serializeable person.

Constructor Summary

Constructors

Constructor and Description
PersonJig(BiteJig _bite) Constructs a PersonJig.

Method Summary

Methods

Modifier and Type	Method and Description
CountNodeW	countNode(Count count) Fetches this person's count node and caches it for reuse.
byte	dartSector() This person's dart sector as last assigned by a count.
ResidenceJig	residence() This person's primary residence.
void	serialize(com.google.gson.stream.JsonWriter out) Serializes the fields of this object in JSON form, and clears them.
void	setDartSector(CountNodeW countNode) Sets the dart sector.
ResidenceJig	setResidence() Ensures the residence is set to a jig and caches the jig for reuse.
void	setUser(IDPair _user) Sets the user identifier.
void	setVoteTrace(CountNodeW countNode) Ensures the vote trace is set.
TraceNode	traceNode(NetworkTrace trace) Fetches this person's trace node and caches it for reuse.
IDPair	user() This person's user identifier, if it is known.
String	username() This person's username.
List<PersonJig>	voteTrace() This person's vote trace according to the results of last count, exclusive of any subsequent user input.
List<PersonJig>	voteTraceProjected() An external trace projected from the voteTrace by including any subsequent input from the user's (but not of other users); or null if the original vote trace is unknown (null), or the user had no subsequent input.

Methods inherited from class java.lang.Object

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

Constructor Detail

PersonJig

public PersonJig(BiteJig _bite)

Constructs a PersonJig.

Parameters:

_bite - the parent bite jig.

Method Detail

countNode

public CountNodeW countNode(Count count)
                     throws NoSuchItem,
                            SQLException,
                            XMLStreamException

Fetches this person's count node and caches it for reuse.

Throws:

NullPointerException - if setUser() was not called

NoSuchItem

SQLException

XMLStreamException

See Also:

PollJig.count(PollService.VoteServerScope.Run)

traceNode

public TraceNode traceNode(NetworkTrace trace)
                    throws NoSuchItem,
                           SQLException

Fetches this person's trace node and caches it for reuse.

Throws:

NullPointerException - if setUser() was not called

NoSuchItem

SQLException

user

public IDPair user()

This person's user identifier, if it is known.

setUser

public void setUser(IDPair _user)

Sets the user identifier.

Throws:

IllegalStateException - if the user identifier was already set.

dartSector

public byte dartSector()

Description copied from interface: Person

This person's dart sector as last assigned by a count.

Specified by:

dartSector in interface Person

Returns:

a dart sector of 1 to 20, or zero if no dart sector is assigned, or -1 if the assignment is unknown.

See Also:

CountNode.dartSector()

setDartSector

public void setDartSector(CountNodeW countNode)

Sets the dart sector.

See Also:

countNode(Count)

residence

public ResidenceJig residence()

Description copied from interface: Person

This person's primary residence.

Specified by:

residence in interface Person

Returns:

the residence, or null if none is recorded in the bite.

setResidence

public ResidenceJig setResidence()

Ensures the residence is set to a jig and caches the jig for reuse.

Returns:

the jig that was set.

username

public String username()

Description copied from interface: Person

This person's username.

Specified by:

username in interface Person

Returns:

the username, or null if none is recorded in the bite.

See Also:

IDPair.username()

voteTrace

public List<PersonJig> voteTrace()

Description copied from interface: Person

This person's vote trace according to the results of last count, exclusive of any subsequent user input. The trace lists the person (index 0) followed by each candidate who receives the person's vote, in order of receipt. If the length of the trace is 1, then the vote is not received by any candidate; either because the person is not voting or because the vote is barred.

Specified by:

voteTrace in interface Person

Returns:

an ordered collection of Persons, the form of the collection depending on the implementation; or null if the vote trace is unknown. An unknown trace may be caused by an unmounted or unreported count on the vote server, or a bug on the server side of the bite feed.

See Also:

CountNodeW.trace()

setVoteTrace

public void setVoteTrace(CountNodeW countNode)
                  throws SQLException,
                         XMLStreamException

Ensures the vote trace is set.

Throws:

SQLException

XMLStreamException

See Also:

countNode(Count)

voteTraceProjected

public List<PersonJig> voteTraceProjected()

Description copied from interface: Person

An external trace projected from the voteTrace by including any subsequent input from the user's (but not of other users); or null if the original vote trace is unknown (null), or the user had no subsequent input.

Specified by:

voteTraceProjected in interface Person

Returns:

an ordered collection of Persons, the form of the collection depending on the implementation; or null.

See Also:

CountNodeW.trace()

serialize

public void serialize(com.google.gson.stream.JsonWriter out)
               throws IOException

Description copied from interface: SerialJig

Serializes the fields of this object in JSON form, and clears them.

Specified by:

serialize in interface SerialJig

Throws:

IOException