The JavaTM Tutorial
Previous Page Lesson Contents Next Page Start of Tutorial > Start of Trail > Start of Lesson Search

Trail: Servlets
Lesson: The Life Cycle of a Servlet

Initializing a Servlet

The default initialization of the HttpServlet class initializes the servlet and logs the initialization. To add initialization specific to your servlet, override the init method appropriate to your version of the JSDK: the init(ServletConfig) method for version 2.0 and the init() method for version 2.1. When you override the init method, follow these rules:
 

Here is an example init method for version 2.1:

public class BookDetailServlet ... {

    public void init() throws ServletException {
        BookDBFrontEnd bookDBFrontEnd =
            (BookDBFrontEnd)getServletContext().getAttribute(
                "examples.bookstore.database.BookDBFrontEnd");

        if (bookDBFrontEnd == null) {
            getServletContext().setAttribute(
                "examples.bookstore.database.BookDBFrontEnd",
                BookDBFrontEnd.instance());
        }
        ...
    }

The init method is straightforward: it tries to get an attribute, and if the attribute does not yet have a value, it provides one.

There are other initialization tasks that a servlet might perform. If a servlet used a database, for example, the init method could try to open a connection and throw the UnavailableException if it was unsuccessful. Here is pseudo-code for what that init method might look like:

    public class DBServlet ... {

        Connection connection = null;

        public void init() throws ServletException {

            // Open a database connection to prepare for requests
            try {
                databaseUrl = getInitParameter("databaseUrl");
                ... // get user and password parameters the same way
                connection = DriverManager.getConnection(databaseUrl,
                                                         user, password);
            } catch(Exception e) {
                throw new UnavailableException (this,
		    "Could not open a connection to the database");
            }
        }
        ...
    }

 

Initialization Parameters

The second version of the init method calls the getInitParameter method. This method takes the parameter name as an argument and returns a String representation of the parameter's value.

(The specification of initialization parameters is server-specific. For example, the parameters are specified with a property when a servlet is run with servletrunner or with the JSDK2.1 server. The Utilities for Running Servlets lesson contains a general explanation of properties and how to create them.)

If, for some reason, you need to get the parameter names, use the getParameterNames method.


Previous Page Lesson Contents Next Page Start of Tutorial > Start of Trail > Start of Lesson Search