votorola.a.count

Class CR_Vote

java.lang.Object

CommandResponder.Base

CR_Vote

All Implemented Interfaces:

CommandResponder

Direct Known Subclasses:

CR_Unvote

public class CR_Vote
extends CommandResponder.Base

Responder for the command 'vote' - to cast a vote in a poll.

See Also:

../../s/manual.xht#Poll-Response-vote

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CR_Vote.CountTablePVC A cached view of a count table restricted to a particular poll.
static class	CR_Vote.TracePair A pair of vote traces: the old trace as of last count, and a projected trace that takes into consideration the user's subsequent input if any.

Nested classes/interfaces inherited from interface CommandResponder

CommandResponder.AnonymousIssueException, CommandResponder.Base, CommandResponder.Session, CommandResponder.U

Field Summary

Fields inherited from class CommandResponder.Base

keyPrefix, voterService

Constructor Summary

Constructors

Constructor and Description
CR_Vote(PollService _poll) Constructs a CR_Vote.
CR_Vote(PollService _poll, String _keyPrefix) Constructs a CR_Vote as a subclass.

Method Summary

Methods

Modifier and Type	Method and Description
(package private) static HashMap<String,Option>	compileOptions(CommandResponder.Session session) Compiles a map of launch options.
(package private) void	echoTraces(Vote vote, CommandResponder.Session session) Appends vote traces to the reply.
void	help(CommandResponder.Session session) Calls U.
protected PollService	poll()
Exception	respond(String[] argv, CommandResponder.Session s) Responds to an invocation of the command.
protected void	writeVoteAndEcho(String newCandidateEmail, Vote vote, CommandResponder.Session session) Changes the vote and writes it to the database, and appends an echo of the change to the reply.

Methods inherited from class CommandResponder.Base

acceptsAnonymousIssue, canonicalEmail, commandName, compileBaseOptions, parse

Methods inherited from class java.lang.Object

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

Constructor Detail

CR_Vote

CR_Vote(PollService _poll)

Constructs a CR_Vote.

CR_Vote

CR_Vote(PollService _poll,
       String _keyPrefix)

Constructs a CR_Vote as a subclass.

Method Detail

help

public void help(CommandResponder.Session session)

Description copied from class: CommandResponder.Base

Calls U.helpDefault(keyPrefix,session).

Specified by:

help in interface CommandResponder

Overrides:

help in class CommandResponder.Base

respond

public Exception respond(String[] argv,
                CommandResponder.Session s)

Description copied from interface: CommandResponder

Responds to an invocation of the command.

Parameters:

argv - an array comprising the command name (index 0) and any arguments (indeces 1..*).

Returns:

any soft exception of a potentially temporary cause that might clear up on retry, or null if none occured.

compileOptions

static HashMap<String,Option> compileOptions(CommandResponder.Session session)

Compiles a map of launch options.

echoTraces

void echoTraces(Vote vote,
              CommandResponder.Session session)
          throws IOException,
                 ScriptException,
                 SQLException,
                 XMLStreamException

Appends vote traces to the reply. Appends a first trace identical to that of the last count if any, plus a second trace adjusted for subsequent changes if any.

Parameters:

session - the session with wrapping turned off in its reply builder.

Throws:

IOException

ScriptException

SQLException

XMLStreamException

poll

protected PollService poll()

writeVoteAndEcho

protected void writeVoteAndEcho(String newCandidateEmail,
                    Vote vote,
                    CommandResponder.Session session)
                         throws SQLException,
                                VoterInputTable.BadInputException

Changes the vote and writes it to the database, and appends an echo of the change to the reply.

Parameters:

session - the session with wrapping turned off in its reply builder.

Throws:

SQLException

VoterInputTable.BadInputException