votorola.a.count

Class CountTable.PollView

java.lang.Object

CountTable.PollView

Direct Known Subclasses:

CR_Vote.CountTablePVC

Enclosing class:

CountTable

public class CountTable.PollView
extends Object

A programmatic view of a count table restricted to a particular poll. The number of polls is potentially large (millions), so rather than create a separate SQL view of each, the views are created on the fly. Hence this programmatic implementation.

Field Summary

Fields

Modifier and Type	Field and Description
(package private) String	serviceName

Constructor Summary

Constructors

Constructor and Description
CountTable.PollView(String _serviceName) Creates a PollView.

Method Summary

Methods

Modifier and Type	Method and Description
long	countBaseCandidates() Returns the number of nodes that are base candidates.
CountNodeW	get(String email) Retrieves a node from this view.
ResultSet	getByIndeces() Retrieves the primary indeces (email) of all nodes in this view.
CountNodeW	getOrCreate(String email) Retrieves a node from this view, or, if none is stored, a CountNodeIC with default values.
List<CountNodeW>	listByRankIndeces(long first, long lastBound) Retrieves a list of nodes by rank indeces.
void	run(String sqlTail, CountNodeW.Runner runner) Pass all nodes of this view through the specified runner.
void	runCasters(String candidateEmail, String sqlTail, CountNodeW.Runner runner) Pass through the specified runner all nodes that are voting directly for the specified candidate.
void	runGroup(String groupCandidateEmail, String sqlTail, CountNodeW.Runner runner) Pass through the specified runner all nodes of a group centered on a candidate.
CountTable	table() The larger table of this view.

Methods inherited from class java.lang.Object

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

Field Detail

serviceName

final String serviceName

Constructor Detail

CountTable.PollView

CountTable.PollView(String _serviceName)

Creates a PollView.

Parameters:

_serviceName - the identifier of the poll

Method Detail

countBaseCandidates

public final long countBaseCandidates()
                               throws SQLException

Returns the number of nodes that are base candidates.

Throws:

SQLException

See Also:

theory.xht#base-candidate

get

public CountNodeW get(String email)
               throws SQLException,
                      XMLStreamException

Retrieves a node from this view.

Returns:

node as stored in the view; or null, if none is stored.

Throws:

SQLException

XMLStreamException

getByIndeces

@ThreadRestricted(value="holds CountTable.this.database")
public ResultSet getByIndeces()
                       throws SQLException

Retrieves the primary indeces (email) of all nodes in this view. The caller is responsible for closing the returned result set when finished with it.

Throws:

SQLException

getOrCreate

public CountNodeW getOrCreate(String email)
                       throws SQLException,
                              XMLStreamException

Retrieves a node from this view, or, if none is stored, a CountNodeIC with default values.

Throws:

SQLException

XMLStreamException

listByRankIndeces

public final List<CountNodeW> listByRankIndeces(long first,
                                 long lastBound)
                                         throws SQLException,
                                                XMLStreamException

Retrieves a list of nodes by rank indeces. The list includes all nodes indexed from first (inclusive) to lastBound (exclusive). It is pre-sorted from low to high.

Throws:

SQLException

XMLStreamException

run

public final void run(String sqlTail,
       CountNodeW.Runner runner)
               throws SQLException,
                      XMLStreamException

Pass all nodes of this view through the specified runner.

Parameters:

sqlTail - the tail of the SQL command for appending after the WHERE clause. This is currently mandatory only because all clients require it anyway.

Throws:

SQLException

XMLStreamException

runCasters

public final void runCasters(String candidateEmail,
              String sqlTail,
              CountNodeW.Runner runner)
                      throws SQLException,
                             XMLStreamException

Pass through the specified runner all nodes that are voting directly for the specified candidate.

Parameters:

sqlTail - the tail of the SQL command for appending after the WHERE clause. This is formally mandatory only because all clients happen to require it.

Throws:

SQLException

XMLStreamException

runGroup

public final void runGroup(String groupCandidateEmail,
            String sqlTail,
            CountNodeW.Runner runner)
                    throws SQLException,
                           XMLStreamException

Pass through the specified runner all nodes of a group centered on a candidate. This means the candidate node itself, plus each node that is voting directly for the candidate.

Parameters:

sqlTail - the tail of the SQL command for appending after the WHERE clause. This is formally mandatory only because all clients happen to require it. The tail must end with a right bracket ')'.

Throws:

SQLException

XMLStreamException

table

public final CountTable table()

The larger table of this view.