org.javabeanstack.data

Class AbstractDataLink

java.lang.Object

org.javabeanstack.data.AbstractDataLink

All Implemented Interfaces:

Serializable, IDataLink

Direct Known Subclasses:

DataLink

public abstract class AbstractDataLink
extends Object
implements IDataLink, Serializable

Es un wrapper de AbstractDao, gestiona el acceso a los datos. El test unitario se encuentra en TestProjects clase py.com.oym.test.data.TestDataLink

Author:

Jorge Enciso

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AbstractDataLink()

Method Summary

Modifier and Type	Method and Description
<T extends IDataRow> T	find(Class<T> entityClass, Object id) Devuelve un registro de datos.
<T extends IDataRow> T	findByNamedQuery(String namedQuery, Map<String,Object> parameters) Devuelve un registro resultado de la selección de datos en una base de datos
List<Object>	findByNativeQuery(String queryString, Map<String,Object> parameters) Devuelve una lista de registros resultado de la selección de datos en una base de datos, utilizando una sentencia nativa.
List<Object>	findByNativeQuery(String queryString, Map<String,Object> parameters, int first, int max) Devuelve una lista de registros resultado de la selección de datos en una base de datos, utilizando una sentencia nativa.
<T extends IDataRow> T	findByQuery(Class<T> entityClass, String queryString, Map<String,Object> parameters) Devuelve un registro
<T extends IDataRow> T	findByUk(Class<T> entityClass, T ejb) Devuelve un registro de datos.
<T extends IDataRow> List<T>	findListByNamedQuery(String namedQuery, Map<String,Object> parameters) Devuelve una lista de registros resultado de la selección de datos en una base de datos
<T extends IDataRow> List<T>	findListByNamedQuery(String namedQuery, Map<String,Object> parameters, int first, int max) Devuelve una lista de registros resultado de la selección de datos en una base de datos
<T extends IDataRow> List<T>	findListByQuery(String queryString, Map<String,Object> parameters) Devuelve una lista de registros resultado de la selección de datos en una base de datos
<T extends IDataRow> List<T>	findListByQuery(String queryString, Map<String,Object> parameters, int first, int max) Devuelve una lista de registros resultado de la selección de datos en una base de datos
Connection	getConnection()
Connection	getConnection(IDBConnectFactory conn)
Long	getCount(String queryString, Map<String,Object> parameters) Devuelve la cantidad de registros que resultaria de una sentencia JPQL
Long	getCount2(String queryString, Map<String,Object> parameters) Devuelve la cantidad de registros que resultaria de una sentencia NATIVE
abstract IGenericDAO	getDao() Es el objeto responsable del acceso a los datos
<T extends IDataRow> List<T>	getData(javax.persistence.Query query)
<T extends IDataRow> List<T>	getData(String queryString, int maxRows, boolean noCache)
abstract <T extends IDataService> T	getDataService() Es el objeto responsable del acceso a los datos y logica del negocio
String	getEntitiesRelation(String entities, String typeRela, String schema) Genera una expresión con las relaciones de las entidades solicitadas.
Map<String,Object>	getEntityManagerProp() Devuelve un objeto Map con las propiedades del entity manager del dao
String	getPersistUnit() Unidad de persistencia donde esta configurado los parámetros de la conexión a la base de datos
Map<String,Object>	getPersistUnitProp() Devuelve un objeto Map con las propiedades de la conexión de datos.
IUserSession	getUserSession() Devuelve el objeto userSession resultante del login del usuario
<T extends IDataRow> IDataResult	merge(List<T> ejbs) Actualizar registros en la tabla
<T extends IDataRow> IDataResult	merge(T ejb) Actualizar un registro en la tabla
IDataNativeQuery	newDataNativeQuery() Devuelve un objeto DataNativeQuery que permitira ejecutar
<T extends IDataRow> IDataResult	persist(List<T> ejbs) Agregar registros a la tabla
<T extends IDataRow> IDataResult	persist(T ejb) Agrega un registro en la tabla
<T extends IDataRow> List<T>	refreshAll(List<T> rows) Refresca una lista de registros
<T extends IDataRow> T	refreshRow(T row) Refresca los datos de un registro en la base de datos.
<T extends IDataRow> IDataResult	remove(List<T> ejbs) Borrar registros de la tabla
<T extends IDataRow> IDataResult	remove(T ejb) Borrar un registro de la tabla
abstract <T extends IGenericDAO> void	setDao(T dao)
void	setUserSession(IUserSession userSession) Asigna el objeto userSession a esta clase lo que permitira acceder al esquema de datos de la base de datos.
<T extends IDataRow> IDataResult	update(IDataSet dataSet) Agregar, actualiza o borra registros de la base de datos
<T extends IDataRow> IDataResult	update(List<T> ejbs) Agregar, actualiza o borra registros de la base de datos
<T extends IDataRow> IDataResult	update(T ejb) Agrega, actualiza o borra registros de la base de datos

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractDataLink

