org.apache.wicket.request

Class RequestHandlerExecutor

java.lang.Object

org.apache.wicket.request.RequestHandlerExecutor

public abstract class RequestHandlerExecutor
extends Object

Manages executions of IRequestHandlers.

Author:

Matej Knopp, igor.vaynberg

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RequestHandlerExecutor.ReplaceHandlerException Exception to stop current request handler and execute a new one.

Constructor Summary

Constructors

Constructor and Description
RequestHandlerExecutor()

Method Summary

Modifier and Type	Method and Description
void	detach() Detaches all request handlers
protected abstract void	detach(IRequestHandler handler) Allows the request handler to detach
IRequestHandler	execute(IRequestHandler handler) Execute the given handler.
IRequestHandler	getActive() Get the handler currently executed.
IRequestHandler	next()
void	replaceAll(IRequestHandler handler) Replaces all request handlers on the stack with the specified one and executes it.
IRequestHandler	resolveHandler(RuntimeException exception) Deprecated.
protected abstract void	respond(IRequestHandler handler) Allows the request handler to respond to the request
void	schedule(IRequestHandler handler) Schedules the handler after the current one

Methods inherited from class java.lang.Object

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

Constructor Detail

RequestHandlerExecutor

public RequestHandlerExecutor()

Method Detail

getActive

public IRequestHandler getActive()

Get the handler currently executed.

Returns:

active handler

execute

public IRequestHandler execute(IRequestHandler handler)

Execute the given handler.

Parameters:

handler - handler to be executed

Returns:

handler to be executed next

Throws:

RequestHandlerExecutor.ReplaceHandlerException - if another handler should replace the given handler for execution

resolveHandler

public final IRequestHandler resolveHandler(RuntimeException exception)

Deprecated.

Certain exceptions can carry a request handler they wish to be executed, this method tries to resolve such a handler given an exception.

Parameters:

exception -

Returns:

request handler or null} if one cannot be resolved

respond

protected abstract void respond(IRequestHandler handler)

Allows the request handler to respond to the request

Parameters:

handler -

schedule

public void schedule(IRequestHandler handler)

Schedules the handler after the current one

Parameters:

handler -

next

public IRequestHandler next()

Returns:

scheduled request handler after the current one

replaceAll

public void replaceAll(IRequestHandler handler)

Replaces all request handlers on the stack with the specified one and executes it. If there are any request handlers currently executing (this method is called from inside IRequestHandler.respond(IRequestCycle)) the execution is interrupted via an exception.

Parameters:

handler -

detach

public void detach()

Detaches all request handlers

detach

protected abstract void detach(IRequestHandler handler)

Allows the request handler to detach

Parameters:

handler -