webwork.dispatcher

Class ServletDispatcher

java.lang.Object

javax.servlet.GenericServlet

javax.servlet.http.HttpServlet

webwork.dispatcher.ServletDispatcher

All Implemented Interfaces:

Serializable, javax.servlet.Servlet, javax.servlet.ServletConfig

public class ServletDispatcher
extends javax.servlet.http.HttpServlet

Main dispatcher servlet. It works in three phases: first propagate all parameters to the command JavaBean. Second, call execute() to let the JavaBean create the result data. Third, delegate to the JSP that corresponds to the result state that was chosen by the JavaBean.

The command JavaBeans can be found in a package prefixed with either of the package names in the comma-separated "packages" servlet init parameter.

Modified by Raymond Lai (alpha2_valen@yahoo.com) on 1 Nov 2003: modified wrapRequest() to set the character encoding of HttpServletRequest using the parameter "webwork.i18n.encoding" in webwork.properties.

Version:

$Revision: 1.73 $

Author:

Rickard Öberg (rickard@middleware-company.com), Matt Baldree (matt@smallleap.com)

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	GENERIC_DISPATCHER_FOR_CLEANUP
protected static org.apache.commons.logging.Log	log
static String	STACK_HEAD After a view is processed the value of the stack's head is put into the request attributes with this key.

Constructor Summary

Constructors

Constructor and Description
ServletDispatcher()

Method Summary

Methods

Modifier and Type	Method and Description
protected String	getActionName(String name) Determine action name by extracting last string and removing extension.
protected String	getHTMLErrorMessage(Throwable t) Return an HTML error message for the throwable
void	init(javax.servlet.ServletConfig config) Initialize dispatcher servlet
void	service(javax.servlet.http.HttpServletRequest aRequest, javax.servlet.http.HttpServletResponse aResponse) Service a request.

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, doGet, doHead, doOptions, doPost, doPut, doTrace, getLastModified, service

Methods inherited from class javax.servlet.GenericServlet

destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, log, log

Methods inherited from class java.lang.Object

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

Field Detail

STACK_HEAD

public static final String STACK_HEAD

After a view is processed the value of the stack's head is put into the request attributes with this key.

See Also:

Constant Field Values

log

protected static org.apache.commons.logging.Log log

GENERIC_DISPATCHER_FOR_CLEANUP

public static final String GENERIC_DISPATCHER_FOR_CLEANUP

See Also:

Constant Field Values

Constructor Detail

ServletDispatcher

public ServletDispatcher()

Method Detail

init

public void init(javax.servlet.ServletConfig config)
          throws javax.servlet.ServletException

Initialize dispatcher servlet

Specified by:

init in interface javax.servlet.Servlet

Overrides:

init in class javax.servlet.GenericServlet

Parameters:

config -

Throws:

javax.servlet.ServletException

service

public void service(javax.servlet.http.HttpServletRequest aRequest,
           javax.servlet.http.HttpServletResponse aResponse)
             throws javax.servlet.ServletException,
                    IOException

Service a request. The request is first checked to see if it is a multi-part. If it is, then the request is wrapped so WW will be able to work with the multi-part as if it was a normal request. Next, we will process all actions until an action returns a non-action which is usually a view. For each action in a chain, the action's context will be first set and then the action will be instantiated. Next, the previous action if this action isn't the first in the chain will have its attributes copied to the current action.

Overrides:

service in class javax.servlet.http.HttpServlet

Parameters:

aRequest -

aResponse -

Throws:

javax.servlet.ServletException

IOException

getActionName

protected String getActionName(String name)

Determine action name by extracting last string and removing extension. (/.../.../Foo.action -> Foo)

getHTMLErrorMessage

protected String getHTMLErrorMessage(Throwable t)

Return an HTML error message for the throwable

Parameters:

t - Throwable

Returns:

A String with an error message