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 analysing the class definition. In this example, the string value

"2007" is translated into an integer, 2007.

The web page result of the avobe request looks like as this:

Hello leo(2007)