org.mentawai.db

Class DataSourceConnectionHandler

java.lang.Object

org.mentawai.db.AbstractConnectionHandler

org.mentawai.db.DataSourceConnectionHandler

All Implemented Interfaces:

org.mentacontainer.Factory, org.mentacontainer.Interceptor<Connection>, ConnectionHandler

public class DataSourceConnectionHandler
extends AbstractConnectionHandler

A connection handler backed up by a javax.sql.DataSource. Use this class if you have a DataSource in hand and want to create a ConnectionHandler.

Author:

Sergio Oliveira

Nested Class Summary

Nested classes/interfaces inherited from interface org.mentawai.db.ConnectionHandler

ConnectionHandler.Exec

Constructor Summary

Constructors

Constructor and Description
DataSourceConnectionHandler(DataSource ds) Creates a ConnectionHandler backed up by the given DataSource.

Method Summary

Methods

Modifier and Type	Method and Description
void	destroy() Destroy the connection pool, closing and cleaning all connections.
Object	getBean()
Connection	getConnection() Returns a Connection to the database.
String	getStatus() Print the status of this connection pool if any.
void	release(Connection conn) Release this connection.

Methods inherited from class org.mentawai.db.AbstractConnectionHandler

exec, getInstance, getType, onCleared, onCreated

Methods inherited from class java.lang.Object

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

Constructor Detail

DataSourceConnectionHandler

public DataSourceConnectionHandler(DataSource ds)

Creates a ConnectionHandler backed up by the given DataSource.

Parameters:

ds - The DataSource to use.

Method Detail

getConnection

public Connection getConnection()
                         throws SQLException

Description copied from interface: ConnectionHandler

Returns a Connection to the database. Notice that it can never return null. If no connection can be acquired, then a SQLException is thrown.

Returns:

A connection to the database.

Throws:

SQLException - if there were problems trying to acquire the connection.

getStatus

public String getStatus()

Description copied from interface: ConnectionHandler

Print the status of this connection pool if any.

Returns:

The status

getBean

public Object getBean()
               throws InstantiationException

Throws:

InstantiationException

release

public void release(Connection conn)

Description copied from interface: ConnectionHandler

Release this connection. If this connection handler is using a database pool, the connection is returned to the pool. If this connection handler is not using a database pool, the connection is closed. If the connection passed as an argument is null, nothing is done.

Parameters:

conn - The connection to release.

destroy

public void destroy()

Description copied from interface: ConnectionHandler

Destroy the connection pool, closing and cleaning all connections. This is important for restarting the web context.