com.hfg.webapp

Class ServletRequestDispatcher

java.lang.Object

com.hfg.webapp.ServletRequestDispatcher

public class ServletRequestDispatcher
extends Object

Dispatcher for dealing with servlet requests.

Example servlet code:

 private ServletRequestDispatcher mRequestDispatcher = new ServletRequestDispatcher();

 //---------------------------------------------------------------------------
 public void init()
 {
   mRequestDispatcher.registerDefaultHandler(MainPage.class); // Handler invoked if there are no params
   mRequestDispatcher.registerHandler(PAGE, MAIN_PAGE, MainPage.class);
 }

 //---------------------------------------------------------------------------
 public void doGet(HttpServletRequest inRequest, HttpServletResponse inResponse)
 {
   handleRequest(inRequest, inResponse);
 }

 //---------------------------------------------------------------------------
 public void doPost(HttpServletRequest inRequest, HttpServletResponse inResponse)
 {
   handleRequest(inRequest, inResponse);
 }

 //---------------------------------------------------------------------------
 private void handleRequest(HttpServletRequest inRequest, HttpServletResponse inResponse)
 {
   try
   {
     mRequestDispatcher.dispatch(inRequest, inResponse);
   }
   catch (Throwable e)
   {
     e.printStackTrace();
   }
 }
 

Constructor Summary

Constructors

Constructor and Description
ServletRequestDispatcher()

Method Summary

Modifier and Type	Method and Description
void	dispatch(javax.servlet.http.HttpServletRequest inRequest, javax.servlet.http.HttpServletResponse inResponse)
boolean	getAllowPartialPathMatches()
ServletRequestDispatcher	registerDefaultHandler(Class inValue)
ServletRequestDispatcher	registerParamHandler(String inParam, String inValue, Class inHandlerClass)
ServletRequestDispatcher	registerPathHandler(String inPath, Class inHandlerClass)
ServletRequestDispatcher	setAllowPartialPathMatches(boolean inValue) Specifies whether or not registered path values can be matched to the start of requested paths as broken by the path separator '/'.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServletRequestDispatcher

public ServletRequestDispatcher()

Method Detail

registerDefaultHandler

public ServletRequestDispatcher registerDefaultHandler(Class inValue)

registerPathHandler

public ServletRequestDispatcher registerPathHandler(String inPath,
                                                    Class inHandlerClass)

registerParamHandler

public ServletRequestDispatcher registerParamHandler(String inParam,
                                                     String inValue,
                                                     Class inHandlerClass)

setAllowPartialPathMatches

public ServletRequestDispatcher setAllowPartialPathMatches(boolean inValue)

Specifies whether or not registered path values can be matched to the start of requested paths as broken by the path separator '/'. If true, '/foo/bar' would be routed to the registered path '/foo' but '/food' would not.

Parameters:

inValue - whether or not registered path values can be matched to the start of requested paths as broken by the path separator '/'.

Returns:

this servlet request dispatcher object to enable method chaining

getAllowPartialPathMatches

public boolean getAllowPartialPathMatches()

dispatch

public void dispatch(javax.servlet.http.HttpServletRequest inRequest,
                     javax.servlet.http.HttpServletResponse inResponse)
              throws Exception

Throws:

Exception