public AbstractDataLink()

Method Detail

getDao

public abstract IGenericDAO getDao()

Es el objeto responsable del acceso a los datos

Specified by:

getDao in interface IDataLink

Returns:

dao

setDao

public abstract <T extends IGenericDAO> void setDao(T dao)

Specified by:

setDao in interface IDataLink

getDataService

public abstract <T extends IDataService> T getDataService()

Es el objeto responsable del acceso a los datos y logica del negocio

Specified by:

getDataService in interface IDataLink

Type Parameters:

T -

Returns:

la instancia del dataService

getPersistUnit

public String getPersistUnit()

Unidad de persistencia donde esta configurado los parámetros de la conexión a la base de datos

Specified by:

getPersistUnit in interface IDataLink

Returns:

unidad de persistencia

persist

public <T extends IDataRow> IDataResult persist(T ejb)
                                         throws SessionError

Agrega un registro en la tabla

Specified by:

persist in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

ejb - el objeto con los valores del registro

Returns:

dataResult (resultado del persist)

Throws:

SessionError

persist

public <T extends IDataRow> IDataResult persist(List<T> ejbs)
                                         throws SessionError

Agregar registros a la tabla

Specified by:

persist in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

ejbs - lista con los objetos con los valores de los registros

Returns:

dataResult (resultado del persist)

Throws:

SessionError

merge

public <T extends IDataRow> IDataResult merge(T ejb)
                                       throws SessionError

Actualizar un registro en la tabla

Specified by:

merge in interface IDataLink

Type Parameters:

T - tipo de dato generalemente hereda de DataRow

Parameters:

ejb - el objeto con los valores del registro

Returns:

dataResult (resultado del merge)

Throws:

SessionError

merge

public <T extends IDataRow> IDataResult merge(List<T> ejbs)
                                       throws SessionError

Actualizar registros en la tabla

Specified by:

merge in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

ejbs - lista con los objetos con los valores de los registros

Returns:

dataResult (resultado del merge)

Throws:

SessionError

remove

public <T extends IDataRow> IDataResult remove(T ejb)
                                        throws SessionError

Borrar un registro de la tabla

Specified by:

remove in interface IDataLink

Type Parameters:

T - tipo de dato generalemente hereda de DataRow

Parameters:

ejb - el objeto con los valores del registro

Returns:

dataResult (resultado del remove)

Throws:

SessionError

remove

public <T extends IDataRow> IDataResult remove(List<T> ejbs)
                                        throws SessionError

Borrar registros de la tabla

Specified by:

remove in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

ejbs - lista con los objetos con los valores de los registros

Returns:

dataResult (resultado del remove)

Throws:

SessionError

update

public <T extends IDataRow> IDataResult update(T ejb)
                                        throws SessionError

Agrega, actualiza o borra registros de la base de datos

Specified by:

update in interface IDataLink

Type Parameters:

T - tipo de dato generalemente hereda de DataRow

Parameters:

ejb - el objeto con los valores del registro

Returns:

dataResult (resultado del update)

Throws:

SessionError

update

public <T extends IDataRow> IDataResult update(List<T> ejbs)
                                        throws SessionError

Agregar, actualiza o borra registros de la base de datos

Specified by:

update in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

ejbs - lista con los objetos con los valores de los registros

Returns:

dataResult (resultado del update)

Throws:

SessionError

update

public <T extends IDataRow> IDataResult update(IDataSet dataSet)
                                        throws SessionError

Agregar, actualiza o borra registros de la base de datos

Specified by:

update in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

dataSet - cada elemento del dataSet contiene una lista con los objetos mapeados a los registros de cada tabla

Returns:

dataResult (resultado del update)

Throws:

SessionError

find

public <T extends IDataRow> T find(Class<T> entityClass,
                                   Object id)
                            throws Exception,
                                   SessionError

