votorola.a.trust

Class Trustserver

java.lang.Object

VoterService

Trustserver

@ThreadRestricted(value="holds lock()")
public final class Trustserver
extends VoterService

A trust server.

See Also:

Stuff:Trustserver

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Trustserver.ConstructionContext A context for configuring the construction of a Trustserver.

Nested classes/interfaces inherited from class VoterService

VoterService.IllegalNameException, VoterService.NoSuchServiceException

Field Summary

Fields inherited from class VoterService

constructionContext, lock, name, NAME_MAX_LENGTH, NAME_PATTERN, vsRun

Method Summary

Methods

Modifier and Type	Method and Description
GoogleGeocoder	geocoder() The trustserver's facility for converting street addresses to cartographic coordinates.
TraceNode	getTraceNode(NetworkTrace trace, IDPair registrant) Retrieves a registrant's node from a compiled network trace.
static Trustserver	newTrustserver(VoteServer.Run run, JavaScriptIncluder s) Constructs a Trustserver.
(package private) List<TrustEdge.Primary>	primaryTrustList() The primary trust to extend for each trace of the trust network.
JavaScriptIncluder	runtimeConfigurationScript() The compiled runtime-configuration script for the trustserver.
File	startupConfigurationFile() The startup configuration file for this service.
String	summaryDescription() A short description that summarizes this service.
String	title() The title of this service in wiki-style title case.
NetworkTrace	traceToReport() The current network trace to report, or null if there is none.
NetworkTrace	traceToReportT() The current network trace to report, or null if there is none.

Methods inherited from class VoterService

dispatch, dispatch, equals, help, helpA_1, helpA_2, helpA_3, helpA, helpB, helpC, init, isNonPoll, lock, name, responderByClassName, responderForCommand, responders, serviceDirectory, toString, vsRun

Methods inherited from class java.lang.Object

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

Method Detail

newTrustserver

@ThreadSafe
public static Trustserver newTrustserver(VoteServer.Run run,
                                    JavaScriptIncluder s)
                                  throws IOException,
                                         ScriptException,
                                         SQLException

Constructs a Trustserver.

Parameters:

s - the compiled startup configuration script.

Throws:

IOException

ScriptException

SQLException

geocoder

@ThreadSafe
public GoogleGeocoder geocoder()

The trustserver's facility for converting street addresses to cartographic coordinates.

getTraceNode

@ThreadSafe
public TraceNode getTraceNode(NetworkTrace trace,
                                IDPair registrant)
                       throws IOException,
                              SQLException

Retrieves a registrant's node from a compiled network trace. This is a convenience method.

Parameters:

trace - the trace to use. This may be null, causing lookup the currently reported trace. Note that lookup involves locking overhead in threaded runs.

Returns:

TraceNodeW or TraceNodeIC per getOrCreate(registrant). Or, if lookup of the trace itself fails, a TraceNode0 with default values.

Throws:

IOException

SQLException

primaryTrustList

List<TrustEdge.Primary> primaryTrustList()

The primary trust to extend for each trace of the trust network.

Returns:

unmodifiable list of primary trust extensions.

See Also:

Trustserver.ConstructionContext.addPrimaryTrust(IDPair,int)

runtimeConfigurationScript

@Warning(value="thread restricted object")
public JavaScriptIncluder runtimeConfigurationScript()

The compiled runtime-configuration script for the trustserver. Its source file is located at:

~/votorola/trust/trustserver-run.js

The language is JavaScript. There are restrictions on the character encoding.

See Also:

trustserver-run.js (example script), ../manual.xht#trustserver-run.js (FIX broken docs)

traceToReport

public NetworkTrace traceToReport()
                           throws IOException,
                                  SQLException

The current network trace to report, or null if there is none.

Throws:

IOException

SQLException

See Also:

NetworkTrace.VoteServerScope.readyToReportLink()

traceToReportT

@ThreadSafe
public NetworkTrace traceToReportT()
                            throws IOException,
                                   SQLException

The current network trace to report, or null if there is none. This is just a thread safe wrapper that automatically siezes and releases the lock.

Throws:

IOException

SQLException

startupConfigurationFile

@ThreadSafe
public File startupConfigurationFile()

Description copied from class: VoterService

The startup configuration file for this service. The language is JavaScript. There are restrictions on the character encoding.

Specified by:

startupConfigurationFile in class VoterService

See Also:

../manual.xht#trustserver.js (FIX broken docs)

summaryDescription

@ThreadSafe
public String summaryDescription()

Description copied from class: VoterService

A short description that summarizes this service.

Specified by:

summaryDescription in class VoterService

See Also:

Trustserver.ConstructionContext.setSummaryDescription(String)

title

@ThreadSafe
public String title()

Description copied from class: VoterService

The title of this service in wiki-style title case. In English, that typically means only the first letter of the leading word is capitalized.

Specified by:

title in class VoterService

See Also:

Trustserver.ConstructionContext.setTitle(String)