csbase.server.services.dbmanagerservice

Class DBPool

java.lang.Object

csbase.server.services.dbmanagerservice.Pool

csbase.server.services.dbmanagerservice.DBPool

public final class DBPool
extends Pool

Implementa pools de conexões com bancos de dados.

Author:

Tecgraf/PUC-Rio

Field Summary

Fields inherited from class csbase.server.services.dbmanagerservice.Pool

driver, logger, name, password, url, user

Constructor Summary

Constructors

Constructor and Description
DBPool(String name) Construtor da classe, instancia o pool e inicializa.

Method Summary

Modifier and Type	Method and Description
void	checkPassword(String passwd) Verifica se a senha utilizada com o banco mudou.
void	destroy() Término do módulo de acesso a conexões à base de dados do Bandeira Brasil.
Connection	getConnection() Obtém uma conexão para acesso a base de dados.
static int	getOpenCursors(Connection conn) Retorna o número de cursores abertos em uma conexão.
boolean	init() Inicialização do pool de conexões a uma base de dados.
void	releaseConnection(Connection conn, Statement st, ResultSet rs) Devolve a conexão para o pool
void	releaseConnection(Connection conn, Statement st, ResultSet rs, boolean dispose) Fecha um ResultSet e um Statement e devolve a conexão para o pool.
void	setConnectionTimeout(long connectionTimeout) Tempo máximo, em ms, de espera na criação de uma conexão com o banco.
void	setDecayTime(long decayTime) Tempo, em ms, de decaimento para fechar metade das conexões livres.
void	setDelayBetweenOpen(long delayBetweenOpen) Tempo de espera, em ms, entre tentativas de criar conexão com o banco.
void	setDriver(String driver) O driver da base de dados.
void	setFreeConnections(int freeConnections) Número mínimo de conexões livres abertas no pool.
void	setMaxConnections(int maxConnections) Número máximo de conexões abertas no pool.
void	setMaxUseTimes(int maxUseTimes) Número máximo de vezes que uma conexão pode ser utilizada.
void	setUserPasswordErrorCode(int userPasswordErrorCode) Define o código de erro utilizado para indicar que o nome de usuário e senha são inválidos para obtenção de uma conexão.

Methods inherited from class csbase.server.services.dbmanagerservice.Pool

getDriver, getIntProperty, getLogger, getLongProperty, getName, getPassword, getProperties, getProperty, getUrl, getUser, initServiceLog, setPassword, setUrl, setUser

Methods inherited from class java.lang.Object

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

Constructor Detail

DBPool

public DBPool(String name)
       throws ServerException

Construtor da classe, instancia o pool e inicializa.

Parameters:

name - nome que identifica o pool.

Throws:

ServerException - em caso de falha no servidor.

Method Detail

checkPassword

public void checkPassword(String passwd)

Verifica se a senha utilizada com o banco mudou.

Specified by:

checkPassword in class Pool

Parameters:

passwd - A senha para testar.

destroy

public void destroy()

Término do módulo de acesso a conexões à base de dados do Bandeira Brasil.

Specified by:

destroy in class Pool

getConnection

public Connection getConnection()

Obtém uma conexão para acesso a base de dados. Toda conexão retornada pelo pool sempre está em modo auto-commit. O usuário da conexão é livre para mudar a conexão para o modo de commits manuais e não necessita retorná-la para o modo auto-commit antes de devolvê-la ao pool. A conexão deve ser posteriormente devolvida através do método releaseConnection(java.sql.Connection, java.sql.Statement, java.sql.ResultSet).

Specified by:

getConnection in class Pool

Returns:

A conexão a ser utilizada ou null caso o módulo já esteja fechado.

init

public boolean init()

Inicialização do pool de conexões a uma base de dados. O pool deve ser configurado antes de ser inicializado.

Specified by:

init in class Pool

Returns:

true em caso de sucesso, false caso contrário.

releaseConnection

public void releaseConnection(Connection conn,
                              Statement st,
                              ResultSet rs)

Devolve a conexão para o pool

Specified by:

releaseConnection in class Pool

Parameters:

conn - conexão

st - statement

rs - result set.

releaseConnection

public void releaseConnection(Connection conn,
                              Statement st,
                              ResultSet rs,
                              boolean dispose)

Fecha um ResultSet e um Statement e devolve a conexão para o pool.

Specified by:

releaseConnection in class Pool

Parameters:

conn - Conexão a ser devolvida para o pool.

st - Statement a ser fechado (pode ser nulo).

rs - ResultSet a ser fechado (pode ser nulo).

dispose - descarta a conexão do pool

setConnectionTimeout

public void setConnectionTimeout(long connectionTimeout)

Tempo máximo, em ms, de espera na criação de uma conexão com o banco.

Parameters:

connectionTimeout - .

setDecayTime

public void setDecayTime(long decayTime)

Tempo, em ms, de decaimento para fechar metade das conexões livres.

Parameters:

decayTime - .

setDelayBetweenOpen

public void setDelayBetweenOpen(long delayBetweenOpen)

Tempo de espera, em ms, entre tentativas de criar conexão com o banco.

Parameters:

delayBetweenOpen - .

setDriver

public void setDriver(String driver)

O driver da base de dados.

Overrides:

setDriver in class Pool

Parameters:

driver - driver.

setFreeConnections

public void setFreeConnections(int freeConnections)

Número mínimo de conexões livres abertas no pool.

Parameters:

freeConnections - .

setMaxConnections

public void setMaxConnections(int maxConnections)

Número máximo de conexões abertas no pool.

Parameters:

maxConnections - .

setMaxUseTimes

public void setMaxUseTimes(int maxUseTimes)

Número máximo de vezes que uma conexão pode ser utilizada.

Parameters:

maxUseTimes - .

setUserPasswordErrorCode

public void setUserPasswordErrorCode(int userPasswordErrorCode)

Define o código de erro utilizado para indicar que o nome de usuário e senha são inválidos para obtenção de uma conexão.

Parameters:

userPasswordErrorCode - código.

getOpenCursors

public static int getOpenCursors(Connection conn)

Retorna o número de cursores abertos em uma conexão.

Parameters:

conn - conexão a ter o número de cursores obtidos.

Returns:

o número de cursores abertos.