org.javabeanstack.data

Class AbstractDAO

java.lang.Object

org.javabeanstack.data.AbstractDAO

All Implemented Interfaces:

Serializable, IGenericDAO

Direct Known Subclasses:

AbstractDataService, GenericDAO

public abstract class AbstractDAO
extends Object
implements IGenericDAO, Serializable

Esta clase se encarga de la conexión con la base de datos. Provee metodos que permiten la recuperación, busqueda, refresco, borrado, inserción y actualización de los registros. Esta clase se ejecuta como EJB en la capa de la lógica del negocio.

Author:

Jorge Enciso

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AbstractDAO()

Method Summary

Modifier and Type	Method and Description
<T extends IDataRow> T	find(Class<T> entityClass, IDBLinkInfo dbLinkInfo, Object id) Devuelve un registro de una tabla dada
<T> List<T>	findAll(Class<T> entityClass, IDBLinkInfo dbLinkInfo) Recupera todos los registros de una tabla
<T extends IDataRow> T	findByNamedQuery(IDBLinkInfo dbLinkInfo, String namedQuery, Map<String,Object> parameters)
List<Object>	findByNativeQuery(IDBLinkInfo dbLinkInfo, String queryString, Map<String,Object> parameters)
List<Object>	findByNativeQuery(IDBLinkInfo dbLinkInfo, String queryString, Map<String,Object> parameters, int first, int max)
<T extends IDataRow> T	findByQuery(Class<T> entityClass, IDBLinkInfo dbLinkInfo, String queryString, Map<String,Object> parameters)
<T extends IDataRow> T	findByUk(Class<T> entityClass, IDBLinkInfo dbLinkInfo, T ejb) Devuelve un registro a travéz de su clave unica.
<T extends IDataRow> List<T>	findListByNamedQuery(IDBLinkInfo dbLinkInfo, String namedQuery, int first, int max)
<T extends IDataRow> List<T>	findListByNamedQuery(IDBLinkInfo dbLinkInfo, String namedQuery, Map<String,Object> parameters)
<T extends IDataRow> List<T>	findListByNamedQuery(IDBLinkInfo dbLinkInfo, String namedQuery, Map<String,Object> parameters, int first, int max)
<T extends IDataRow> List<T>	findListByQuery(IDBLinkInfo dbLinkInfo, String queryString, int first, int max)
<T extends IDataRow> List<T>	findListByQuery(IDBLinkInfo dbLinkInfo, String queryString, Map<String,Object> parameters)
<T extends IDataRow> List<T>	findListByQuery(IDBLinkInfo dbLinkInfo, String queryString, Map<String,Object> parameters, int first, int max)
Connection	getConnection(IDBLinkInfo dbLinkInfo)
Connection	getConnection(IDBLinkInfo dbLinkInfo, IDBConnectFactory conn)
Long	getCount(IDBLinkInfo dbLinkInfo, String queryString, Map<String,Object> parameters) Calcula la cantidad de registros que devolveria una sentencia sql
Long	getCount2(IDBLinkInfo dbLinkInfo, String queryString, Map<String,Object> parameters) Calcula la cantidad de registros que devolveria una sentencia sql
<T extends IDataRow> List<T>	getData(IDBLinkInfo dbLinkInfo, String queryString, int maxRows, boolean noCache)
<T extends IDataRow> List<T>	getData(javax.persistence.Query query)
String	getDataEngine(String persistentUnit)
javax.persistence.EntityManager	getEntityManager(String keyId) Devuelve un entity manager.
Map<String,Object>	getEntityManagerProp(String persistUnit) Busca y devuelve el valor de una propiedad solicitada del entity manager
Map<String,Object>	getPersistUnitProp(String persistUnit) Busca y devuelve el valor de una propiedad solicitada 1
String	getSchema(String persistentUnit)
IUserSession	getUserSession(String sessionId)
<T extends IDataRow> IDataResult	merge(IDBLinkInfo dbLinkInfo, T ejb) Modificar un registro en la tabla dada
<T extends IDataRow> IDataResult	persist(IDBLinkInfo dbLinkInfo, T ejb) Agregar,un registro en la tabla
<T extends IDataRow> List<T>	refreshAll(IDBLinkInfo dbLinkInfo, List<T> rows) Refresca desde la base de datos una lista de objetos.
<T extends IDataRow> T	refreshRow(IDBLinkInfo dbLinkInfo, T row) Refresca desde la base de datos los valores de un objeto.
<T extends IDataRow> IDataResult	remove(IDBLinkInfo dbLinkInfo, T ejb) Borra un registro en la tabla dada
IErrorReg	sqlExec(IDBLinkInfo dbLinkInfo, String sqlString, Map<String,Object> parameters)
<T extends IDataRow> IDataResult	update(IDBLinkInfo dbLinkInfo, IDataObject ejbs) Sincroniza una lista de ejbs con la base de datos.
IDataResult	update(IDBLinkInfo dbLinkInfo, IDataSet dataSet) Sincroniza una lista de ejbs con la base de datos.
<T extends IDataRow> IDataResult	update(IDBLinkInfo dbLinkInfo, List<T> ejbs) Sincroniza una lista de ejbs con la base de datos.
<T extends IDataRow> IDataResult	update(IDBLinkInfo dbLinkInfo, T ejb) Sincroniza un ejb con la base de datos.

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractDAO

