votorola.s.gwt.scene.vote

Class Votespace

java.lang.Object

Votespace

All Implemented Interfaces:

HasHandlers, ProvidesKey<SacJS>, SelectionChangeEvent.HasSelectionChangedHandlers, SelectionModel<SacJS>, SacSelection, Hold, Scene

public final class Votespace
extends Object
implements Hold, Scene, SacSelection

A social scene structured on lines of formal assent in regard to a particular issue. It relies on dart scoping to provide a degree of structural stability in dependent views.

State changes are effected as late as the "finally" phase. Associated change events are subsequently dispatched in the "deferred" phase where they appear atomic regardless of the number of state variables involved.

See Also:

VotespaceV

Nested Class Summary

Nested classes/interfaces inherited from interface Scene

Scene.SwitchMnemonic

Nested classes/interfaces inherited from interface com.google.gwt.view.client.SelectionModel

SelectionModel.AbstractSelectionModel<T>

Field Summary

Fields inherited from interface SacSelection

A_PATTERN

Constructor Summary

Constructors

Constructor and Description
Votespace() Constructs a Votespace.

Method Summary

Methods

Modifier and Type	Method and Description
HandlerRegistration	addSelectionChangeHandler(SelectionChangeEvent.Handler handler)
Switch	aSacSwitch() The 'a' superaccount selection switch (which ought not to be a switch).
CountJS	count() The count that is currently shown, or null if none is shown.
(package private) byte	dartSector(int v) Decodes the dart sector for the specified offset along the votepath.
(package private) JSONPAtomizer<CountCache.WAPResponse>	exchangeAtomizerS() The atomizer for request/response exchanges related to scoping, such as for counts and count nodes.
void	fireEvent(GwtEvent<?> e)
Object	getKey(SacJS item)
SacJS	getSac() The superaccount that is currently selected, or null if none is selected.
boolean	inScope(BiteJS bite) Tests whether the specified bite is within the current scope of this scene.
boolean	isSelected(SacJS s)
(package private) String	pollName() The name of the poll that is shown, or null if no poll is shown.
void	release() Releases this hold.
void	setSac(SacJS newSac) Sets the superaccount that is currently selected.
void	setSelected(SacJS s, boolean toSelect)
(package private) void	syncActorToStage(CountNodeJS _nodeOnVotepath, String _votepathFromNode) Prompts the scoping model to set the stage actor if that is wanted.
(package private) String	votepath() The votepath that is shown.

Methods inherited from class java.lang.Object

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

Constructor Detail

Votespace

public Votespace()

Constructs a Votespace. Call release() when done with it.

Method Detail

dartSector

byte dartSector(int v)

Decodes the dart sector for the specified offset along the votepath.

Parameters:

v - the character offset along the votepath.

Returns:

a dart sector of 1 to 20.

See Also:

votepath(), CountNode.dartSector()

exchangeAtomizerS

JSONPAtomizer<CountCache.WAPResponse> exchangeAtomizerS()

The atomizer for request/response exchanges related to scoping, such as for counts and count nodes.

pollName

final String pollName()

The name of the poll that is shown, or null if no poll is shown. The value is bound via the event bus to property name pollName. When no poll is shown the count is always null and the votepath empty. When a new poll is shown the count may intially be null until it is fetched from the server.

See Also:

count(), votepath(), Category:Poll

syncActorToStage

void syncActorToStage(CountNodeJS _nodeOnVotepath,
                    String _votepathFromNode)

Prompts the scoping model to set the stage actor if that is wanted.

See Also:

DartScoping.syncActorToStage(CountNodeJS,String)

votepath

String votepath()

The votepath that is shown. The value is bound via the event bus to property name votepath, except that no event is fired when the poll name or count changes.

See Also:

count(), pollName(), DartScoping.votepath()

fireEvent

public void fireEvent(GwtEvent<?> e)

Specified by:

fireEvent in interface HasHandlers

release

public void release()

Description copied from interface: Hold

Releases this hold.

Specified by:

release in interface Hold

inScope

public boolean inScope(BiteJS bite)

Tests whether the specified bite is within the current scope of this scene. The scope is controlled by a dart scoping model that bounds and filters the scene. Scoping is deep: each particular tree or branch includes all uptree branches. If no scope is specified by the scoping model, then the whole forest is included by default; if no poll is specified, then the scope is unlimited.

Specified by:

inScope in interface Scene

See Also:

Scoping

getKey

public Object getKey(SacJS item)

Specified by:

getKey in interface ProvidesKey<SacJS>

aSacSwitch

public Switch aSacSwitch()

The 'a' superaccount selection switch (which ought not to be a switch). It directly controls which superaccount is selected. The form of the switch value is defined by A_PATTERN. This ought not to be a switch and should be recoded when work resumes on the RAC. Account selection is not really a structural change to the UI and should not be stored as navigable state. See Scenes for the reason. If no value is specified in the URL, then it is taken to designate the vote superaccount.

Specified by:

aSacSwitch in interface SacSelection

See Also:

SacSelection.getSac()

count

public CountJS count()

Description copied from interface: SacSelection

The count that is currently shown, or null if none is shown. The value is bound via the event bus to property name count.

Specified by:

count in interface SacSelection

See Also:

pollName()

getSac

public SacJS getSac()

Description copied from interface: SacSelection

The superaccount that is currently selected, or null if none is selected. Null occurs only if no count is shown.

Specified by:

getSac in interface SacSelection

See Also:

SacSelection.setSac(SacJS)

setSac

public void setSac(SacJS newSac)

Description copied from interface: SacSelection

Sets the superaccount that is currently selected. It is equivalent to:

     setSelected( newSac, true );

Setting the superaccount to null, or explicitly deselecting it, does not have the effect of actual deselection. Rather it selects the null superaccount.

Specified by:

setSac in interface SacSelection

See Also:

SacSelection.getSac()

addSelectionChangeHandler

public HandlerRegistration addSelectionChangeHandler(SelectionChangeEvent.Handler handler)

Specified by:

addSelectionChangeHandler in interface SelectionChangeEvent.HasSelectionChangedHandlers

Specified by:

addSelectionChangeHandler in interface SelectionModel<SacJS>

isSelected

public boolean isSelected(SacJS s)

Specified by:

isSelected in interface SelectionModel<SacJS>

setSelected

public void setSelected(SacJS s,
               boolean toSelect)

Specified by:

setSelected in interface SelectionModel<SacJS>