org.apache.wicket.RequestCycle Maven / Gradle / Ivy
Show all versions of org.ops4j.pax.wicket.service Show documentation
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.wicket;
import java.util.Collection;
import java.util.Iterator;
import java.util.Map;
import java.util.Map.Entry;
import org.apache.wicket.behavior.IBehavior;
import org.apache.wicket.protocol.http.BufferedWebResponse;
import org.apache.wicket.protocol.http.IRequestLogger;
import org.apache.wicket.protocol.http.PageExpiredException;
import org.apache.wicket.protocol.http.servlet.ServletWebRequest;
import org.apache.wicket.request.AbstractRequestCycleProcessor;
import org.apache.wicket.request.ClientInfo;
import org.apache.wicket.request.IRequestCycleProcessor;
import org.apache.wicket.request.RequestParameters;
import org.apache.wicket.request.target.coding.WebRequestEncoder;
import org.apache.wicket.request.target.component.BookmarkableListenerInterfaceRequestTarget;
import org.apache.wicket.request.target.component.BookmarkablePageRequestTarget;
import org.apache.wicket.request.target.component.ComponentRequestTarget;
import org.apache.wicket.request.target.component.IBookmarkablePageRequestTarget;
import org.apache.wicket.request.target.component.IPageRequestTarget;
import org.apache.wicket.request.target.component.PageIdRequestTarget;
import org.apache.wicket.request.target.component.PageReferenceRequestTarget;
import org.apache.wicket.request.target.component.PageRequestTarget;
import org.apache.wicket.request.target.component.listener.BehaviorRequestTarget;
import org.apache.wicket.request.target.component.listener.ListenerInterfaceRequestTarget;
import org.apache.wicket.request.target.resource.SharedResourceRequestTarget;
import org.apache.wicket.util.collections.ArrayListStack;
import org.apache.wicket.util.string.AppendingStringBuffer;
import org.apache.wicket.util.string.Strings;
import org.apache.wicket.util.time.Time;
import org.apache.wicket.util.value.ValueMap;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* Represents the processing of a request. It is responsible for instructing the
* {@link IRequestCycleProcessor request cycle processor} to execute the various steps there are in
* the handling of a request (resolving the kind of work that needs to be done, handling of events
* and generating a response), and it holds the intended {@link IRequestTarget request target},
* which is an abstraction for e.g. the processing of a bookmarkable page.
*
* The abstract urlFor() methods are implemented by subclasses of RequestCycle and return encoded
* page URLs. The URL returned depends on the kind of page being linked to. Pages broadly fall into
* two categories:
*
*
*
* 1.
* A page that does not yet exist in a user Session may be encoded as a URL that references the
* not-yet-created page by class name. A set of PageParameters can also be encoded into the URL, and
* these parameters will be passed to the page constructor if the page later needs to be
* instantiated.
*
* Any page of this type is bookmarkable, and a hint to that effect is given to the user in the URL:
*
*
* /[Application]?bookmarkablePage=[classname]&[param]=[value] [...]
*
*
* Bookmarkable pages must either implement a constructor that takes a PageParameters argument or a
* default constructor. If a Page has both constructors the constructor with the PageParameters
* argument will be used. Links to bookmarkable pages are created by calling the urlFor(Class,
* PageParameters) method, where Class is the page class and PageParameters are the parameters to
* encode into the URL.
*
*
*
* 2.
* Stateful pages (that have already been requested by a user) will be present in the user's
* Session and can be referenced securely with a session-relative number:
*
*
* /[Application]?wicket:interface=[pageMapName]:[pageId]: ...
*
*
* Often, the reason to access an existing session page is due to some kind of "postback" (either a
* link click or a form submit) from a page (possibly accessed with the browser's back button or
* possibly not). A call to a registered listener is dispatched like so:
*
*
* /[Application]?wicket:interface=[pageMapName]:[pageId]:[componentPath]:[version]:[interfaceName]
*
*
* For example:
*
*
* /[Application]?wicket:interface=:3:signInForm:submit::IFormSubmitListener
*
*
*
*
*
* URLs for stateful pages (those that already exist in the session map) are created by calling the
* urlFor(Component, Class) method, where Component is the component being linked to and Class is
* the interface on the component to call.
*
* For pages falling into the second category, listener interfaces cannot be invoked unless they
* have first been registered via the static registerSecureInterface() method. This method ensures
* basic security by restricting the set of interfaces that outsiders can call via GET and POST
* requests. Each listener interface has a single method which takes only a RequestCycle parameter.
* Currently, the following classes register the following kinds of listener interfaces:
*
*
*
* Class
* Interface
* Purpose
*
*
* Form
* IFormSubmitListener
* Handle form submits
*
*
* Image
* IResourceListener
* Respond to image resource requests
*
*
* Link
* ILinkListener
* Respond to link clicks
*
*
* Page
* IRedirectListener
* Respond to redirects
*
*
*
* The redirectToInterceptPage() and continueToOriginalDestination() methods can be used to
* temporarily redirect a user to some page. This is mainly intended for use in signing in users who
* have bookmarked a page inside a site that requires the user be authenticated before they can
* access the page. When it is discovered that the user is not signed in, the user is redirected to
* the sign-in page with redirectToInterceptPage(). When the user has signed in, they are sent on
* their way with continueToOriginalDestination(). These methods could also be useful in
* "interstitial" advertising or other kinds of "intercepts".
*
*
* @author Jonathan Locke
* @author Eelco Hillenius
* @author Igor Vaynberg (ivaynberg)
*/
public abstract class RequestCycle
{
/** Thread-local that holds the current request cycle. */
private static final ThreadLocal current = new ThreadLocal();
/** Cleaning up after responding to a request. */
private static final int DETACH_REQUEST = 5;
/** Request cycle processing is done. */
private static final int DONE = 6;
/** Log */
private static final Logger log = LoggerFactory.getLogger(RequestCycle.class);
/** No processing has been done. */
private static final int NOT_STARTED = 0;
/** Starting the actual request processing. */
private static final int PREPARE_REQUEST = 1;
/** Dispatching and handling of events. */
private static final int PROCESS_EVENTS = 3;
/** Resolving the {@link RequestParameters} object to a request target. */
private static final int RESOLVE_TARGET = 2;
/** Responding using the currently set {@link IRequestTarget}. */
private static final int RESPOND = 4;
/** MetaDataEntry array. */
private MetaDataEntry[] metaData;
/** true if wicket handled this request, false otherwise */
private boolean handled = true;
/**
* Gets request cycle for calling thread.
*
* @return Request cycle for calling thread
*/
public static RequestCycle get()
{
return current.get();
}
/**
* Sets the request cycle for the calling thread. You typically DO NOT NEED to call this method,
* as the request cycle is set to current for you in the constructor. However, if you have a very special need to set it to
* something else, you can expose this method.
*
* @param cycle
* The request cycle to set current
*/
protected static void set(RequestCycle cycle)
{
current.set(cycle);
}
private RequestCycle previousOne = null;
/**
* True if the request cycle should automatically clear feedback messages after processing. True
* by default.
*/
private boolean automaticallyClearFeedbackMessages = true;
/** The current stage of event processing. */
private int currentStep = NOT_STARTED;
private boolean handlingException = false;
/** The original response the request cycle was created with. */
private final Response originalResponse;
/**
* True if request should be redirected to the resulting page instead of just rendering it back
* to the user.
*/
private boolean redirect;
/** holds the stack of set {@link IRequestTarget}, the last set on top. */
private transient final ArrayListStack requestTargets = new ArrayListStack(
3)
{
private static final long serialVersionUID = 1L;
@Override
public void add(int arg0, IRequestTarget arg1)
{
onRequestTargetSet(arg1);
super.add(arg0, arg1);
}
@Override
public boolean add(IRequestTarget arg0)
{
onRequestTargetSet(arg0);
return super.add(arg0);
}
@Override
public boolean addAll(Collection c)
{
Iterator it = c.iterator();
while (it.hasNext())
{
onRequestTargetSet(it.next());
}
return super.addAll(c);
}
@Override
public boolean addAll(int index, Collection c)
{
Iterator it = c.iterator();
while (it.hasNext())
{
onRequestTargetSet(it.next());
}
return super.addAll(index, c);
}
};
/**
* Any page parameters. Only set when the request is resolving and the parameters are passed
* into a page.
*/
private PageParameters pageParameters;
/** The session object. */
private Session session;
/** the time that this request cycle object was created. */
private final long startTime = System.currentTimeMillis();
/** The application object. */
protected final Application application;
/** The processor for this request. */
protected final IRequestCycleProcessor processor;
/** The current request. */
protected Request request;
/** The current response. */
protected Response response;
/**
* Boolean if the next to be encoded url is targeting a new window (ModalWindow, Pop-up, tab).
* This temporary flag is specifically needed for Portlet-support as then such a page needs a
* special target (Resource) url. After each urlFor call, this flag is reset to false.
*/
private transient boolean urlForNewWindowEncoding;
/**
* Constructor. This instance will be set as the current one for this thread.
*
* @param application
* The application
* @param request
* The request
* @param response
* The response
*/
protected RequestCycle(final Application application, final Request request,
final Response response)
{
this.application = application;
this.request = request;
this.response = response;
originalResponse = response;
processor = safeGetRequestProcessor();
previousOne = current.get();
// Set this RequestCycle into ThreadLocal variable
current.set(this);
}
/**
* Gets the application object.
*
* @return Application interface
*/
public final Application getApplication()
{
return application;
}
/**
* Gets the new agent info object for this session. This method calls
* {@link Session#getClientInfo()}, which may or may not cache the client info object and
* typically calls {@link #newClientInfo()} when no client info object was cached.
*
* @return the agent info object based on this request
*/
public final ClientInfo getClientInfo()
{
return getSession().getClientInfo();
}
/**
* Get the original response the request was created with. Access may be necessary with the
* response has temporarily being replaced but your components requires access to lets say the
* cookie methods of a WebResponse.
*
* @return The original response object.
*/
public final Response getOriginalResponse()
{
return originalResponse;
}
/**
* Any set page parameters. Typically only available when a request to a bookmarkable page with
* a {@link Page#Page(PageParameters)} constructor was made.
*
* @return the page parameters or null
*/
public final PageParameters getPageParameters()
{
return pageParameters;
}
/**
* Gets the processor for delegated request cycle handling.
*
* @return the processor for delegated request cycle handling
*/
public abstract IRequestCycleProcessor getProcessor();
/**
* Gets whether the page for this request should be redirected.
*
* @return whether the page for this request should be redirected
* @deprecated Use {@link #isRedirect()} instead
*/
@Deprecated
public final boolean getRedirect()
{
return isRedirect();
}
/**
* Gets the request.
*
* @return Request object
*/
public final Request getRequest()
{
return request;
}
/**
* Gets the current request target. May be null.
*
* @return the current request target, null if none was set yet.
*/
public final IRequestTarget getRequestTarget()
{
return (!requestTargets.isEmpty()) ? (IRequestTarget)requestTargets.peek() : null;
}
/**
* Gets the response.
*
* @return Response object
*/
public final Response getResponse()
{
return response;
}
/**
* Gets the page that is to be rendered for this request in case the last set request target is
* of type {@link PageRequestTarget}.
*
* @return the page or null
*/
public final Page getResponsePage()
{
IRequestTarget target = getRequestTarget();
if (target instanceof IPageRequestTarget)
{
return ((IPageRequestTarget)target).getPage();
}
else if (target instanceof BookmarkablePageRequestTarget)
{
return ((BookmarkablePageRequestTarget)target).getPage();
}
return null;
}
/**
* Gets the page class that is to be instantiated and rendered for this request in case the last
* set request target is of type {@link BookmarkablePageRequestTarget}.
*
* @return the page class or null
*/
public final Class getResponsePageClass()
{
IRequestTarget target = getRequestTarget();
if (target != null && (target instanceof IBookmarkablePageRequestTarget))
{
return ((IBookmarkablePageRequestTarget)target).getPageClass();
}
return null;
}
/**
* Gets the session.
*
* @return Session object
*/
public final Session getSession()
{
if (session == null)
{
session = Session.get();
}
return session;
}
/**
* @return The start time for this request
*/
public final long getStartTime()
{
return startTime;
}
/**
* Gets whether the page for this request should be redirected.
*
* @return whether the page for this request should be redirected
*/
public boolean isRedirect()
{
return redirect;
}
/**
* Template method that is called when a runtime exception is thrown, just before the actual
* handling of the runtime exception. This is called by
* {@link AbstractRequestCycleProcessor#respond(RuntimeException, RequestCycle)}.
*
* @param page
* Any page context where the exception was thrown
* @param e
* The exception
* @return Any error page to redirect to
*/
public Page onRuntimeException(Page page, RuntimeException e)
{
return null;
}
/**
* THIS METHOD IS NOT PART OF THE WICKET PUBLIC API. DO NOT CALL IT.
*
* Redirects browser to the given page. Don't use this method directly, but use
* {@link #setResponsePage(Page)} instead.
*
* @param page
* The page to redirect to
*/
public abstract void redirectTo(final Page page);
/**
* THIS METHOD IS NOT PART OF THE WICKET PUBLIC API. DO NOT CALL IT.
*
* Responds to a request.
*/
public final void request()
{
checkReuse();
// set start step
currentStep = PREPARE_REQUEST;
// loop through steps
steps();
}
/**
* THIS METHOD IS NOT PART OF THE WICKET PUBLIC API. DO NOT CALL IT.
*
* Responds to a request to re-render a single component.
*
*
* NOTE: This method is typically only used for testing purposes.
*
*
* @param component
* to be re-rendered
*/
public final void request(final Component component)
{
checkReuse();
if (component.isAuto())
{
throw new WicketRuntimeException("Auto-added components can not be re-rendered");
}
request(new ComponentRequestTarget(component));
}
/**
* THIS METHOD IS NOT PART OF THE WICKET PUBLIC API. DO NOT CALL IT.
*
* Responds to a request with the request target.
*
* @param target
* request target
*/
public final void request(IRequestTarget target)
{
checkReuse();
// set it as the current target, on the top of the stack
if (target != null)
{
requestTargets.push(target);
}
// set start step
currentStep = PROCESS_EVENTS;
// loop through steps
steps();
}
/**
* Permit clients like testers to examine feedback messages after processing.
*
* @param automaticallyClearFeedbackMessages
* True to automatically detach request cycle at end of processing
*/
public void setAutomaticallyClearFeedbackMessages(boolean automaticallyClearFeedbackMessages)
{
// FIXME This method is a quick fix for a unit testing problem that
// should not exist
this.automaticallyClearFeedbackMessages = automaticallyClearFeedbackMessages;
}
/**
* Sets whether the page for this request should be redirected.
*
* @param redirect
* True if the page for this request cycle should be redirected to rather than
* directly rendered.
*/
public final void setRedirect(final boolean redirect)
{
this.redirect = redirect;
}
/**
* @param request
* The request to set.
*/
public final void setRequest(Request request)
{
this.request = request;
}
/**
* Sets the request target as the current.
*
* @param requestTarget
* the request target to set as current
*/
public final void setRequestTarget(IRequestTarget requestTarget)
{
if (log.isDebugEnabled())
{
if (!requestTargets.isEmpty())
{
IRequestTarget former = requestTargets.peek();
log.debug("replacing request target " + former + " with " + requestTarget);
}
else
{
log.debug("setting request target to " + requestTarget);
}
}
// change the current step to a step that will handle the
// new target if need be
if (currentStep >= RESPOND)
{
if (log.isDebugEnabled())
{
log.debug("rewinding request processing to PROCESS_EVENTS");
}
// we are not actually doing event processing again,
// but since we are still in the loop here, the next
// actual value will be RESPOND again
currentStep = PROCESS_EVENTS;
}
// NOTE: if we are at PROCESS_EVENTS, leave it as we don't
// want to re-execute that step again
requestTargets.push(requestTarget);
}
/**
* Sets response.
*
* @param response
* The response
* @return the original response
*/
public final Response setResponse(final Response response)
{
final Response orig = this.response;
this.response = response;
return orig;
}
/**
* Attempts to return name of current page map
*
* @return name of current page map or null if none
*/
private String getCurrentPageMap()
{
IRequestTarget target = RequestCycle.get().getRequestTarget();
if (target instanceof IPageRequestTarget)
{
Page page = ((IPageRequestTarget)target).getPage();
return page != null ? page.getPageMapName() : null;
}
else if (target instanceof IBookmarkablePageRequestTarget)
{
return ((IBookmarkablePageRequestTarget)target).getPageMapName();
}
else
{
return null;
}
}
/**
* Convenience method that sets page class as the response. This will generate a redirect to the
* page with a bookmarkable url
*
* @param
*
* @param pageClass
* The page class to render as a response
*/
public final void setResponsePage(final Class pageClass)
{
setResponsePage(pageClass, null);
}
/**
* Sets the page class with optionally the page parameters as the render target of this request.
*
* @param
*
* @param pageClass
* The page class to render as a response
* @param pageParameters
* The page parameters that gets appended to the bookmarkable url,
*/
public final void setResponsePage(final Class pageClass,
final PageParameters pageParameters)
{
setResponsePage(pageClass, pageParameters, getCurrentPageMap());
}
/**
* Sets the page class with optionally the page parameters and page map name as the render
* target of this request.
*
* @param
*
* @param pageClass
* The page class to render as a response
* @param pageParameters
* The page parameters that gets appended to the bookmarkable url,
* @param pageMapName
* The Pagemap in which the response page should be created
*/
public final void setResponsePage(final Class pageClass,
final PageParameters pageParameters, final String pageMapName)
{
IRequestTarget target = new BookmarkablePageRequestTarget(pageMapName, pageClass,
pageParameters);
setRequestTarget(target);
}
/**
* Sets the page as the render target of this request.
*
* @param page
* The page to render as a response
*/
public final void setResponsePage(final Page page)
{
IRequestTarget target = new PageRequestTarget(page);
setRequestTarget(target);
}
/**
* @see java.lang.Object#toString()
*/
@Override
public String toString()
{
return "[RequestCycle" + "@" + Integer.toHexString(hashCode()) + " thread=" +
Thread.currentThread().getName() + "]";
}
/**
* @return true if the next to be encoded url is targeting a new window (ModalWindow, Pop-up,
* tab).
*/
public final boolean isUrlForNewWindowEncoding()
{
return urlForNewWindowEncoding;
}
/**
* Indicate if the next to be encoded url is targeting a new window (ModalWindow, Pop-up, tab).
* This temporary flag is specifically needed for Portlet-support as then such a page needs a
* special target (Resource) url. After each urlFor call, this flag is reset to false.
*/
public final void setUrlForNewWindowEncoding()
{
urlForNewWindowEncoding = true;
}
/**
* Returns an encoded URL that references the given request target and clears the
* urlForNewWindowEncoding flag.
*
* @param requestTarget
* the request target to reference
* @return a URL that references the given request target
*/
private final CharSequence encodeUrlFor(final IRequestTarget requestTarget)
{
CharSequence url = getProcessor().getRequestCodingStrategy().encode(this, requestTarget);
url = cutNilChar(url);
urlForNewWindowEncoding = false;
return url;
}
/**
* Removes any occurrence of \u0000 char and everything after it.
*
* @param input
* the CharSequence to process
* @return
* a CharSequence without \u0000 in it
*/
// WICKET-4275, CVE-2011-2712
private CharSequence cutNilChar(CharSequence input)
{
StringBuilder result = new StringBuilder();
int length = input.length();
for (int i = 0; i < length; i++)
{
char c = input.charAt(i);
if (c == '\u0000')
{
break;
}
else {
result.append(c);
}
}
return result;
}
/**
* Returns a bookmarkable URL that references a given page class using a given set of page
* parameters. Since the URL which is returned contains all information necessary to instantiate
* and render the page, it can be stored in a user's browser as a stable bookmark.
*
* @param
*
* @param pageClass
* Class of page
* @param parameters
* Parameters to page
* @return Bookmarkable URL to page
*/
public final CharSequence urlFor(final Class pageClass,
final PageParameters parameters)
{
return urlFor(null, pageClass, parameters);
}
/**
* Returns a URL that references a given interface on a given behavior of a component. When the
* URL is requested from the server at a later time, the interface on the behavior will be
* called. A URL returned by this method will not be stable across sessions and cannot be
* bookmarked by a user.
*
* @param component
* The component to reference
* @param behaviour
* The behavior to reference
* @param listener
* The listener interface on the component
* @return A URL that encodes a page, component, behavior and interface to call
*/
public final CharSequence urlFor(final Component component, final IBehavior behaviour,
final RequestListenerInterface listener)
{
int index = component.getBehaviorsRawList().indexOf(behaviour);
if (index == -1)
{
throw new IllegalArgumentException("Behavior " + this +
" was not registered with this component: " + component.toString());
}
RequestParameters params = new RequestParameters();
params.setBehaviorId(String.valueOf(index));
if (request instanceof ServletWebRequest)
{
ServletWebRequest swr = (ServletWebRequest)request;
// If we're coming in with an existing depth, use it. Otherwise,
// compute from the URL. This provides correct behavior for repeated
// AJAX requests: If we need to generate a URL within an AJAX
// request for another one, it needs to be at the same depth as the
// original AJAX request.
int urlDepth = swr.getRequestParameters().getUrlDepth();
params.setUrlDepth(urlDepth > -1 ? urlDepth : swr.getDepthRelativeToWicketHandler());
}
final IRequestTarget target = new BehaviorRequestTarget(component.getPage(), component,
listener, params);
return encodeUrlFor(target);
}
/**
* Returns a URL that references a given interface on a component. When the URL is requested
* from the server at a later time, the interface will be called. A URL returned by this method
* will not be stable across sessions and cannot be bookmarked by a user.
*
* @param component
* The component to reference
* @param listener
* The listener interface on the component
* @param params
* Additional parameters to pass to the page
* @return A URL that encodes a page, component and interface to call
*/
public final CharSequence urlFor(final Component component,
final RequestListenerInterface listener, ValueMap params)
{
// Get Page holding component and mark it as stateful.
final Page page = component.getPage();
final IRequestTarget target;
if ((listener != IRedirectListener.INTERFACE) && component.isStateless() &&
page.isBookmarkable() && page.getStatelessHint())
{
PageParameters pageParameters = page.getPageParameters();
if (pageParameters == null)
{
pageParameters = new PageParameters();
}
else
{
pageParameters = (PageParameters)pageParameters.clone();
}
if (params != null)
{
Iterator> it = params.entrySet().iterator();
while (it.hasNext())
{
final Map.Entry entry = it.next();
final String key = entry.getKey();
final String value = entry.getValue().toString();
// Do not encode values here. It is the encoder's job
// to do the endoding. This leads to double encoding
// - Doug Donohoe
// @see https://issues.apache.org/jira/browse/WICKET-1627
pageParameters.add(key, value);
}
}
target = new BookmarkableListenerInterfaceRequestTarget(page.getPageMapName(),
page.getClass(), pageParameters, component, listener);
return encodeUrlFor(target);
}
else
{
page.setPageStateless(Boolean.FALSE);
// make session non-volatile if not already so
final Session session = getSession();
if (session.isTemporary())
{
session.bind();
}
// Get the listener interface name
target = new ListenerInterfaceRequestTarget(page, component, listener);
CharSequence url = encodeUrlFor(target);
if (params != null)
{
AppendingStringBuffer buff = new AppendingStringBuffer(url);
WebRequestEncoder encoder = new WebRequestEncoder(buff);
for (Entry stringObjectEntry : params.entrySet())
{
final String key = stringObjectEntry.getKey();
final String value = stringObjectEntry.getValue().toString();
encoder.addValue(key, value);
}
url = buff;
}
return url;
}
}
/**
* Returns a URL that references a given interface on a component. When the URL is requested
* from the server at a later time, the interface will be called. A URL returned by this method
* will not be stable across sessions and cannot be bookmarked by a user.
*
* @param component
* The component to reference
* @param listener
* The listener interface on the component
* @return A URL that encodes a page, component and interface to call
*/
public final CharSequence urlFor(final Component component,
final RequestListenerInterface listener)
{
return urlFor(component, listener, null);
}
/**
* Returns a bookmarkable URL that references a given page class using a given set of page
* parameters. Since the URL which is returned contains all information necessary to instantiate
* and render the page, it can be stored in a user's browser as a stable bookmark.
*
* @param
*
* @param pageMap
* Pagemap to use. If null is passed the default page map will be used
* @param pageClass
* Class of page
* @param parameters
* Parameters to page
* @return Bookmarkable URL to page
*/
public final CharSequence urlFor(final IPageMap pageMap,
final Class pageClass, final PageParameters parameters)
{
final IRequestTarget target = new BookmarkablePageRequestTarget(pageMap == null
? PageMap.DEFAULT_NAME : pageMap.getName(), pageClass, parameters);
return encodeUrlFor(target);
}
/**
* Returns a URL that references the given request target.
*
* @param requestTarget
* the request target to reference
* @return a URL that references the given request target
*/
public final CharSequence urlFor(final IRequestTarget requestTarget)
{
return encodeUrlFor(requestTarget);
}
/**
* Returns a URL that references the given page. It also {@link Session#touch(Page) touches} the
* page in the session so that it is put in the front of the page stack. Use this method only if
* you plan to use it the next request.
*
* @param page
* The page
* @return The url pointing to the provided page
*/
public final CharSequence urlFor(final Page page)
{
IRequestTarget target = new PageRequestTarget(page);
getSession().touch(((IPageRequestTarget)target).getPage());
return encodeUrlFor(target);
}
/**
* Returns a URL that references the page pointed to by id
*
* @see PageIdRequestTarget for more details
*
* @param id
* page id
* @return url pointing to the page
*/
public final CharSequence urlFor(final PageReference id)
{
return urlFor(new PageReferenceRequestTarget(id));
}
/**
* Returns a URL that references a shared resource through the provided resource reference.
*
* @param resourceReference
* The resource reference where a url must be generated for.
* @return The url for the shared resource
*/
public final CharSequence urlFor(final ResourceReference resourceReference)
{
return urlFor(resourceReference, null);
}
/**
* Returns a URL that references a shared resource through the provided resource reference.
*
* @param resourceReference
* The resource reference where a url must be generated for.
* @param parameters
* The parameters to pass to the resource.
* @return The url for the shared resource
*/
public final CharSequence urlFor(final ResourceReference resourceReference, ValueMap parameters)
{
RequestParameters requestParameters = new RequestParameters();
requestParameters.setResourceKey(resourceReference.getSharedResourceKey());
String name = resourceReference.getName();
if (getApplication().getResourceSettings().getAddLastModifiedTimeToResourceReferenceUrl() &&
!Strings.isEmpty(name) && !name.endsWith("/")) // test for / because it could be a
// resource reference to a path..
{
Time time = resourceReference.lastModifiedTime();
if (time != null)
{
if (parameters == null)
{
parameters = new ValueMap();
parameters.put("w:lm", new Long(time.getMilliseconds() / 1000));
}
}
}
requestParameters.setParameters(parameters);
return encodeUrlFor(new SharedResourceRequestTarget(requestParameters));
}
/**
* Checks whether no processing has been done yet and throws an exception when a client tries to
* reuse this instance.
*/
private void checkReuse()
{
if (currentStep != NOT_STARTED)
{
detach();
throw new WicketRuntimeException(
"RequestCycles are non-reusable objects. This instance (" + this +
") has already been executed");
}
}
/**
* Clean up the request cycle. Please note that you (the user of Wicket) will probably never
* have a need to call detach() yourself. It is used Wicket internally only. But you may
* subclass RequestCycle in order to execute additional code during detach. Do not forget to
* call super.detach() in or subclass.
*/
public void detach()
{
// clean up target stack; calling detach has effects like
// NOTE: don't remove the targets as testing code might need them
// furthermore, the targets will be GC-ed with this cycle too
for (int i = 0; i < requestTargets.size(); i++)
{
IRequestTarget target = requestTargets.get(i);
if (target != null)
{
try
{
target.detach(this);
}
catch (RuntimeException e)
{
log.error("there was an error cleaning up target " + target + ".", e);
}
}
}
try
{
onAfterTargetsDetached();
}
catch (Throwable re)
{
log.error("there was an error processing onAfterTargetsDetached", re);
}
if (automaticallyClearFeedbackMessages)
{
// remove any rendered and otherwise obsolete feedback messages from
// the session
try
{
if (sessionExists())
{
getSession().cleanupFeedbackMessages();
}
}
catch (RuntimeException re)
{
log.error("there was an error cleaning up the feedback messages", re);
}
}
// if we have a request logger, update that now
try
{
IRequestLogger requestLogger = getApplication().getRequestLogger();
if (requestLogger != null)
{
requestLogger.requestTime((System.currentTimeMillis() - startTime));
}
}
catch (RuntimeException re)
{
log.error("there was an error in the RequestLogger ending.", re);
}
// let the session cleanup after a request, flushing changes etc.
if (sessionExists())
{
try
{
getSession().requestDetached();
}
catch (RuntimeException re)
{
log.error("there was an error detaching the request from the session " + session +
".", re);
}
}
if (getResponse() instanceof BufferedWebResponse)
{
try
{
((BufferedWebResponse)getResponse()).filter();
}
catch (RuntimeException re)
{
log.error("there was an error filtering the response.", re);
}
}
try
{
onEndRequest();
}
catch (RuntimeException e)
{
log.error("Exception occurred during onEndRequest", e);
}
try
{
getApplication().getSessionStore().onEndRequest(getRequest());
}
catch (RuntimeException e)
{
log.error("Exception occurred during onEndRequest of the SessionStore", e);
}
// Release thread local resources
try
{
threadDetach();
}
catch (RuntimeException re)
{
log.error("Exception occurred during threadDetach", re);
}
}
/**
* Prepare the request cycle.
*/
private void prepare()
{
try
{
getApplication().getSessionStore().onBeginRequest(getRequest());
}
catch (RuntimeException e)
{
log.error("Exception occurred during onBeginRequest of the SessionStore", e);
}
// Event callback
onBeginRequest();
}
/**
* Call the event processing and and respond methods on the request processor and apply
* synchronization if needed.
*/
private final void processEventsAndRespond()
{
// let the processor handle/ issue any events, including building the component hierarchy
processor.processEvents(this);
// process Portlet events - or, perhaps save the event on the session, and get it back out
// later
// set current stage manually this time
currentStep = RESPOND;
// generate a response
processor.respond(this);
}
/**
* Call the event processing and and respond methods on the request processor and apply
* synchronization if needed.
*/
private final void respond()
{
processor.respond(this);
}
/**
* Safe version of {@link #getProcessor()} that throws an exception when the processor is null.
*
* @return the request processor
*/
private final IRequestCycleProcessor safeGetRequestProcessor()
{
IRequestCycleProcessor processor = getProcessor();
if (processor == null)
{
throw new WicketRuntimeException("request cycle processor must be not-null");
}
return processor;
}
/**
* @return True if a session exists for the calling thread
*/
private boolean sessionExists()
{
return Session.exists();
}
/**
* handle the current step in the request processing.
*/
private final void step()
{
try
{
switch (currentStep)
{
case PREPARE_REQUEST : {
// prepare the request
prepare();
break;
}
case RESOLVE_TARGET : {
// resolve the target of the request using the request
// parameters
final IRequestTarget target = processor.resolve(this,
request.getRequestParameters());
// has to result in a request target
if (target == null)
{
handled = false;
currentStep = DONE;
// throw new WicketRuntimeException(
// "the processor did not resolve to any request target");
}
// Add (inserting at the bottom) in case before or during
// target resolving one or more request targets were pushed
// on the stack before this. If that is the case, they
// should be handled before this
requestTargets.add(0, target);
break;
}
case PROCESS_EVENTS : {
processEventsAndRespond();
break;
}
case RESPOND : {
// generate a response
respond();
break;
}
default : {
// nothing
}
}
}
catch (AbortException e)
{
throw e;
}
catch (RuntimeException e)
{
/*
* check if the raised exception wraps an abort exception. if so, it is probably wise to
* unwrap and re-throw the abort exception
*/
Throwable cause = e.getCause();
while (cause != null)
{
if (cause instanceof AbortException)
{
throw ((AbortException)cause);
}
cause = cause.getCause();
}
if (!handlingException)
{
// set step manually to handle exception
handlingException = true;
// probably our last chance the exception can be logged.
// Note that a PageExpiredException should not be logged, because
// it's not an internal error
if (!(e instanceof PageExpiredException))
{
logRuntimeException(e);
}
// try to play nicely and let the request processor handle the
// exception response. If that doesn't work, any runtime exception
// will automatically be bubbled up
if (processor != null)
{
processor.respond(e, this);
}
}
else
{
onExceptionLoop(e);
}
}
}
/**
* Called when we catch a {@link RuntimeException} while already handling another
*/
protected void onExceptionLoop(RuntimeException e)
{
// hmmm, we were already handling an exception! give up
log.error("unexpected exception when handling another exception: " + e.getMessage(), e);
}
/**
* INTERNAL. THIS METHOD IS NOT PART OF PUBLIC WICKET API. Do not call it. Returns whether
* wicket handled this request or not (i.e. when no request target was found).
*
* @return true if wicket handled this request, false otherwise
*/
public boolean wasHandled()
{
return handled;
}
/**
* Loop through the processing steps starting from the current one.
*/
private final void steps()
{
try
{
// Arbitrary maximum number of steps
final int maxSteps = 100;
// Loop through steps
for (int totalSteps = 0; currentStep < DONE; totalSteps++)
{
// There is no way to catch infinite loops since the response
// step can always throw an AbstractRestartResponseException and
// start the process over at the RESPOND step. So we do a sanity
// check here and limit the total number of steps to an
// arbitrary maximum that we consider unreasonable for working
// code.
if (totalSteps >= maxSteps)
{
throw new IllegalStateException("Request processing executed " + maxSteps +
" steps, which means it is probably in an infinite loop.");
}
try
{
step();
currentStep++;
}
catch (AbstractRestartResponseException e)
{
// if a redirect exception has been issued we abort what we
// were doing and begin responding to the top target on the
// stack
response.reset();
currentStep = RESPOND;
// get rid of the session if its invalidated
if (Session.exists() && getSession().isSessionInvalidated())
{
session = null;
Session.unset();
}
}
}
}
finally
{
// set step manually to clean up
currentStep = DETACH_REQUEST;
// clean up the request
detach();
// set step manually to done
currentStep = DONE;
}
}
/**
* Releases the current thread local related resources. The thread-local of this request cycle
* is reset. If we are in a 'redirect' state, we do not want to lose our messages as - e.g. when
* handling a form - there's a fat chance we are coming back for the rendering of it.
*/
private final void threadDetach()
{
// Detach from session
if (sessionExists())
{
try
{
getSession().detach();
}
catch (RuntimeException re)
{
log.error("there was an error detaching the session", re);
}
session = null;
}
if (isRedirect())
{
// Since we are explicitly redirecting to a page already, we do not
// want a second redirect to occur automatically
setRedirect(false);
}
// Clear ThreadLocal reference; makes sense as this object should not be
// reused
current.set(previousOne);
}
/**
* Possibly set the page parameters. Only set when the request is resolving and the parameters
* are passed into a page.
*
* @param parameters
* the parameters to set
*/
final void setPageParameters(PageParameters parameters)
{
if (currentStep == RESOLVE_TARGET)
{
pageParameters = parameters;
}
}
/**
* Called when an unrecoverable runtime exception during request cycle handling occurred, which
* will result in displaying a user facing error page. Clients can override this method in case
* they want to customize logging. NOT called for {@link PageExpiredException page expired
* exceptions}.
*
* @param e
* the runtime exception
*/
protected void logRuntimeException(RuntimeException e)
{
log.error(e.getMessage(), e);
}
/**
* Creates a new agent info object based on this request. Typically, this method is called once
* by the session and the returned object will be cached in the session after that call; we can
* expect the client to stay the same for the whole session, and implementations of
* {@link #newClientInfo()} might be relatively expensive.
*
* @return the agent info object based on this request
*/
protected abstract ClientInfo newClientInfo();
/**
* Called when the request cycle object is beginning its response
*/
protected void onBeginRequest()
{
}
/**
* Called when the request cycle object has detached all request targets.
*/
protected void onAfterTargetsDetached()
{
}
/**
* Called when the request cycle object has finished its response
*/
protected void onEndRequest()
{
}
/**
* Called when a request target is set on the request cycle
*
* @param requestTarget
*/
protected void onRequestTargetSet(IRequestTarget requestTarget)
{
}
/**
* Sets the metadata for this request cycle using the given key. If the metadata object is not
* of the correct type for the metadata key, an IllegalArgumentException will be thrown. For
* information on creating MetaDataKeys, see {@link MetaDataKey}.
*
* @param key
* The singleton key for the metadata
* @param object
* The metadata object
* @param
* @throws IllegalArgumentException
* @see MetaDataKey
*/
public final void setMetaData(final MetaDataKey key, final T object)
{
metaData = key.set(metaData, object);
}
/**
* Gets metadata for this request cycle using the given key.
*
* @param
* The type of the metadata
*
* @param key
* The key for the data
* @return The metadata or null if no metadata was found for the given key
* @see MetaDataKey
*/
public final T getMetaData(final MetaDataKey key)
{
return key.get(metaData);
}
}