public AbstractDAO()

Method Detail

getEntityManager

public javax.persistence.EntityManager getEntityManager(String keyId)

Devuelve un entity manager. Se crea un entity manager por cada thread y unidad de persistencia.

Specified by:

getEntityManager in interface IGenericDAO

Parameters:

keyId -

Returns:

un entity manager

findAll

public <T> List<T> findAll(Class<T> entityClass,
                           IDBLinkInfo dbLinkInfo)
                    throws Exception

Recupera todos los registros de una tabla

Specified by:

findAll in interface IGenericDAO

Type Parameters:

T -

Parameters:

entityClass - clase mapeada a la tabla

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

Returns:

un list con los registros de una tabla

Throws:

Exception

find

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

Devuelve un registro de una tabla dada

Specified by:

find in interface IGenericDAO

Type Parameters:

T -

Parameters:

entityClass - clase mapeada a la tabla

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

id - identificador del registro

Returns:

un registro solicitado

Throws:

Exception

findByUk

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

Devuelve un registro a travéz de su clave unica.

Specified by:

findByUk in interface IGenericDAO

Type Parameters:

T -

Parameters:

entityClass - clase mapeada a una tabla

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

ejb - objeto ejb con los datos de la clave unica

Returns:

Throws:

Exception

findByQuery

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

Specified by:

findByQuery in interface IGenericDAO

Type Parameters:

T -

Parameters:

entityClass - clase mapeada a una tabla

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

queryString - sentencia jpql

parameters - parametros de la sentencia

Returns:

un objeto con valores del registro de la tabla solicitada

Throws:

Exception

findListByQuery

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

Specified by:

findListByQuery in interface IGenericDAO

Type Parameters:

T -

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

queryString - sentencia jpql

parameters - parametros de la sentencia

Returns:

una lista de objetos conteniendo los registros de la tabla solicitada

Throws:

Exception

findListByQuery

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

Specified by:

findListByQuery in interface IGenericDAO

Type Parameters:

T -

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

queryString - sentencia jpql

parameters - parametros de la sentencia

first - a partir de este nro. de registro se va a traer los datos

max - cantidad maxima de registros

Returns:

una lista de objetos conteniendo los registros de la tabla solicitada

Throws:

Exception

findListByQuery

public <T extends IDataRow> List<T> findListByQuery(IDBLinkInfo dbLinkInfo,
                                                    String queryString,
                                                    int first,
                                                    int max)
                                             throws Exception

Specified by:

findListByQuery in interface IGenericDAO

Type Parameters:

T -

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

queryString - sentencia jpql

first - a partir de este nro. de registro se va a traer los datos

max - cantidad maxima de registros

Returns:

una lista de objetos conteniendo los registros de la tabla solicitada

Throws:

Exception

findByNamedQuery

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

Specified by:

findByNamedQuery in interface IGenericDAO

