abk.dao.sql.SqlUtil
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Object
public final class SqlUtil
Contiene métodos de utilidad para el acceso a datos mediante JDBC y las primitivas para implementar la clase ADataMap, así como para sus descendientes.
| Constructor Summary | |
|---|---|
private |
SqlUtil()
|
| Method Summary | ||
|---|---|---|
static void |
beginTransaction(Connection conn)
Quita a la conexión el modo de auto commit, de forma que las siguientes instrucciones de modificación de datos tendrán que se confirmadas con Connection.commit() o canceladas con Connection.rollback(). |
|
static void |
close(Connection conn,
boolean success)
Cierra incondicionalmente una conexión JDBC a la base de datos ejecutando un commit o un rollback en función de que se cierre con éxito o no. |
|
static
|
close(R rs)
Cierra el ResultSet de forma silenciosa, sin lanzar excepciones SQLException y tolerando el envío de objetos nulos. |
|
static
|
close(S stm)
Cierra el Statement de forma silenciosa, sin lanzar excepciones SQLException y tolerando el envío de objetos nulos. |
|
static void |
commit(Connection conn)
Confirma y consolida los cambios realizados en la base de datos a través de la conexión desde el último commit realizado. |
|
static
|
contains(K key,
ADataMapper<K,T> mapper,
Connection conn)
Verifica si la base de datos tiene un registro con la clave indicada. |
|
static
|
containsAll(Collection<T> c,
ADataMapper<K,T> mapper,
Connection conn)
Comprueba que todas las claves pasadas se corresponden con una fila de la base de datos. |
|
static
|
containsKeys(Set<K> keys,
ADataMapper<K,T> mapper,
Connection conn)
Devuelve el número de claves que figuran en la base de datos entre el conjunto de claves que se le pasa. |
|
static
|
delete(K key,
ADataMapper<K,T> mapper,
Connection conn)
Borra un registro de la base de datos a partir de su clave. |
|
static int |
deleteAll(ADataMapper<?,?> mapper,
Connection conn)
Borra todos los registros de la tabla asociada al mapeador. |
|
static
|
find(K key,
boolean forUpdate,
ADataMapper<K,T> mapper,
Connection conn)
Devuelve el contenido del registro en forma de objeto T a partir de la clave primaria del registro. |
|
static Connection |
getConnection(ResultSet rs)
Devuelve la conexión asociada a un objeto ResultSet. |
|
static
|
insert(T data,
ADataMapper<K,T> mapper,
Connection conn)
Realiza una operación INSERT en la base de datos usando el método autogenerado para obtener la clave asignada automáticamente al nuevo registro. |
|
private static
|
insertWithAutoIncrement(T data,
ADataMapper<K,T> mapper,
Connection conn)
Realiza una operación INSERT en la base de datos usando el método autogenerado para obtener la clave asignada automáticamente al nuevo registro. |
|
private static
|
insertWithSequence(T data,
ADataMapper<K,T> mapper,
Connection conn)
Realiza una operación INSERT en la base de datos usando una secuencia Oracle para obtener la clave asignada automáticamente al nuevo registro. |
|
static
|
keySet(ADataMapper<K,T> mapper,
Connection conn)
Devuelve el conjunto de claves de la tabla. |
|
static
|
load(T data,
ADataMapper<K,T> mapper,
Connection conn)
Carga una entidad desde la base de datos. |
|
static
|
loadAll(ADataMapper<K,T> mapper,
Connection conn)
Carga todos los registros de la tabla de la base de datos. |
|
private static ALogger |
logger()
Crea un logger para la clase SqlUtil. |
|
static Number |
mysqlLastInsertId(Connection conn)
Deprecated. Si se utiliza está función el código no podrá reutilizarse en otro motor de base de datos. |
|
static Date |
parseDate(String s)
|
|
static Time |
parseTime(String s)
|
|
static Timestamp |
parseTimestamp(String s)
|
|
static
|
put(T data,
boolean lock,
ADataMapper<K,T> mapper,
Connection conn)
Pone un objeto en la base de datos, reemplazando su valor antiguo si lo tuviera o insertándolo si no existiese ninguna fila con la misma clave del objeto. |
|
static
|
putAll(Collection<? extends T> c,
ADataMapper<K,T> mapper,
Connection conn)
Inserta o actualiza la base de datos con la colección de objetos de transferencia que se le pasan. |
|
static
|
remove(K key,
boolean lock,
ADataMapper<K,T> mapper,
Connection conn)
Borra un registro de la base de datos a partir de su clave, pero recuperando primero el contenido del registro a borrar. |
|
static void |
rollback(Connection conn)
Cancela los cambios realizados en la base de datos a través de la conexión desde el último commit realizado. |
|
static
|
save(T data,
ADataMapper<K,T> mapper,
Connection conn)
Graba un nuevo objeto insertándolo en la base de datos. |
|
static
|
saveAll(Iterable<? extends T> all,
ADataMapper<K,T> mapper,
Connection conn)
Graba una colección de objetos en la base de datos. |
|
static int |
size(ADataMapper<?,?> mapper,
Connection conn)
Devuelve la cantidad de filas que tiene una tabla de la base de datos. |
|
static SQLException |
sqlException(Throwable ex)
Devuelve una excepción SQL. |
|
static
|
update(T data,
ADataMapper<K,T> mapper,
Connection conn)
Actualiza un registro de la base de datos con los valores de las propiedades que se le pasan en el objeto. |
|
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
private SqlUtil()
| Method Detail |
|---|
private static final ALogger logger()
public static final Date parseDate(String s)
throws SQLException
SQLException
public static final Time parseTime(String s)
throws SQLException
SQLException
public static final Timestamp parseTimestamp(String s)
throws SQLException
SQLExceptionpublic static final SQLException sqlException(Throwable ex)
ex - Excepción que se le pasa.
RuntimeException - si ex es de tipo RuntimeException.
Error - si ex es de tipo Error.
public static final void close(Connection conn,
boolean success)
throws IOException
conn - Conexión a cerrar.success - Indicación de si la operación tuvo éxito, y se debe realizar un
Connection.commit(), o si falló por lo que se
debe hacer un Connection.rollback() antes de
cerrar.
IOException - si se produce una excepción SQLException
durante la operación, en cuyo caso dicha excepción original figurará como
causa de la excepción lanzada.public static final <R extends ResultSet> R close(R rs)
R - Tipo de objeto que se está cerrando.rs - ResultSet a cerrar.
null pero como tipo de dato T.public static final <S extends Statement> S close(S stm)
S - Tipo de objeto que se está cerrando.stm - Statement a cerrar.
null pero como tipo de dato T.
public static final void beginTransaction(Connection conn)
throws SQLException
conn - Conexión a la base de datos.
SQLException - si se produce algún error.
NullPointerException - si se produce una SQLException.Connection.setAutoCommit(boolean)public static final void commit(Connection conn)
Al realizar el commit la conexión se activa también el modo auto commit de la conexión.
conn - Conexión a la base de datos.
NullPointerException - si conn es null.Connection.commit(),
Connection.setAutoCommit(boolean)public static final void rollback(Connection conn)
Al ejecutar el rollback la conexión se activa también el modo auto commit de la conexión.
conn - Conexión a la base de datos.
NullPointerException - si conn es null.Connection.rollback(),
Connection.setAutoCommit(boolean)
public static final Connection getConnection(ResultSet rs)
throws SQLException
rs - Instancia de ResultSet
null si rs es nulo o no se ha
obtenido a través de una sentencia SQL.
SQLException - si se produce un error en el acceso a datos o si el objeto
ResultSet estaba cerrado.ResultSet,
ResultSet.getStatement()
@Deprecated
public static final Number mysqlLastInsertId(Connection conn)
throws SQLException
conn - Conexión con la base de datos.
null si no existe tal valor.
SQLException - si se produce un error.ASqlStatement.getGeneratedKey(ADataMapper)
public static final int size(ADataMapper<?,?> mapper,
Connection conn)
throws SQLException
mapper - Mapeador del objeto con los recursos SQL.conn - Conexión con la base de datos.
NullPointerException - si cualquiera de los argumentos es null.
SQLException - si se produce algún error.
public static final <K extends Serializable,T extends IDataItem<K>> boolean contains(K key,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de dato de la clave.key - Valor de la clave.mapper - Mapeador del tipo de objeto a recursos de la base de datos.conn - Conexión con la base de datos.
true si existe al menos registro con la clave indicada.
NullPointerException - si mapper o conn son nulos.
SQLException - si se produce un error en el acceso a datos.
public static final <K extends Serializable,T extends IDataItem<K>> boolean load(T data,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave del objeto al que se mapea el resultado.T - Tipo del objeto al que se mapea el resultado.data - Entidad a cargar. El campo con la clave debe estar inicializado.mapper - Mapeador del tipo de dato.conn - Conexión a la base de datos.
true si el dato se ha cargado, o false si no se ha encontrado
el objeto.
NullPointerException - si alguno de los argumentos es nulo.
SQLException - Excepción de SQL.
public static final <K extends Serializable,T extends IDataItem<K>> T find(K key,
boolean forUpdate,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave.T - Tipo del objeto a devolver.key - Valor de la clave.forUpdate - true si se quiere bloquear el registro encontrado en la base de
datos.mapper - Mapeador del tipo T a recursos de la conexión a base de datos.conn - Conexión con la base de datos.
null si no existe tal objeto o key es nulo.
NullPointerException - si mapper o conn son nulos.
SQLException - si hay un error de acceso a datos.
public static final <K extends Serializable,T extends IDataItem<K>> List<T> loadAll(ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave.T - Tipo del objeto al que se mapean los registros.mapper - Mapeador del tipo T a recursos de la conexión a base de datos.conn - Conexión.
NullPointerException - si mapper o conn son nulos.
SQLException - Error de acceso a datos.
public static final <K extends Serializable,T extends IDataItem<K>> boolean save(T data,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave.T - Tipo del objeto al que se mapean los registros.data - Dato a grabar.mapper - Mapeador del tipo T a recursos de la conexión a base de datos.conn - Conexión.
true si el registro se añadió correctamente.
NullArgumentException - si alguno de los argumentos es nulo.
SQLException - si se produce un error de acceso a datos.insert(T, abk.dao.sql.ADataMapper, java.sql.Connection)
public static final <K extends Serializable,T extends IDataItem<K>> boolean saveAll(Iterable<? extends T> all,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave de los objetos.T - Tipo de los objetos.all - Colección de objetos.mapper - Mapeador del tipo T a recursos de la conexión a base de datos.conn - Conexión.
true si se han grabado todos los objetos. En otro caso se devuelve
false y no se graba ningún objeto.
NullArgumentException - si alguno de los argumentos es nulo.
SQLException - si se produce un error de acceso a datos.
public static final <K extends Serializable,T extends IDataItem<K>> K insert(T data,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
El método comprueba si el mapeador tiene una secuencia. Si la tiene invoca a insertWithSequence(IDataItem, ADataMapper, Connection). En caso contrario invoca a insertWithAutoIncrement(IDataItem, ADataMapper, Connection).
K - Tipo de la clave.T - Tipo del objeto en el que se mapea el registro.data - Objeto a insertar en la base de datos. Su propiedad key es ignorada.mapper - Mapeador del tipo T a recursos de la conexión a base de datos.conn - Conexión con la base de datos.
null si la inserción ha fallado.
NullPointerException - si alguno de los argumentos es nulo.
SQLException - si se produce un error de acceso a datos.
private static final <K extends Serializable,T extends IDataItem<K>> K insertWithAutoIncrement(T data,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave.T - Tipo del objeto en el que se mapea el registro.data - Objeto a insertar en la base de datos. Su propiedad key es ignorada.mapper - Mapeador del tipo T a recursos de la conexión a base de datos.conn - Conexión con la base de datos.
null si la inserción ha fallado.
NullArgumentException - si alguno de los argumentos es nulo.
SQLException - si se produce un error de acceso a datos.
private static final <K extends Serializable,T extends IDataItem<K>> K insertWithSequence(T data,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave.T - Tipo del objeto en el que se mapea el registro.data - Objeto a insertar en la base de datos. Su propiedad key es ignorada.mapper - Mapeador del tipo T a recursos de la conexión a base de datos.conn - Conexión con la base de datos.
null si la inserción ha fallado.
NullPointerException - si alguno de los argumentos es nulo.
SQLException - si se produce un error de acceso a datos.
public static final <K extends Serializable,T extends IDataItem<K>> boolean update(T data,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave.T - Tipo del objeto en el que se mapea el registro.data - Objeto con los datos para actualizar el registro.mapper - Mapeador del tipo T a recursos de la conexión a base de datos.conn - Conexión con la base de datos.
true si la operación se realizó con éxito, o false en caso contrario.
NullArgumentException - si alguno de los argumentos es nulo.
SQLException - si se produce un error de acceso a datos.
public static final <K extends Serializable,T extends IDataItem<K>> T put(T data,
boolean lock,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave del objeto.T - Tipo del objeto.data - Objeto a poner.lock - Indica que se bloquee la fila de la tabla entre que se encuentre y se actualice.mapper - Mapeador del tipo de objeto a objetos de SQL.conn - Conexión con la base de datos.
null si no había
ningún registro con la misma clave de item.
NullArgumentException - si alguno de los argumentos es nulo.
SQLException - si se produce un error de acceso a datos.
public static final <K extends Serializable,T extends IDataItem<K>> void putAll(Collection<? extends T> c,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave primaria del objeto.T - Tipo del objeto de transferencia.c - Colección de objetos a grabar o actualizar en la base de datos.mapper - Mapeador del tipo de objeto a objetos de SQL.conn - Conexión con la base de datos.
NullArgumentException - si mapper es nulo.
SQLException - si se produce un error de acceso a datos.
public static final <K extends Serializable,T extends IDataItem<K>> boolean delete(K key,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave del objeto.key - Valor de la clave del registro a borrar.mapper - Mapeador del tipo de objeto a objetos de SQL.conn - Conexión con la base de datos.
true si la clave identificaba a un registro y éste ha sido borrado.
false en otro caso, incluyendo que key sea nulo.
NullPointerException - si mapper o conn son nulos.
SQLException - si se produce un error de acceso a datos.
public static final <K extends Serializable,T extends IDataItem<K>> T remove(K key,
boolean lock,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave del objeto.T - Tipo del objeto.key - Clave que identifica el registro a borrar.lock - Indica que se bloquee la fila de la tabla entre que se encuentre y se actualice.mapper - Mapeador del tipo de objeto a objetos de SQL.conn - Conexión con la base de datos.
NullPointerException - si mapper o conn son nulos.
SQLException - si se produce un error de acceso a datos.
public static int deleteAll(ADataMapper<?,?> mapper,
Connection conn)
throws SQLException
mapper - Mapeador del tipo de objeto a objetos de SQL.conn - Conexión con la base de datos.
NullPointerException - si mapper o conn son nulos.
SQLException - si se produce un error de acceso a datos.
public static final <K extends Serializable,T extends IDataItem<K>> Set<K> keySet(ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave del objeto.mapper - Mapeador del tipo de objeto a objetos de SQL.conn - Conexión con la base de datos.
null.
NullPointerException - si cualquiera de los argumentos es null.
ClassCastException - si los valores devueltos no son de tipo K.
SQLException - si se produce un error de acceso a datos.
public static final <K extends Serializable,T extends IDataItem<K>> boolean containsAll(Collection<T> c,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave.T - Tipo de la entidad mapeada a la tabla.c - Colección de entidades cuyas claves se verifican.mapper - Mapeador del tipo de objeto a objetos de SQL.conn - Conexión con la base de datos.
true si todos los registros que se le pasan tienen en la tabla de datos su
fila correspondiente con la misma clave primaria.
SQLException - si se produce un error de acceso a datos.
NullPointerException - si alguno de los argumentos es nulo, o si alguna de los objetos,
o sus claves primarias, recibidas desde c es nula.
public static final <K extends Serializable,T extends IDataItem<K>> int containsKeys(Set<K> keys,
ADataMapper<K,T> mapper,
Connection conn)
throws SQLException
K - Tipo de la clave.keys - Conjunto de claves a comprobar.mapper - Mapeador del tipo de objeto a objetos de SQL.conn - Conexión con la base de datos.
SQLException - si se produce un error de acceso a datos.
NullPointerException - si alguno de los argumentos es nulo, o si alguna de las claves
recibidas desde keys es nula.
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||