Dependency-injection servlet configuration
Resin 3.1

Documentation
Examples
Changes

Amber (JPA)
EJB
Database
IoC
JMX
JSF
Messaging
Quercus
Remoting
Servlet
Security

Hello, World
Comet
IoC
Comet
Servlet
Security

Resin allows servlets to be configured using dependency injection.

Demo

With Resin, servlets can use Java Bean-style configuration. A "Java Bean" is just a Java class that follows a simple set of rules. Each configuration parameter foo has a corresponding setter method setFoo with a single argument for the value. Resin can look at the class using Java's reflection and find the setFoo method. Because Resin can find the bean-style setters from looking at the class, it can configure those setters in a configuration file like the web.xml.

Files in this tutorial

WEB-INF/web.xmlConfigures the Servlet with bean-style init
WEB-INF/classes/test/HelloServlet.javaThe servlet implementation.

HelloServlet

The following HelloServlet servlet is a trivial bean-style servlet. Instead of hardcoding the "Hello, world" string, it lets the web.xml configure the string as greeting. To make that work, HelloWorld adds a bean-style setGreeting(String) jmethod.

WEB-INF/classes/test/HelloServlet.java
package test;

import java.io.*;

import javax.servlet.http.*;
import javax.servlet.*;

public class HelloServlet extends HttpServlet {
  private String _greeting = "Default";

  public void setGreeting(String greeting)
  {
    _greeting = greeting;
  }

  public void doGet (HttpServletRequest req,
                     HttpServletResponse res)
    throws ServletException, IOException
  {
    PrintWriter out = res.getWriter();

    out.println(_greeting);
    out.close();
  }
}

Configuration

The configuration sets the greeting property inside an tag. After Resin instantiates the servlet object, it looks at the configuration file for any <init> section. Resin then calls a setXXX method for each <xxx> tag in <init>. In this case, Resin will call setGreeting

Resin will perform any type conversion necessary, so you can use integers and doubles as well as strings. After Resin calls the setXXX methods, it will call the init(ServletConfig) method.

When Resin initializes the servlet, it will make the following calls:

  1. servlet = new test.HelloServlet();
  2. servlet.setGreeting("Hello, World!");
  3. servlet.init(servletConfig);
WEB-INF/web.xml
<web-app xmlns="http://caucho.com/ns/resin">
  <servlet servlet-name="hello"
            servlet-class="test.HelloServlet">
    <init>
      <greeting>Hello, World!</greeting>
    </init>
  </servlet>

  <servlet-mapping url-pattern="/hello"
            servlet-name="hello"/>
</web-app>

Demo


Comet
Servlet
Security
Copyright © 1998-2006 Caucho Technology, Inc. All rights reserved.
Resin ® is a registered trademark, and Quercustm, Ambertm, and Hessiantm are trademarks of Caucho Technology.