wiki:Devel/Index

= UTGB Request Dispatcher Mechanism =


== web.xml setting ==
Add the following description into your web.xml.
  * The lines param-name=base-package, param-value=(application base) specifies the location (base package name) where the RequestDispatcher searches recursively for RequestHandler implementations.
  * With the following setting, an HTTP request, e.g.,  http://localhost:8989/hello.action, is mapped to the request handler org.utgenome.gwt.utgb.server.app.Hello class. The upper letters are converted into the lower letters when mapping the request, e.g., Hello action can be accecced via hello.action URL.
    * Another example using hierarchies of actions:   http://localhost:8989/admin/login.action is mapped to org.utgenome.gwt.utgb.server.Login class.

{{{
  <servlet>
    <servlet-name>dispatcher</servlet-name>
    <servlet-class>org.utgenome.gwt.utgb.server.RequestDispatcher</servlet-class>
    <init-param>
      <param-name>base-package</param-name>
      <param-value>(your web application request handler base package. e.g. org.utgenome.gwt.utgb.server.app)</param-value>
    </init-param>
  </servlet>

  <servlet-mapping>
    <servlet-name>dispatcher</servlet-name>
    <url-pattern>*.action</url-pattern>
  </servlet-mapping>
}}}


== Automatic Data Binding to Request Handler == 

Hello.java class has serveral parameter values name and year:
{{{

public class Hello implements RequestHandler
{
  private String name = "";
  private int year = 2000;

  public void handle(HttpServletRequest request, HttpServletResponse response)
  {
      PrintWriter out = response.getWriter().println("Hello " + name + "(" + year + ")");
  }

  public void setName(String name) { this.name = name; }
  public void setYear(int year) { this.year = year; }
}


}}}

Our RequestDispatcher automatically set these parameter values from a given HTTP request. For example, an HTTP request  

http://localhost:8989/hello.action?name=leo&year=2007 

will invoke setName("leo") and setYear(2007) methods.

Note that, although the query string in the HTTP request consists of string values, our BeanUtil library 
detects the data type to which the string should be translated by reading the class definition (in this example, Hello class).