Type Parameters:

T -

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

namedQuery - namedQuery

parameters - parámetros de la sentencia.

Returns:

un objeto con los datos del registro de la tabla solicitada

Throws:

Exception

findListByNamedQuery

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

Specified by:

findListByNamedQuery in interface IGenericDAO

Type Parameters:

T -

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

namedQuery - namedQuery

parameters - parámetros de la sentencia.

Returns:

una lista de objetos con los datos de los registros de la tabla solicitada

Throws:

Exception

findListByNamedQuery

public <T extends IDataRow> List<T> findListByNamedQuery(IDBLinkInfo dbLinkInfo,
                                                         String namedQuery,
                                                         int first,
                                                         int max)
                                                  throws Exception

Specified by:

findListByNamedQuery in interface IGenericDAO

Type Parameters:

T -

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

namedQuery - namedQuery

first - a partir de este nro. de registro se va a traer los datos

max - cantidad maxima de registros

Returns:

una lista de objetos con los datos de los registros de la tabla solicitada

Throws:

Exception

findListByNamedQuery

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

Specified by:

findListByNamedQuery in interface IGenericDAO

Type Parameters:

T -

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

namedQuery - namedQuery

parameters - parámetros de la sentencia.

first - a partir de este nro. de registro se va a traer los datos

max - cantidad maxima de registros

Returns:

una lista de objetos con los registros de la tabla solicitada

Throws:

Exception

findByNativeQuery

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

Specified by:

findByNativeQuery in interface IGenericDAO

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

queryString - sentencia sql

parameters - parámetros de la sentencia.

Returns:

una lista de objetos con datos de los registros solicitados

Throws:

Exception

findByNativeQuery

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

Specified by:

findByNativeQuery in interface IGenericDAO

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

queryString - sentencia sql

parameters - parámetros de la sentencia.

first - a partir de este nro. de registro se va a traer los datos

max - cantidad maxima de registros

Returns:

una lista de objetos con datos de los registros solicitados

Throws:

Exception

sqlExec

public IErrorReg sqlExec(IDBLinkInfo dbLinkInfo,
                         String sqlString,
                         Map<String,Object> parameters)
                  throws Exception

Specified by:

sqlExec in interface IGenericDAO

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

sqlString - sentencia sql

parameters - parámetros de la sentencia.

Returns:

un objeto error si no se ejecuto la sentencia con exito

Throws:

Exception

update

public <T extends IDataRow> IDataResult update(IDBLinkInfo dbLinkInfo,
                                               T ejb)

Sincroniza un ejb con la base de datos.

Specified by:

update in interface IGenericDAO

Type Parameters:

T -

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

ejb - objeto mapeado a un registro de una tabla.

Returns:

Devuelve un objeto con el resultado de la grabación

update

public <T extends IDataRow> IDataResult update(IDBLinkInfo dbLinkInfo,
                                               IDataObject ejbs)

Sincroniza una lista de ejbs con la base de datos.

Specified by:

update in interface IGenericDAO

Type Parameters:

T -

Parameters:

ejbs - lista de objetos mapeados a los registros de una tabla.

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

Returns:

Devuelve un objeto con el resultado de la grabación

update

public <T extends IDataRow> IDataResult update(IDBLinkInfo dbLinkInfo,
                                               List<T> ejbs)

Sincroniza una lista de ejbs con la base de datos.

Specified by:

update in interface IGenericDAO

Type Parameters:

T -

Parameters:

ejbs - lista de objetos mapeados a los registros de una tabla.

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

Returns:

Devuelve un objeto con el resultado de la grabación

update

public IDataResult update(IDBLinkInfo dbLinkInfo,
                          IDataSet dataSet)

Sincroniza una lista de ejbs con la base de datos.

Specified by:

update in interface IGenericDAO

Parameters:

dataSet - set de objetos mapeados a los registros de una tabla.

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

Returns:

Devuelve un objeto con el resultado de la grabación

persist

public <T extends IDataRow> IDataResult persist(IDBLinkInfo dbLinkInfo,
                                                T ejb)

Agregar,un registro en la tabla

Specified by:

persist in interface IGenericDAO