Devuelve un registro de datos.

Specified by:

find in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

entityClass - tipo de dato o clase solicitada

id - identificador del registro (clave primaria).

Returns:

Objeto con los datos del registro.

Throws:

Exception

SessionError

findByUk

public <T extends IDataRow> T findByUk(Class<T> entityClass,
                                       T ejb)
                                throws Exception,
                                       SessionError

Devuelve un registro de datos.

Specified by:

findByUk in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

entityClass - tipo de dato o clase solicitada

ejb - objeto conteniendo datos necesarios para llegar a recuperar el registro a travéz de los campos de la clave unica

Returns:

Objeto con los datos del registro

Throws:

Exception

SessionError

findByQuery

public <T extends IDataRow> T findByQuery(Class<T> entityClass,
                                          String queryString,
                                          Map<String,Object> parameters)
                                   throws Exception,
                                          SessionError

Devuelve un registro

Specified by:

findByQuery in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

entityClass - tipo de dato o clase solicitada

queryString - sentencia JPQL que se ejecutará para recuperar los datos

parameters - parametros de la sentencia.

Returns:

Devuelve un registro

Throws:

Exception

SessionError

findListByQuery

public <T extends IDataRow> List<T> findListByQuery(String queryString,
                                                    Map<String,Object> parameters)
                                             throws Exception,
                                                    SessionError

Devuelve una lista de registros resultado de la selección de datos en una base de datos

Specified by:

findListByQuery in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

queryString - sentencia JPQL que se ejecutará para recuperar los datos

parameters - parametros de la sentencia.

Returns:

una lista de registros

Throws:

Exception

SessionError

findListByQuery

public <T extends IDataRow> List<T> findListByQuery(String queryString,
                                                    Map<String,Object> parameters,
                                                    int first,
                                                    int max)
                                             throws Exception,
                                                    SessionError

Devuelve una lista de registros resultado de la selección de datos en una base de datos

Specified by:

findListByQuery in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

queryString - sentencia JPQL que se ejecutará para recuperar los datos

parameters - parametros de la sentencia.

first - a partir de un registro determinado del conjunto

max - máxima cantidad de registros.

Returns:

una lista de registros

Throws:

Exception

SessionError

findByNamedQuery

public <T extends IDataRow> T findByNamedQuery(String namedQuery,
                                               Map<String,Object> parameters)
                                        throws Exception,
                                               SessionError

Devuelve un registro resultado de la selección de datos en una base de datos

Specified by:

findByNamedQuery in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

namedQuery - nombre del query definido en el EJB

parameters - parametros de la sentencia.

Returns:

una lista de registros

Throws:

Exception

SessionError

findListByNamedQuery

public <T extends IDataRow> List<T> findListByNamedQuery(String namedQuery,
                                                         Map<String,Object> parameters)
                                                  throws Exception,
                                                         SessionError

Devuelve una lista de registros resultado de la selección de datos en una base de datos

Specified by:

findListByNamedQuery in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

namedQuery - nombre del query definido en el EJB

parameters - parametros de la sentencia.

Returns:

una lista de registros

Throws:

Exception

SessionError

findListByNamedQuery

public <T extends IDataRow> List<T> findListByNamedQuery(String namedQuery,
                                                         Map<String,Object> parameters,
                                                         int first,
                                                         int max)
                                                  throws Exception,
                                                         SessionError

Devuelve una lista de registros resultado de la selección de datos en una base de datos

Specified by:

findListByNamedQuery in interface IDataLink

Type Parameters:

T - tipo de dato generalmente hereda de DataRow

Parameters:

namedQuery - nombre del query definido en el EJB

parameters - parametros de la sentencia.

first - puntero que define el nro de registro a partir del cual va a recuperar los datos

max - máxima cantidad de registros.

Returns:

una lista de registros

Throws:

Exception

SessionError

findByNativeQuery

public List<Object> findByNativeQuery(String queryString,
                                      Map<String,Object> parameters)
                               throws Exception,
                                      SessionError

Devuelve una lista de registros resultado de la selección de datos en una base de datos, utilizando una sentencia nativa.

Specified by:

findByNativeQuery in interface IDataLink

Parameters:

queryString - sentencia select

parameters - parametros de la sentencia

Returns:

una lista de registros

Throws:

Exception

SessionError

findByNativeQuery

