org.logicalcobwebs.proxool.configuration
Class ServletConfigurator

java.lang.Object
  HttpServlet
      org.logicalcobwebs.proxool.configuration.ServletConfigurator

public class ServletConfigurator
extends HttpServlet

Allows you to configure Proxool using a servlet. There are three different ways: The init parameters can either directly configure Proxool (in a similar fashion to the PropertyConfigurator) or they can point to separate XML or property files. For example:

1. XML file delegates to JAXPConfigurator passing in the filename. If the filename is not absolute then it is prepended with the application directory.

    <servlet>
        <servlet-name>ServletConfigurator</servlet-name>
        <servlet-class>org.logicalcobwebs.proxool.configuration.ServletConfigurator</servlet-class>
        <init-param>
            <param-name>xmlFile</param-name>
            <param-value>WEB-INF/proxool.xml</param-value>
        </init-param>
    </servlet>
 

2. Property file delegates to PropertyConfigurator passing in the filename. If the filename is not absolute then it is prepended with the application directory.

    <servlet>
        <servlet-name>ServletConfigurator</servlet-name>
        <servlet-class>org.logicalcobwebs.proxool.configuration.ServletConfigurator</servlet-class>
        <init-param>
            <param-name>propertyFile</param-name>
            <param-value>WEB-INF/proxool.properties</param-value>
        </init-param>
    </servlet>
 

3. Init parameters delegates to PropertyConfigurator by passing in a new Properties object based on the servlet's init parameters.

    <servlet>
        <servlet-name>ServletConfigurator</servlet-name>
        <servlet-class>org.logicalcobwebs.proxool.configuration.ServletConfigurator</servlet-class>
        <init-param>
            <param-name>jdbc-0.proxool.alias</param-name>
            <param-value>test</param-value>
        </init-param>
        <init-param>
            <param-name>jdbc-0.proxool.driver-url</param-name>
            <param-value>jdbc:hsqldb:.</param-value>
        </init-param>
        <init-param>
            <param-name>jdbc-0.proxool.driver-class</param-name>
            <param-value>org.hsqldb.jdbcDriver</param-value>
        </init-param>
    </servlet>
 

It will also automatically shutdown Proxool. See destroy().

Since:

Proxool 0.7

Version:

$Revision: 1.6 $, $Date: 2003/03/10 15:26:54 $

Author:

bill, $Author: billhorsman $ (current maintainer)

Field Summary

private static java.lang.String	AUTO_SHUTDOWN_PROPERTY
private boolean	autoShutdown
private static Log	LOG
private static java.lang.String	PROPERTY_FILE_PROPERTY
private static java.lang.String	XML_FILE_PROPERTY

Constructor Summary

ServletConfigurator()

Method Summary

void	destroy() Shuts down Proxool by removing all connection pools.
void	init(ServletConfig servletConfig)

Methods inherited from class java.lang.Object

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

Field Detail

LOG

private static final Log LOG

XML_FILE_PROPERTY

private static final java.lang.String XML_FILE_PROPERTY

See Also:

Constant Field Values

PROPERTY_FILE_PROPERTY

private static final java.lang.String PROPERTY_FILE_PROPERTY

See Also:

Constant Field Values

AUTO_SHUTDOWN_PROPERTY

private static final java.lang.String AUTO_SHUTDOWN_PROPERTY

See Also:

Constant Field Values

autoShutdown

private boolean autoShutdown

Constructor Detail

ServletConfigurator

public ServletConfigurator()

Method Detail

init

public void init(ServletConfig servletConfig)
          throws ServletException

Throws:

ServletException

destroy

public void destroy()

Shuts down Proxool by removing all connection pools. If you want to disable this behaviour then use:

 <init-param>
   <param-name>autoShutdown</param-name>
   <param-value>false</param-value>
 </init-param>