org.jminor.common.db

Class DatabaseConnections

java.lang.Object

org.jminor.common.db.DatabaseConnections

public final class DatabaseConnections
extends java.lang.Object

A factory class for DatabaseConnections

Method Summary

Modifier and Type	Method and Description
static DatabaseConnectionProvider	connectionProvider(Database database, User user) Instantiates a default DatabaseConnectionProvider instance
static DatabaseConnectionProvider	connectionProvider(Database database, User user, int validityCheckTimeout) Instantiates a default DatabaseConnectionProvider instance
static DatabaseConnection	createConnection(Database database, java.sql.Connection connection) Constructs a new DatabaseConnection instance, based on the given Connection object.
static DatabaseConnection	createConnection(Database database, java.sql.Connection connection, int validityCheckTimeout) Constructs a new DatabaseConnection instance, based on the given Connection object.
static DatabaseConnection	createConnection(Database database, User user) Constructs a new DatabaseConnection instance, based on the given Database and User
static DatabaseConnection	createConnection(Database database, User user, int validityCheckTimeout) Constructs a new DatabaseConnection instance, based on the given Database and User

Methods inherited from class java.lang.Object

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

Method Detail

createConnection

public static DatabaseConnection createConnection(Database database,
                                                  User user)
                                           throws DatabaseException

Constructs a new DatabaseConnection instance, based on the given Database and User

Parameters:

database - the database

user - the user for the db-connection

Returns:

a new DatabaseConnection instance

Throws:

DatabaseException - in case there is a problem connecting to the database

createConnection

public static DatabaseConnection createConnection(Database database,
                                                  User user,
                                                  int validityCheckTimeout)
                                           throws DatabaseException

Constructs a new DatabaseConnection instance, based on the given Database and User

Parameters:

database - the database

user - the user for the db-connection

validityCheckTimeout - the number of seconds specified when checking if the connection is valid

Returns:

a new DatabaseConnection instance

Throws:

DatabaseException - in case there is a problem connecting to the database

AuthenticationException - in case of an authentication error

createConnection

public static DatabaseConnection createConnection(Database database,
                                                  java.sql.Connection connection)
                                           throws DatabaseException

Constructs a new DatabaseConnection instance, based on the given Connection object. NB. auto commit is disabled on the Connection that is provided.

Parameters:

database - the database

connection - the Connection object to base this DatabaseConnection on

Returns:

a new DatabaseConnection instance

Throws:

DatabaseException - in case there is a problem connecting to the database

createConnection

public static DatabaseConnection createConnection(Database database,
                                                  java.sql.Connection connection,
                                                  int validityCheckTimeout)
                                           throws DatabaseException

Constructs a new DatabaseConnection instance, based on the given Connection object. NB. auto commit is disabled on the Connection that is provided.

Parameters:

database - the database

connection - the Connection object to base this DatabaseConnection on, it is assumed to be in a valid state

validityCheckTimeout - the number of seconds specified when checking if the connection is valid

Returns:

a new DatabaseConnection instance

Throws:

DatabaseException - in case there is a problem connecting to the database

connectionProvider

public static DatabaseConnectionProvider connectionProvider(Database database,
                                                            User user)

Instantiates a default DatabaseConnectionProvider instance

Parameters:

database - the underlying database

user - the user

Returns:

a new DatabaseConnectionProvider instance

connectionProvider

public static DatabaseConnectionProvider connectionProvider(Database database,
                                                            User user,
                                                            int validityCheckTimeout)

Instantiates a default DatabaseConnectionProvider instance

Parameters:

database - the underlying database

user - the user

validityCheckTimeout - the number of seconds specified when checking if a connection is valid

Returns:

a new DatabaseConnectionProvider instance