Type Parameters:

T - tipo de dato generalemente hereda de DataRow

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

ejb - el objeto con los valores del registro

Returns:

merge

public <T extends IDataRow> IDataResult merge(IDBLinkInfo dbLinkInfo,
                                              T ejb)

Modificar un registro en la tabla dada

Specified by:

merge in interface IGenericDAO

Type Parameters:

T - tipo de dato generalemente hereda de DataRow

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

ejb - el objeto con los valores del registro

Returns:

remove

public <T extends IDataRow> IDataResult remove(IDBLinkInfo dbLinkInfo,
                                               T ejb)

Borra un registro en la tabla dada

Specified by:

remove in interface IGenericDAO

Type Parameters:

T - tipo de dato generalemente hereda de DataRow

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

ejb - el objeto con los valores del registro

Returns:

getData

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

Specified by:

getData in interface IGenericDAO

Throws:

Exception

getData

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

Specified by:

getData in interface IGenericDAO

Throws:

Exception

refreshRow

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

Refresca desde la base de datos los valores de un objeto.

Specified by:

refreshRow in interface IGenericDAO

Type Parameters:

T -

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

row - objeto o registro a refrescar

Returns:

objeto con los datos refrescados de la base de datos

Throws:

Exception

refreshAll

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

Refresca desde la base de datos una lista de objetos.

Specified by:

refreshAll in interface IGenericDAO

Type Parameters:

T -

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

rows - objetos a refrescar

Returns:

lista de objetos con los datos refrescados de la base de datos

Throws:

Exception

getCount

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

Calcula la cantidad de registros que devolveria una sentencia sql

Specified by:

getCount in interface IGenericDAO

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

queryString - sentencia jpql

parameters - parámetros de la sentencia

Returns:

cantidad de registros que debería devolver la sentencia.

Throws:

Exception

getCount2

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

Calcula la cantidad de registros que devolveria una sentencia sql

Specified by:

getCount2 in interface IGenericDAO

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

queryString - sentencia sql

parameters - parámetros de la sentencia

Returns:

cantidad de registros que debería devolver la sentencia.

Throws:

Exception

getEntityManagerProp

public Map<String,Object> getEntityManagerProp(String persistUnit)

Busca y devuelve el valor de una propiedad solicitada del entity manager

Specified by:

getEntityManagerProp in interface IGenericDAO

Parameters:

persistUnit - unidad de persistencia

Returns:

el valor de una propiedad del entity manager

getPersistUnitProp

public Map<String,Object> getPersistUnitProp(String persistUnit)

Busca y devuelve el valor de una propiedad solicitada 1

Specified by:

getPersistUnitProp in interface IGenericDAO

Parameters:

persistUnit - unidad de persistencia.

Returns:

devuelve un map con todas las propiedades de la unidad de persistencia solicitada

getDataEngine

public String getDataEngine(String persistentUnit)

Specified by:

getDataEngine in interface IGenericDAO

Parameters:

persistentUnit - unidad de persistencia

Returns:

devuelve el nombre del motor de la base de datos

getSchema

public String getSchema(String persistentUnit)

Specified by:

getSchema in interface IGenericDAO

Parameters:

persistentUnit - unidad de persistencia

Returns:

devuelve el schema

getConnection

public Connection getConnection(IDBLinkInfo dbLinkInfo)

Specified by:

getConnection in interface IGenericDAO

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

Returns:

una conexión a la base solo funciona en un ambiente @local no funciona en @Remote

getConnection

public Connection getConnection(IDBLinkInfo dbLinkInfo,
                                IDBConnectFactory conn)

Specified by:

getConnection in interface IGenericDAO

Parameters:

dbLinkInfo - información necesaria para acceder a la conexión de datos correcta (unidad de persistencia, sesión id etc).

conn - objeto factory cuya función es devolver una conexión del entity manager

Returns:

devuelve una conexión del entity manager

getUserSession

public IUserSession getUserSession(String sessionId)

Specified by:

getUserSession in interface IGenericDAO

Parameters:

sessionId - id de sesión del usuario

Returns:

el objeto userSession con la información de la sesión