| Switch | *Controlled state | *Default | *
|---|---|---|
| s | * *The scoping state. Its form is s={@linkplain #pollName() * poll-name}*{@linkplain #votepath() votepath}. The vote path is optional. * Examples are "s=Sys/p/sandbox" and "s=Sys/p/sandbox*9kc2". | * *None, which means all positions in all polls. | * *
When the stage is ready to be initialized, this scoping model sets the {@linkplain * Stage#setActorName(String) actor} and {@linkplain Stage#setPollName(String) poll} * according to the 's' switch. It thereafter keeps itself and the stage in synchrony. * At present it cannot synchonize to a change of actor on the stage, however, nor can it * honour the configuration of a {@linkplain Stage#getDefaultActorName() default actor}; * when these become necessary, please refer to the implementation plan in the code.
* * @see Scoping * @see Category:Position * @see votorola.a.count.CountNode#dartSector() */ final class DartScoping implements Scoping { // cf. my archived ._/PositionScoping.javas based on username rather than dart sector /** Constructs a DartScoping. * * @param _spool the spool for the release of associated holds. When unwound it * releases the holds of the instance and thereby disables it. * @throws IllegalStateException if the stage is configured with a {@linkplain * Stage#getDefaultActorName() default actor}, which is not currently * supported. */ public DartScoping( Spool _spool ) { spool = _spool; Stage.i().addInitializer( new TheatreInitializer0() // auto-removed { public @Override void initFrom( Stage _s, boolean _isReferencePending ) { init(); } // Does the reverse (init to) as part and parcel of model initialization, // but this should be entirely without effect on the stage, otherwise the // stage is wrong and needs correcting. The purpose of initFrom (aside from // triggering init) is to convey state that was persisted by the stage. But // this is unecessary for the state variables that are synchronized between // the stage and dart scoping (actor and poll) because both of these // variables are persisted and controlled by the 's' scoping switch in the // URL. This model passively obeys that switch on initialization and // enforces the same obedience on the stage. public @Override void initTo( Stage _s ) { init(); } public @Override void initTo( Stage _s, TheatrePage _referrer ) { init(); } }); } private void init() { spool.add( new Hold() // sync from page URL: { final HandlerRegistration hR = Scenes.i().sScopingSwitch().addHandler( new ValueChangeHandler
*
* char radix21Digit = DIGIT_ENCODER[radix10DartSector];
*/
static final String DIGIT_ENCODER = "0123456789bcdfghjkmnp"; // radix 21 digit
// ^0 ^10 ^20 radix 10 value
// ^30 ^62 ^70 hex character
/** An array of bytes for use in translating from radix 21 to 10. Usage:
*
* byte radix10DartSector = DIGIT_DECODER[radix21Digit - '0'];
*/
private static final byte[] DIGIT_DECODER = new byte[]
{
// 0 1 2 3 4 5 6 7 8 9 radix 21 digit
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 0, 0, 0, 0, 0, 0, // radix 10 value
// 30 31 32 33 34 35 36 37 38 39 3a 3b 3c 3d 3e 3f hex character
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
// 40 41 42 43 44 45 46 47 48 49 4a 4b 4c 4d 4e 4f
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
// 50 51 52 53 54 55 56 57 58 59 5a 5b 5c 5d 5e 5f
// b c d f g h j k m n
0, 0, 10, 11, 12, 0, 13, 14, 15, 0, 16, 17, 0, 18, 19, 0,
// 60 61 62 63 64 65 66 67 68 69 6a 6b 6c 6d 6e 6f
// p
20
// 70
};
/** The name of the poll in which the user takes a position, or null if no poll is
* specified. If no poll is specifed, then the votepath will be empty.
*
* @see votorola.a.count.Poll#name()
*/
final String pollName() { return pollName; }
private String pollName;
/** Prompts this scoping model to set the stage actor if that is wanted. This is a
* temporary workaround for the difficult task of mapping votepaths to usernames.
* Instead we depend on VotespaceV to discover the information for its own purposes
* and then to send this prompt.
*
* @param nodeOnVotepath a node that is on the current votepath, or null if a
* missing node is detected.
* @param votepathFromNode the votepath from the node to the terminal candidate,
* which may be null if the node is null.
*/
void syncActorToStage( final CountNodeJS nodeOnVotepath, final String votepathFromNode )
{
if( !syncActorToStage_isPending ) return;
if( nodeOnVotepath == null ) Stage.setActorName( null );
else
{
if( !votepath.equals( votepathFromNode )) return;
Stage.setActorName( nodeOnVotepath.name() );
}
syncActorToStage_isPending = false;
}
private boolean syncActorToStage_isPending; // guard against busy testing/setting
/** The path of a vote expressed as a sequence of count nodes, each node being
* identified by an encoded dart sector. The path extends from the voter node (index
* 0) through each candidate node that receives the vote. The dart sector of each
* node is encoded in radix 21 using the following ASCII characters as digits:
*
* {@value #DIGIT_ENCODER}
*
* Dart sectors are therefore encoded as single digits in the range 1 to p. For * example, the path of encoded digits "9kc2" decodes to sector numbers (9, 17, 11, * 2).
* * @return the votepath which may be an empty string. * * @see #dartSector(int) * @see votorola.a.count.CountNode#dartSector() */ String votepath() { return votepath; } private String votepath; private byte[] votepathDecoded; // contains no zeros // - O b j e c t ---------------------------------------------------------------------- public @Override String toString() { return "dart scope = poll(" + pollName + ") votepath(" + votepath + ")"; } // - S c o p i n g -------------------------------------------------------------------- public HandlerRegistration addHandler( final ScopeChangeHandler handler ) { return GWTX.i().bus().addHandlerToSource( ScopeChangeEvent.TYPE, /*source*/DartScoping.this, handler ); } //// P r i v a t e /////////////////////////////////////////////////////////////////////// private @Warning("init call") void rescope( final String s ) { try { if( s == null ) { rescopeToDefault(); return; } final MatchResult m = S_PATTERN.exec( s ); if( m == null ) { Window.alert( "Malformed scoping switch: s=" + s ); rescopeToDefault(); return; } pollName = m.getGroup( 1 ).replace( '!', '/' ); // we used to encode '/' thus, so we decode it for sake of old URLs final Stage st = Stage.i(); if( pollName == null ) pollName = st.getDefaultPollName(); votepath = m.getGroup( 2 ); // if any if( votepath == null ) votepath = ""; final int vN = votepath.length(); votepathDecoded = new byte[vN]; for( int v = 0; v < vN; ++v ) { final byte dartSector = DIGIT_DECODER[votepath.charAt(v) - '0']; if( dartSector == 0 ) { Window.alert( "Malformed scoping switch, votepath contains a zero: s=" + s ); rescopeToDefault(); return; } votepathDecoded[v] = dartSector; } st.setPollName( pollName ); // sync to stage if( vN == 0 ) Stage.setActorName( null ); else syncActorToStage_isPending = true; } finally{ GWTX.i().bus().fireEventFromSource( new ScopeChangeEvent(), DartScoping.this ); } } private void rescopeToDefault() { final Stage st = Stage.i(); pollName = st.getDefaultPollName(); if( st.getDefaultActorName() != null ) throw new IllegalStateException( "stage configured with default actor" ); // not supported, per API doc votepath = ""; votepathDecoded = new byte[0]; st.setPollName( pollName ); // sync to stage Stage.setActorName( null ); } /** The pattern of the 's' scoping switch. Sets group (1) to the poll name and (2) * to the encoded votepath, if any. The asterisk '*' separator was chosen because * the following were rejected for the reasons specified: