pt.despodata.java.ddata
Class DDataControlPool

java.lang.Object
  pt.despodata.java.ddata.DDataControlPool

public class DDataControlPool

extends java.lang.Object

Pool de data control(s)
Serve sobretudo para que a informação de tabelas oriundas de um data source não sejam lidas mais do que uma vez.
Sobretudo nas tabelas de descodificação que são muito pouco alteradas justifica-se que estas não estejam sempre a ser lidas.
Desta forma poupa-se memória e (ou) utilização da rede.

Constructor Summary

DDataControlPool()

Method Summary

static DDataControl	_getDataControl(DDataSource _dataSource, java.lang.String tableName, java.lang.String pkColumn, java.lang.String[] descColumns, java.lang.String strWhere, boolean refresh, java.lang.String[] orderBy) Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query relativo ao dataSource definido genericamente para a pool ou relativo ao data source definido para determinada tabela
static void	addDataControl(DDataControl dataControl) Adiciona um dataControl a pool ja existente
static void	addDataSource(DDataSource _dataSource) Deprecated.
static void	clear() Remove todos os DDataControl's da pool.
static DDataControl	createDataControl(DDataSource _dataSource, java.lang.String tableName, java.lang.String pkColumn, java.lang.String descColumn, java.util.ArrayList aditionalColumns, java.lang.String strWhere) Cria um data control de acordo com os parametrosated
static DDataControl	createDataControl(DDataSource _dataSource, java.lang.String tableName, java.lang.String pkColumn, java.lang.String descColumn, java.util.ArrayList aditionalColumns, java.lang.String strWhere, java.lang.String[] orderBy) Cria um data control de acordo com os parametrosated
static DDataControl	CreateDataControl(java.lang.String tableName) Deprecated.
static DDataControl	createDataControl(java.lang.String tableName, java.lang.String pkColumn, java.lang.String descColumn, java.util.ArrayList aditionalColumns, java.lang.String strWhere) Cria um data control de acordo com os parametros
static DDataControl	createDataControl(java.lang.String tableName, java.lang.String pkColumn, java.lang.String descColumn, java.lang.String strWhere) Cria um novo record set para o caso mais simples das descodificacoes ou seja uma coluna na chave primária e uma única como descrição da linha
static java.sql.Connection	getConnection() Deprecated.
static DDataControl	getDataControl(DDataSource _dataSource, java.lang.String tableName, java.lang.String pkColumn, java.lang.String[] descColumns, java.lang.String strWhere, boolean refresh, java.lang.String[] orderBy) Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query relativo ao dataSource definido genericamente para a pool ou relativo ao data source definido para determinada tabela
static DDataControl	getDataControl(DDataSource _dataSource, java.lang.String tableName, java.lang.String pkColumn, java.lang.String descColumn, java.util.ArrayList aditionalColumns, java.lang.String strWhere, boolean refresh) Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query relativo ao dataSource definido genericamente para a pool ou relativo ao data source definido para determinada tabela
static DDataControl	getDataControl(DDataSource _dataSource, java.lang.String tableName, java.lang.String pkColumn, java.lang.String descColumn, java.util.ArrayList aditionalColumns, java.lang.String strWhere, boolean refresh, java.lang.String[] orderBy) Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query relativo ao dataSource definido genericamente para a pool ou relativo ao data source definido para determinada tabela
static DDataControl	getDataControl(java.lang.String tableName, java.lang.String pkColumn, java.lang.String[] descColumns, java.lang.String strWhere) Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query TODO - Atenção aos sincronismos TODO - Poder usar data sources diferentes e especificados para a leitura : Isto faz-se inserindo um novo método com mais parametros
static DDataControl	getDataControl(java.lang.String tableName, java.lang.String pkColumn, java.lang.String descColumn, java.util.ArrayList aditionalColumns, java.lang.String strWhere) Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query relativo ao dataSource definido genericamente para a pool ou relativo ao data source definido para determinada tabela
static DDataControl	getDataControl(java.lang.String tableName, java.lang.String pkColumn, java.lang.String descColumn, java.lang.String strWhere) Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query TODO - Atenção aos sincronismos TODO - Poder usar data sources diferentes e especificados para a leitura : Isto faz-se inserindo um novo método com mais parametros
static DDataControl	getDataControl(java.lang.String tableName, java.lang.String pkColumn, java.lang.String descColumn, java.lang.String strWhere, java.lang.String[] orderBy) Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query TODO - Atenção aos sincronismos TODO - Poder usar data sources diferentes e especificados para a leitura : Isto faz-se inserindo um novo método com mais parametros
static DDataControl	getDataControlForTable(java.lang.String tableName) Devolve uma referencia ao dataControl correspondente a tabela pretendida Se nao existir devolve nulo
static DDataControl	getDataControlForTable(java.lang.String tableName, java.lang.String strWhere) Devolve uma referencia ao dataControl correspondente a tabela pretendida de acordo com restrição where Se nao existir devolve nulo
static void	populateDataControl(java.lang.String tableName) Cria e preenche um recordSet do tipo Snapshot com os dados da tabela enviada como parametro Assume que ja se verificou se existe recordset preenchido para a tabela
static DDataControl	refresh(java.lang.String tableName, java.lang.String pkColumn, java.lang.String[] descColumns, java.lang.String strWhere) Volta a ler o DDataControl, mesmo que este ja esteja em memoria.
static DDataControl	refresh(java.lang.String tableName, java.lang.String pkColumn, java.lang.String[] descColumns, java.lang.String strWhere, java.lang.String[] orderBy) Volta a ler o DDataControl, mesmo que este ja esteja em memoria.
static DDataControl	refresh(java.lang.String tableName, java.lang.String pkColumn, java.lang.String descColumn, java.lang.String strWhere) Volta a ler o DDataControl, mesmo que este ja esteja em memoria.
static DDataControl	refresh(java.lang.String tableName, java.lang.String pkColumn, java.lang.String descColumn, java.lang.String strWhere, java.lang.String[] orderBy) Volta a ler o DDataControl, mesmo que este ja esteja em memoria.
static void	removeAllElements(java.lang.String tableName) Limpa o record set do data control de uma tabela
static void	removeDataControl(java.lang.String tableName) Remove um data control existente em cache para uma tabela cujo nome se envia como parametro
static void	removeDataControl(java.lang.String tableName, java.lang.String where) Remove um data control existente em cache para uma tabela cujo nome se envia como parametro
static void	removeDataSource(DDataSource _dataSource) Deprecated.
static void	setConnection(java.sql.Connection _connection) Deprecated.
static void	setConnection(DDataConnection _connection) Deprecated.

Methods inherited from class java.lang.Object

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

Constructor Detail

DDataControlPool

public DDataControlPool()

Method Detail

_getDataControl

public static DDataControl _getDataControl(DDataSource _dataSource,
                                           java.lang.String tableName,
                                           java.lang.String pkColumn,
                                           java.lang.String[] descColumns,
                                           java.lang.String strWhere,
                                           boolean refresh,
                                           java.lang.String[] orderBy)

Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query relativo ao dataSource definido genericamente para a pool ou relativo ao data source definido para determinada tabela

Parameters:

tableName - Nome da tabela para a qual se pretende obter data control

pkColumn - Coluna que é chave primária

descColumns - Nome das colunas que descrevem a linha

strWhere - String que contem restrição de registos

refresh - true para forcar a leitura da memoria, false caso contrario.

orderBy - Lista de ordenacao para passar para o DataControl.

Returns:

Data control em cache ou criado

clear

public static void clear()

Remove todos os DDataControl's da pool.

populateDataControl

public static void populateDataControl(java.lang.String tableName)

Cria e preenche um recordSet do tipo Snapshot com os dados da tabela enviada como parametro Assume que ja se verificou se existe recordset preenchido para a tabela

removeDataControl

public static void removeDataControl(java.lang.String tableName)

Remove um data control existente em cache para uma tabela cujo nome se envia como parametro

removeDataControl

public static void removeDataControl(java.lang.String tableName,
                                     java.lang.String where)

Remove um data control existente em cache para uma tabela cujo nome se envia como parametro

setConnection

public static void setConnection(DDataConnection _connection)

Deprecated.

Afecta a conexão à base de dados

setConnection

public static void setConnection(java.sql.Connection _connection)

Deprecated.

Afecta a conexão à base de dados

Parameters:

_connection - Conexão já estabelecida por JDBC à base de dados

getConnection

public static java.sql.Connection getConnection()

Deprecated.

Devolve a conexão à base de dados

getDataControl

public static DDataControl getDataControl(java.lang.String tableName,
                                          java.lang.String pkColumn,
                                          java.lang.String descColumn,
                                          java.lang.String strWhere)

Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query TODO - Atenção aos sincronismos TODO - Poder usar data sources diferentes e especificados para a leitura : Isto faz-se inserindo um novo método com mais parametros

getDataControl

public static DDataControl getDataControl(java.lang.String tableName,
                                          java.lang.String pkColumn,
                                          java.lang.String[] descColumns,
                                          java.lang.String strWhere)

Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query TODO - Atenção aos sincronismos TODO - Poder usar data sources diferentes e especificados para a leitura : Isto faz-se inserindo um novo método com mais parametros

getDataControl

public static DDataControl getDataControl(java.lang.String tableName,
                                          java.lang.String pkColumn,
                                          java.lang.String descColumn,
                                          java.lang.String strWhere,
                                          java.lang.String[] orderBy)

Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query TODO - Atenção aos sincronismos TODO - Poder usar data sources diferentes e especificados para a leitura : Isto faz-se inserindo um novo método com mais parametros

Parameters:

tableName - Nome da tabela para a qual se pretende obter data control

pkColumn - Coluna que é chave primária

descColumn - Nome da coluna que descreve a linha

strWhere - String que contem restrição de registos

orderBy - Lista de ordenacao para passar para o DataControl.

getDataControl

public static DDataControl getDataControl(java.lang.String tableName,
                                          java.lang.String pkColumn,
                                          java.lang.String descColumn,
                                          java.util.ArrayList aditionalColumns,
                                          java.lang.String strWhere)

Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query relativo ao dataSource definido genericamente para a pool ou relativo ao data source definido para determinada tabela

Parameters:

tableName - Nome da tabela para a qual se pretende obter data control

pkColumn - Coluna que é chave primária

descColumn - Nome da coluna que descreve a linha

aditionalColumns - Lista de colunas adicionais

strWhere - String que contem restrição de registos

Returns:

Data control em cache ou criado

getDataControl

public static DDataControl getDataControl(DDataSource _dataSource,
                                          java.lang.String tableName,
                                          java.lang.String pkColumn,
                                          java.lang.String descColumn,
                                          java.util.ArrayList aditionalColumns,
                                          java.lang.String strWhere,
                                          boolean refresh)

Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query relativo ao dataSource definido genericamente para a pool ou relativo ao data source definido para determinada tabela

Parameters:

tableName - Nome da tabela para a qual se pretende obter data control

pkColumn - Coluna que é chave primária

descColumn - Nome da coluna que descreve a linha

aditionalColumns - Lista de colunas adicionais

strWhere - String que contem restrição de registos

refresh - true para forcar a leitura da memoria, false caso contrario.

Returns:

Data control em cache ou criado

getDataControl

public static DDataControl getDataControl(DDataSource _dataSource,
                                          java.lang.String tableName,
                                          java.lang.String pkColumn,
                                          java.lang.String descColumn,
                                          java.util.ArrayList aditionalColumns,
                                          java.lang.String strWhere,
                                          boolean refresh,
                                          java.lang.String[] orderBy)

Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query relativo ao dataSource definido genericamente para a pool ou relativo ao data source definido para determinada tabela

Parameters:

tableName - Nome da tabela para a qual se pretende obter data control

pkColumn - Coluna que é chave primária

descColumn - Nome da coluna que descreve a linha

aditionalColumns - Lista de colunas adicionais

strWhere - String que contem restrição de registos

refresh - true para forcar a leitura da memoria, false caso contrario.

orderBy - Lista de ordenacao para passar para o DataControl.

Returns:

Data control em cache ou criado

getDataControl

public static DDataControl getDataControl(DDataSource _dataSource,
                                          java.lang.String tableName,
                                          java.lang.String pkColumn,
                                          java.lang.String[] descColumns,
                                          java.lang.String strWhere,
                                          boolean refresh,
                                          java.lang.String[] orderBy)

Verifica se existe um recordSet para a tabela e se afirmativo devolve-o caso contrario cria-o e efectua o query relativo ao dataSource definido genericamente para a pool ou relativo ao data source definido para determinada tabela

Parameters:

tableName - Nome da tabela para a qual se pretende obter data control

pkColumn - Coluna que é chave primária

strWhere - String que contem restrição de registos

refresh - true para forcar a leitura da memoria, false caso contrario.

orderBy - Lista de ordenacao para passar para o DataControl.

Returns:

Data control em cache ou criado

refresh

public static DDataControl refresh(java.lang.String tableName,
                                   java.lang.String pkColumn,
                                   java.lang.String descColumn,
                                   java.lang.String strWhere)

Volta a ler o DDataControl, mesmo que este ja esteja em memoria.

Returns:

O DDataControl

refresh

public static DDataControl refresh(java.lang.String tableName,
                                   java.lang.String pkColumn,
                                   java.lang.String[] descColumns,
                                   java.lang.String strWhere)

Volta a ler o DDataControl, mesmo que este ja esteja em memoria.

Returns:

O DDataControl

refresh

public static DDataControl refresh(java.lang.String tableName,
                                   java.lang.String pkColumn,
                                   java.lang.String descColumn,
                                   java.lang.String strWhere,
                                   java.lang.String[] orderBy)

Volta a ler o DDataControl, mesmo que este ja esteja em memoria.

Returns:

O DDataControl

refresh

public static DDataControl refresh(java.lang.String tableName,
                                   java.lang.String pkColumn,
                                   java.lang.String[] descColumns,
                                   java.lang.String strWhere,
                                   java.lang.String[] orderBy)

Volta a ler o DDataControl, mesmo que este ja esteja em memoria.

Returns:

O DDataControl

CreateDataControl

public static DDataControl CreateDataControl(java.lang.String tableName)

Deprecated.

Cria um novo record set para uma tabela usando todas as colunas

??? Tem de haver um metodo que receba como parametro um query

createDataControl

public static DDataControl createDataControl(java.lang.String tableName,
                                             java.lang.String pkColumn,
                                             java.lang.String descColumn,
                                             java.lang.String strWhere)

Cria um novo record set para o caso mais simples das descodificacoes ou seja uma coluna na chave primária e uma única como descrição da linha

Parameters:

tableName - Nome da tabela

pkColumn - String que contem o nome da coluna que é chave primária

descColumn - Coluna que é considerada descrição

strWhere - Claúsula de where para restrição

Returns:

Data control criado

createDataControl

public static DDataControl createDataControl(java.lang.String tableName,
                                             java.lang.String pkColumn,
                                             java.lang.String descColumn,
                                             java.util.ArrayList aditionalColumns,
                                             java.lang.String strWhere)

Cria um data control de acordo com os parametros

Parameters:

tableName - Nome da tabela

pkColumn - String que contem o nome da coluna que é chave primária

descColumn - Coluna que é considerada descrição

aditionalColumns - Colunas adicionais tambem pretendidas

strWhere - Claúsula de where para restrição

Returns:

Data control criado

createDataControl

public static DDataControl createDataControl(DDataSource _dataSource,
                                             java.lang.String tableName,
                                             java.lang.String pkColumn,
                                             java.lang.String descColumn,
                                             java.util.ArrayList aditionalColumns,
                                             java.lang.String strWhere)

Cria um data control de acordo com os parametrosated

Parameters:

_dataSource - Origem dos dados

tableName - Nome da tabela

pkColumn - String que contem o nome da coluna que é chave primária

descColumn - Coluna que é considerada descrição

aditionalColumns - Colunas adicionais tambem pretendidas

strWhere - Claúsula de where para restrição

Returns:

Data control criado

createDataControl

public static DDataControl createDataControl(DDataSource _dataSource,
                                             java.lang.String tableName,
                                             java.lang.String pkColumn,
                                             java.lang.String descColumn,
                                             java.util.ArrayList aditionalColumns,
                                             java.lang.String strWhere,
                                             java.lang.String[] orderBy)

Cria um data control de acordo com os parametrosated

Parameters:

_dataSource - Origem dos dados

tableName - Nome da tabela

pkColumn - String que contem o nome da coluna que é chave primária

descColumn - Coluna que é considerada descrição

aditionalColumns - Colunas adicionais tambem pretendidas

strWhere - Claúsula de where para restrição

Returns:

Data control criado

addDataControl

public static void addDataControl(DDataControl dataControl)

Adiciona um dataControl a pool ja existente

getDataControlForTable

public static DDataControl getDataControlForTable(java.lang.String tableName)

Devolve uma referencia ao dataControl correspondente a tabela pretendida

Se nao existir devolve nulo

getDataControlForTable

public static DDataControl getDataControlForTable(java.lang.String tableName,
                                                  java.lang.String strWhere)

Devolve uma referencia ao dataControl correspondente a tabela pretendida de acordo com restrição where
Se nao existir devolve nulo

Parameters:

tableName - Tabela pretendida

strWhere - Restrição por cláusula where

removeAllElements

public static void removeAllElements(java.lang.String tableName)

Limpa o record set do data control de uma tabela

addDataSource

public static void addDataSource(DDataSource _dataSource)

Deprecated.

Adiciona um novo data Source a lista ja existente

Se o novo nao tiver associado qualquer tabela especifica Valida se ja existia algum e se afirmativo atira uma excepcao

removeDataSource

public static void removeDataSource(DDataSource _dataSource)

Deprecated.

Remove um data source similar ao que ja exista (por tabela ou com esta a null)