votorola.a.trust

Class TraceNodeW

java.lang.Object

TraceNodeW

All Implemented Interfaces:

Serializable, TraceNode

Direct Known Subclasses:

TraceNodeIC

@ThreadRestricted(value="single writer, readers touch")
public class TraceNodeW
extends Object
implements TraceNode

A writable node in a network trace.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	TraceNodeW.Runner A routine that runs in the context of a trace node.
static class	TraceNodeW.Table The relational store of nodes that (in part) backs a network trace.

Constructor Summary

Constructors

Constructor and Description
TraceNodeW(IDPair registrant) Creates a TraceNodeW with all variables at default values.
TraceNodeW(IDPair registrant, String area, String countryCode, String geohandle, String otherProperties) Creates a TraceNodeW.

Method Summary

Methods

Modifier and Type	Method and Description
(package private) void	attachTrustEdge(int trustLevel0) Attaches a trust edge to this node.
(package private) void	detachTrustEdge(int trustLevel0) Detaches a trust edge from this node.
String	getArea() The registrant's local area of residence, or null if unspecified.
String	getCountryCode() The registrant's country of residence in ISO_3166-1 alpha-2 form, or null if unspecified.
String	getGeohandle() The normalized, geo-locatable address string for the registrant's primary residential address.
String	getOtherProperties() Other registration properties.
int	primaryTrustEdgeCount() The number of primary trust edges extending to this node.
IDPair	registrant() The registrant.
String	toString() Returns the registrant's username.
(package private) void	toXML(Set<String> divisions, Appendable a) Serializes this node in XML format.
int	trustLevel() Calculates the trust level of this node.
(package private) void	write(TraceNodeW.Table table) Writes this node to the table if it has unwritten changes.

Methods inherited from class java.lang.Object

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

Constructor Detail

TraceNodeW

TraceNodeW(IDPair registrant)

Creates a TraceNodeW with all variables at default values.

TraceNodeW

TraceNodeW(IDPair registrant,
          String area,
          String countryCode,
          String geohandle,
          String otherProperties)

Creates a TraceNodeW.

Method Detail

attachTrustEdge

final void attachTrustEdge(int trustLevel0)

Attaches a trust edge to this node. The change may affect the trust level of this node, but is not automatically propagated to other nodes.

Parameters:

trustLevel0 - trust level of source node, or Integer.MAX_VALUE for infinity

See Also:

detachTrustEdge(int), trustLevel()

detachTrustEdge

final void detachTrustEdge(int trustLevel0)

Detaches a trust edge from this node. The change may affect the trust level of this node, but is not automatically propagated to other nodes.

Parameters:

trustLevel0 - trust level of source node

See Also:

attachTrustEdge(int)

toXML

void toXML(Set<String> divisions,
         Appendable a)
     throws IOException

Serializes this node in XML format.

Throws:

BadInputException

IOException

write

final void write(TraceNodeW.Table table)
          throws SQLException

Writes this node to the table if it has unwritten changes.

Throws:

SQLException

getArea

public final String getArea()

Description copied from interface: TraceNode

The registrant's local area of residence, or null if unspecified. This is used only for multi-area streetwikis.

Specified by:

getArea in interface TraceNode

See Also:

Property:Area

getCountryCode

public final String getCountryCode()

Description copied from interface: TraceNode

The registrant's country of residence in ISO_3166-1 alpha-2 form, or null if unspecified.

Specified by:

getCountryCode in interface TraceNode

See Also:

Property:Country_code

getGeohandle

public final String getGeohandle()

Description copied from interface: TraceNode

The normalized, geo-locatable address string for the registrant's primary residential address.

Specified by:

getGeohandle in interface TraceNode

Returns:

geohandle, or null if unknown.

See Also:

Property:Geohandle

getOtherProperties

public final String getOtherProperties()

Description copied from interface: TraceNode

Other registration properties. These are formatted as an XML element named 'other', which may have any content. The content is set by intermediation of the local administrator's votrace.js script.

Specified by:

getOtherProperties in interface TraceNode

Returns:

XML element named 'other'; or null, if there are no other properties

See Also:

Working example of votrace.js

primaryTrustEdgeCount

public final int primaryTrustEdgeCount()

Description copied from interface: TraceNode

The number of primary trust edges extending to this node.

Specified by:

primaryTrustEdgeCount in interface TraceNode

registrant

public IDPair registrant()

Description copied from interface: TraceNode

The registrant.

Specified by:

registrant in interface TraceNode

trustLevel

public final int trustLevel()

Description copied from interface: TraceNode

Calculates the trust level of this node. The trust level is the highest level (T) among all immediate trust sources, such that the count of sources at that level or higher (nT) is at least equal to T (nT >= T). For example, to have a trust level of 3, this node must have 3 or more immediate trust sources, each itself at level 3 or higher.

Specified by:

trustLevel in interface TraceNode

See Also:

attachTrustEdge(int)

toString

public final String toString()

Returns the registrant's username.

Overrides:

toString in class Object