| Key | *Value | *Default | *
|---|---|---|
| p | * *The name of the poll. * Slash characters (/) are technically not allowed here * and may therefore be encoded as exclamation marks (!). | * *Null, resulting in a 303 (see other) redirect that fills in the name of * the {@linkplain Poll#TEST_POLL_NAME test poll}. | * *
| reconstruct | * *Whether to construct the poll from scratch. A value of 'y' constructs the * poll from scratch by ignoring any cached configuration items, while 'n' * constructs it normally. Use 'y' after modifying the definition of the poll * (or one of dependencies) on the wiki side, in order to see the effect on the * server side immediately. Normally there would be a delay of indeterminate * duration. | * *'n' | * *
This method may also do a 301 (permanent) redirect in response to obsolete * parameter values. Currently these include polls that had to be moved to new names * for technical reasons.
* * @return the value of the 'p' parameter. */ public static String maybeRedirect_P( final Class pageClass, final PageParameters pP, final VRequestCycle cycle ) { final String p = pP.get( "p" ).toString(); if( p == null ) { pP.set( "p", Poll.U.toQuery( Poll.TEST_POLL_NAME )); throw new RedirectException( cycle.uriFor(pageClass,pP).toASCIIString(), 303 ); } String area = null; if( p.equals( "BGE" )) area = "De"; else if( p.equals( "de" )) area = "G"; else if( p.equals( "edor" )) area = "G"; else if( p.equals( "grfin" )) area = "Tor"; else if( p.equals( "m" )) area = "Tor"; else if( p.equals( "MetaGov" )) area = "G"; else if( p.equals( "Piraten" )) area = "De"; else if( p.equals( "sandbox" )) area = "G"; else if( p.equals( "tsmp" )) area = "Tor"; else if( p.equals( "tsmpp" )) area = "Tor"; else if( p.equals( "vohall" )) area = "G"; else if( p.equals( "vop" )) area = "G"; else if( p.equals( "w19c" )) area = "Tor"; else if( p.equals( "w20c" )) area = "Tor"; else if( p.equals( "wpe" )) area = "G"; if( area != null ) { pP.set( "p", area + "!p!" + p ); throw new RedirectException( cycle.uriFor(pageClass,pP).toASCIIString(), 301 ); } return p; } /** Fetches the poll corresponding to the specified service name. * * @see #ensurePoll(Class,PageParameters,VRequestCycle) * @see #pollOrNullFor(PageParameters,VRequestCycle) * @see PollFetcher#poll() */ static PollService pollFor( final String name, final VRequestCycle cycle ) throws IOException, ScriptException, SQLException { return pollFor( name, cycle, /*logWriter*/null ); } private static PollService pollFor( final String name, final VRequestCycle cycle, final PrintWriter logWriter ) throws IOException, ScriptException, SQLException { final PollService.VoteServerScope.Run vsRunPS = VOWicket.get().vsRun().scopePoll(); try { return logWriter == null? vsRunPS.ensurePoll( name ): vsRunPS.constructCachedPoll( name, logWriter ); } catch( VoterService.IllegalNameException x ) { VSession.get().error( "Unable to fetch poll \"" + name + "\": " + x.toString() ); throw new RestartResponseException( new WP_Message() ); } } /** Fetches the poll corresponding to query parameter 'p', if it is specified. * * @return poll, or null if none is specified. * * @see #pollFor(String,VRequestCycle) */ static PollService pollOrNullFor( final PageParameters pP, final VRequestCycle cycle ) throws IOException, ScriptException, SQLException { final String p = pP.get( "p" ).toString(); return p == null? null: pollFor( Poll.U.toName(p), cycle ); } /** Returns the specified page parameters (pP) with a value for the poll parameter * ('p') as recalled from the session. If a value is recalled but pP is null, then * pP is automatically constructed. * * @param pP the parameter map, which may be null. */ static PageParameters withRecall_p( PageParameters pP ) { final String lastName = VSession.get().scopePoll().getLastName(); if( lastName != null ) pP = PageParametersX.withSet( pP, "p", Poll.U.toQuery(lastName) ); return pP; } // - T a b b e d - P a g e ------------------------------------------------------------ /** @see #NAV_TAB */ public NavTab navTab( VRequestCycle cycle ) { return NAV_TAB; } /** The navigation tab that fetches the poll overview page, an instance of WP_Poll. */ static final NavTab NAV_TAB = new PollTab(); // ==================================================================================== /** A serializeable container for a poll and its latest count. */ static @ThreadRestricted("wicket") final class PollFetcher implements Serializable { private static final long serialVersionUID = 0L; /** Constructs a poll fetcher. */ PollFetcher( final PollService poll ) { pollName = poll.name(); pollOrNull = poll; } /** Constructs a poll fetcher. */ PollFetcher( final String pollName, final VRequestCycle cycle ) { this.pollName = pollName; poll( cycle ); // in anticipation, taking advantage of the cycle reference } private final String pollName; // -------------------------------------------------------------------------------- /** The latest count, or null if there is none. */ Count countToReport() { if( countOrNull == null && !"".equals(count_readyDirectoryPath) ) // for a newly constructed 'this', or deserialized one that had a count { try { countOrNull = poll().countToReportT(); } catch( Exception x ) { throw VotorolaRuntimeException.castOrWrapped( x ); } // IOx or SQLx, not much expected final String path; if( countOrNull == null ) path = ""; else path = countOrNull.readyDirectory().getPath(); if( count_readyDirectoryPath == null ) count_readyDirectoryPath = path; else if( !count_readyDirectoryPath.equals( path )) { throw new VotorolaRuntimeException( "The poll has been recounted since this page was constructed. FIX this to show the user a WP_Message, with a link to new page." ); } } if( countOrNull != null && !countOrNull.readyDirectory().isMounted() ) { throw new VotorolaRuntimeException( "The poll count has been unmounted since this page was constructed. FIX this to show the user a WP_Message, with a link to new page." ); } return countOrNull; } private transient Count countOrNull; private String count_readyDirectoryPath; /** The poll. */ PollService poll() { return poll( VRequestCycle.get() ); } PollService poll( final VRequestCycle cycle ) { if( pollOrNull == null && pollName != null ) { try { pollOrNull = pollFor( pollName, cycle ); // for a newly constructed or deserialized 'this' } catch( Exception x ) { throw VotorolaRuntimeException.castOrWrapped( x ); } // IOException, ScriptException, SQLException } return pollOrNull; } private transient PollService pollOrNull; } // ==================================================================================== private static @ThreadSafe final class PollTab extends NavTab { public @Override Bookmark bookmark() { return new Bookmark( WP_Poll.class, withRecall_p(null) ); } public @Override Class pageClass() { return WP_Poll.class; } public @Override String shortTitle( VRequestCycle cycle ) { return cycle.bunW().l( "s.wic.count.WP_Poll.tab.shortTitle" ); } } // ==================================================================================== /** Session scope for instances of WP_Poll. * * @see VSession#scopePoll() */ public static @ThreadSafe class SessionScope implements Serializable { private static final long serialVersionUID = 0L; /** Constructs a SessionScope. */ public SessionScope( VSession session ) { this.session = session; } private final VSession session; // -------------------------------------------------------------------------------- /** The last poll-name fore-navigated to, or null if there is none. * * @see #setLastName(String) */ public String getLastName() { return lastName; } // Maybe the only code that absolutely needs this is in the supertab page // WP_CountEngine, which currently isn't rendered. private volatile String lastName = null; /** Sets the last poll-name fore-navigated to. * * @see #getLastName() */ public void setLastName( final String newLastName ) { final String oldLastName = lastName; // snapshot copy, for atomic test/return if( ObjectX.nullEquals( newLastName, oldLastName )) return; lastName = newLastName; session.dirty(); // per Session API } // /** The last node fore-navigated to, or null. If the optional correction is // * enabled and the current page is divisional, then ensureLast() will first be // * called using the current page path; thus correcting for any back-navigation. // * // * @see #getLast() // */ // public DivisionalNode lastNodeDisplayed( final DivisionalStratum stratum, // cf. votorola.a.voter.WC_VoterNavigator.SessionScope.lastVoterEmailDisplayed // final boolean correctForCurrent, final VRequestCycle cycle ) // { // DivisionalPath lastPath = null; // if( correctForCurrent ) // { // final Page page = cycle.responsePage(); // if( page instanceof DivisionalPage ) // { // lastPath = ensureLast( ((DivisionalPage)page).divisionalPath() ); // } // } // if( lastPath == null ) lastPath = last; // // return stratum.getNodeOnPath( lastPath ); // } /// Ripped out of old divisional code. Saved here as an example of handling the back /// button, if ever needed again. } }