![]() |
Gestión de Bases de datos en Internet: JDBC |
La interfaz Statement
Mediante esta interfaz, se envían las órdenes SQL individuales a la base de datos a través del controlador JDBC y se recogen los resultados de las mismas.
Los métodos
Conjuntos de resultados simples: executeQuery ()
public abstract ResultSet executeQuery(String ordenSQL) throws SQLException
Devuelve en un objeto ResultSet el resultado de una orden simple, normalmente
una sentencia SELECT.
Sentencias de modificación: executeUpdate()
public abstract int executeUpdate(String ordenSQL) throws SQLException
Devuelve el número de filas
afectadas si la ordenSQLha sido INSERT, UPDATE o DELETE, o bien cero
si la orden fue de definicion de tablas (DDL).
Finalización de sentencias: close()
public abstract void close() throws SQLException
Cierra inmediatamente la sentencia,
liberando la bvase de datos y los recursos utilizados.
Comprobación del tamaño máximo de los campos: getMaxFieldSize ()
public abstract int getMaxFieldSize() throws SQLException
Obtiene el máximo tamaño en bytes
de los campos de tipo SQL BINARY, VARBINARY, LONGVARBINARY, CHAR,
VARCHAR, y LONGVARCHAR. El exceso es ignorado sin más. El cero
significa sin limitar.
Definición del tamaño máximo de los campos: setMaxFieldSize ()
public abstract void setMaxFieldSize(int maximo) throws SQLException
Configura el máximo tamaño en bytes
que puede leerse de los campos de tipo SQL BINARY, VARBINARY,
LONGVARBINARY, CHAR, VARCHAR, y LONGVARCHAR. El exceso es
ignorado sin más. El cero significa sin limitar.
Comprobación del número máximo de filas: getMaxRows()
public abstract int getMaxRows() throws SQLException
Devuelve el número máximo de filas
que puede devolver un ResultSet. El exceso es ignorado sin más.
El cero significa sin limitar.
Configuración del número máximo de filas: getMaxRows ()
public abstract void setMaxRows(int maximo) throws SQLException
Configura el número máximo de filas
que puede devolver un ResultSet. El exceso es ignorado sin más.
El cero significa sin limitar.
Configuración de procesamiento de cláusulas de escape: setEscapeProcessing()
public abstract void setEscapeProcessing(boolean habilitado) throws SQLException
Permite el procesamiento de
secuencias de escape según el valor true o false de habilitado.
Obtención del tiempo de finalización de sentencias: getQueryTimeout()
public abstract int getQueryTimeout() throws SQLException
Devuelve el tiempo máximo en
segundos que tiene una orden para completarse. Si se supera, se
lanza una excepción SQLException. El valor cero significa
ilimitado.
Obtención del tiempo de finalización de sentencias: setQueryTimeout ()
public abstract void setQueryTimeout(int seconds) throws SQLException
Configura el tiempo máximo en
segundos que tiene una orden para completarse. Si se supera, se
lanza una excepción SQLException. El valor cero significa
ilimitado.
Cancelación de sentencias: cancel()
public abstract void cancel() throws SQLException
Puede usarlo una hebra para cancelar
la orden que está ejecutando otra hebra.
Obtención de avisos: getWarnings()
public abstract SQLWarning getWarnings() throws SQLException
Obtiene el primer aviso para la orden
actual, o null si no hay ninguno. Los avisos se encadenan,
incluso durante el procesamiento del ResultSet
hasta que se crea una nueva sentencia.
Eliminación de avisos: clearWarnings()
public abstract void clearWarnings() throws SQLException
Borra los avisos encadenados hasta el
momento.
Nombrado de cursores: setCursorName()
public abstract void setCursorName(String nombreCursor) throws SQLException
Otorga un nombre de cursor a la fila
actual del ResultSet correspondiente a esta orden.
Ejecución de órdenes con resultados múltiples: execute()
public abstract boolean execute(String ordenSQL) throws SQLException
Ejecuta órdenes SQL que pueden
devolver múltiples resultados. Devuelve true si el primer
resultado es un ResultSet y false en caso de una cuenta de
actualización.
Obtención de resultados múltiples: getResultSet()
public abstract ResultSet getResultSet() throws SQLException
Obtiene el resultado de una sentencia
múltiple como un ResultSet.
Obtención de resultados múltiples: getUpdateCount()
public abstract int getUpdateCount() throws SQLException
Obtiene el resultado de una sentencia
múltiple como una cuenta de actualización.
Obtención de resultados múltiples: getMoreResults()
public abstract boolean getMoreResults() throws SQLException
Devuelve true si el siguiente resultado es un ResultSet o false si es una cuenta de actualización o no hay más resultados.