public List<Object> findByNativeQuery(String queryString,
                                      Map<String,Object> parameters,
                                      int first,
                                      int max)
                               throws Exception,
                                      SessionError

Devuelve una lista de registros resultado de la selección de datos en una base de datos, utilizando una sentencia nativa.

Specified by:

findByNativeQuery in interface IDataLink

Parameters:

queryString - sentencia select

parameters - parametros de la sentencia

first - puntero que define el nro de registro a partir del cual va a recuperar los datos

max - máxima cantidad de registros.

Returns:

una lista de registros

Throws:

Exception

SessionError

getData

public <T extends IDataRow> List<T> getData(String queryString,
                                            int maxRows,
                                            boolean noCache)
                                     throws Exception,
                                            SessionError

Specified by:

getData in interface IDataLink

Throws:

Exception

SessionError

getData

public <T extends IDataRow> List<T> getData(javax.persistence.Query query)
                                     throws Exception,
                                            SessionError

Specified by:

getData in interface IDataLink

Throws:

Exception

SessionError

refreshRow

public <T extends IDataRow> T refreshRow(T row)
                                  throws Exception,
                                         SessionError

Refresca los datos de un registro en la base de datos.

Specified by:

refreshRow in interface IDataLink

Type Parameters:

T -

Parameters:

row - registro a refrescar de la base

Returns:

Throws:

Exception

SessionError

refreshAll

public <T extends IDataRow> List<T> refreshAll(List<T> rows)
                                        throws Exception,
                                               SessionError

Refresca una lista de registros

Specified by:

refreshAll in interface IDataLink

Type Parameters:

T -

Parameters:

rows - lista de registros

Returns:

lista de registros con los datos renovados de la base de datos.

Throws:

Exception

SessionError

getCount

public Long getCount(String queryString,
                     Map<String,Object> parameters)
              throws Exception,
                     SessionError

Devuelve la cantidad de registros que resultaria de una sentencia JPQL

Specified by:

getCount in interface IDataLink

Parameters:

queryString - sentencia JPQL

parameters - parametros de la sentencia

Returns:

la cantidad de registros

Throws:

Exception

SessionError

getCount2

public Long getCount2(String queryString,
                      Map<String,Object> parameters)
               throws Exception,
                      SessionError

Devuelve la cantidad de registros que resultaria de una sentencia NATIVE

Specified by:

getCount2 in interface IDataLink

Parameters:

queryString - sentencia JPQL

parameters - parametros de la sentencia

Returns:

la cantidad de registros

Throws:

Exception

SessionError

getEntityManagerProp

public Map<String,Object> getEntityManagerProp()

Devuelve un objeto Map con las propiedades del entity manager del dao

Specified by:

getEntityManagerProp in interface IDataLink

Returns:

getPersistUnitProp

public Map<String,Object> getPersistUnitProp()

Devuelve un objeto Map con las propiedades de la conexión de datos.

Specified by:

getPersistUnitProp in interface IDataLink

Returns:

getUserSession

public IUserSession getUserSession()

Devuelve el objeto userSession resultante del login del usuario

Specified by:

getUserSession in interface IDataLink

Returns:

userSession

setUserSession

public void setUserSession(IUserSession userSession)
                    throws SessionError

Asigna el objeto userSession a esta clase lo que permitira acceder al esquema de datos de la base de datos.

Specified by:

setUserSession in interface IDataLink

Parameters:

userSession - objeto resultante del login del usuario

Throws:

SessionError

newDataNativeQuery

public IDataNativeQuery newDataNativeQuery()

Devuelve un objeto DataNativeQuery que permitira ejecutar

Specified by:

newDataNativeQuery in interface IDataLink

Returns:

instancia de un objeto DataNativeQuery

getEntitiesRelation

public String getEntitiesRelation(String entities,
                                  String typeRela,
                                  String schema)
                           throws Exception,
                                  SessionError

Genera una expresión con las relaciones de las entidades solicitadas.

Specified by:

getEntitiesRelation in interface IDataLink

Parameters:

entities - lista de entidades (tablas, vistas)

typeRela - tipo de relacion (inner, left, right, full) es opcional

schema - nombre del schema que se agregará en la instrucción.

Returns:

expresión join.

Throws:

Exception

SessionError

getConnection

public Connection getConnection()

Specified by:

getConnection in interface IDataLink

getConnection

public Connection getConnection(IDBConnectFactory conn)

Specified by:

getConnection in interface IDataLink