Interfaz ResultSet

La interfaz ResultSet proporciona acceso a una tabla de datos. Un objeto ResultSet normalmente se genera ejecutando una Sentencia.

Un objeto ResultSet mantiene un cursor apuntando hacia su fila de datos actual. Inicialmente, el cursor está colocado delante de la primera fila. El método next() mueve el cursor a la fila siguiente.

Los métodos getXXX recuperan valores de columna para la fila actual. Puede recuperar valores utilizando el número de índice de la columna o el nombre de la columna. En general, la utilización del índice de columnas es más eficaz. Las columnas se numeran a partir de uno.

java.sql, paquete

public interface ResultSet

La Tabla 102 lista los campos de la interfaz ResultSet a los que da soporte DB2 Everyplace.

Tabla 102. Campos de la interfaz ResultSet

Tipo de campo Campo
static int CONCUR_READ_ONLY La constante que indica la modalidad de simultaneidad para un objeto ResultSet que es posible que NO pueda actualizarse. Nota: DB2 Everyplace no da soporte a CONCUR_UPDATABLE. Si se especifica CONCUR_UPDATABLE para la modalidad de simultaneidad para un objeto ResultSet al crear un objeto Statement, el controlador de JDBC de DB2 Everyplace emite un SQLWarning en el objeto Connection que ha producido el objeto Statement y en su lugar utiliza CONCUR_READ_ONLY.
static int TYPE_FORWARD_ONLY La constante que indica el tipo para un objeto ResultSet cuyo cursor sólo pueda moverse hacia adelante.
static int TYPE_SCROLL_INSENSITIVE La constante que indica el tipo para un objeto ResultSet que pueda desplazarse pero que en general no resulte sensible a los cambios efectuados por otros. Nota: Utilice este tipo de objeto ResultSet con moderación, puesto que puede afectar al rendimiento. Este tipo utiliza SQL_INSENSITIVE como valor del atributo de sentencia CLI SQL_ATTR_CURSOR_SENSITIVITY. Consulte la documentación para la función de CLI SQLSetStmtAttr para obtener más detalles.
static int TYPE_SCROLL_SENSITIVE La constante que indica el tipo para un objeto ResultSet que pueda desplazarse y que en general resulte sensible a los cambios efectuados por otros. Nota: Este tipo utiliza SQL_UNSPECIFIED para el valor del atributo de sentencia de CLI SQL_ATTR_CURSOR_SENSITIVITY. Consulte la documentación para la función de CLI SQLSetStmtAttr para obtener más detalles.

La Tabla 103 lista los métodos de la interfaz ResultSet a los que da soporte DB2 Everyplace.

Tabla 103. Métodos de la interfaz ResultSet

Tipo de valor de retorno del método Método
boolean absolute(int fila) JDBC 2.0. Mueve el cursor al número de fila indicado del conjunto resultante.
void afterLast() JDBC 2.0. Mueve el cursor al final del conjunto resultante, justo detrás de la última fila.
void beforeFirst() JDBC 2.0. Mueve el cursor al principio del conjunto resultante, justo delante de la primera fila.
void clearWarnings() Borra todos los avisos de los que se ha informado para este objeto ResultSet.
void close() Libera de inmediato los recursos de JDBC y base de datos de este objeto ResultSet en lugar de esperar a que suceda esto cuando se cierre automáticamente.
int findColumn(String columnName) Correlaciona el nombre de columna de ResultSet indicado con su índice de columnas de ResultSet.
boolean first() JDBC 2.0. Mueve el cursor a la primera fila del conjunto resultante.
BigDecimal getBigDecimal(int índiceColumnas) JDBC 2.0. Obtiene el valor de una columna de la fila actual como objeto java.math.BigDecimal con precisión completa. El controlador JDBC de DB2 Everyplace para Palm OS no soporta este método.
BigDecimal getBigDecimal(int índiceColumnas, int escala) Obtiene el valor de la columna designada de la fila actual de este objeto ResultSet como objeto java.math.BigDecimal en el lenguaje de programación Java. El controlador JDBC de DB2 Everyplace para Palm OS no soporta este método.Desaprobado.
BigDecimal getBigDecimal(String nombreColumna) JDBC 2.0. Obtiene el valor de una columna de la fila actual como objeto java.math.BigDecimal con precisión completa. El controlador JDBC de DB2 Everyplace para Palm OS no soporta este método.
BigDecimal getBigDecimal(String columnName, int escala) obtiene el valor de la columna designada de la fila actual de este objeto ResultSet como objeto java.math.BigDecimal en el lenguaje de programación Java. El controlador JDBC de DB2 Everyplace para Palm OS no soporta este método.Desaprobado.
Blob getBlob(int índiceColumnas) JDBC 2.0. Obtiene un valor de BLOB de la fila actual de este objeto ResultSet.
Blob getBlob(String nombreColumna) JDBC 2.0. Obtiene un valor de BLOB de la fila actual de este objeto ResultSet.
boolean getBoolean(int columnIndex) Obtiene el valor de una columna de la fila actual como boolean de Java.
boolean getBoolean(String columnName) Obtiene el valor de una columna de la fila actual como boolean de Java.
byte getByte(int índiceColumnas) Obtiene el valor de la columna designada en la fila actual de este objeto ResultSet como byte en el lenguaje de programación Java.
byte getByte(String nombreColumna) Obtiene el valor de la columna designada en la fila actual de este objeto ResultSet como byte en el lenguaje de programación Java.
byte[] getByte(int índiceColumnas) Obtiene el valor de la columna designada en la fila actual de este objeto ResultSet como matriz de bytes en el lenguaje de programación Java.
byte[] getBytes(String nombreColumna) Obtiene el valor de la columna designada en la fila actual de este objeto ResultSet como matriz de bytes en el lenguaje de programación Java.
int getConcurrency() JDBC 2.0. Devuelve la modalidad de simultaneidad del conjunto resultante.
Date getDate(int índiceColumnas) Obtiene el valor de la columna designada en la fila actual de este objeto ResultSet como objeto java.sql.Date en el lenguaje de programación Java.
Date getDate(int índiceColumnas, Calendar cal) Devuelve el valor de la columna designada en la fila actual de este objeto ResultSet como objeto java.sql.Date en el lenguaje de programación Java.
Date getDate(String nombreColumna) Devuelve el valor de la columna designada en la fila actual de este objeto ResultSet como objeto java.sql.Date en el lenguaje de programación Java.
double getDouble(int columnIndex) Obtiene el valor de una columna de la fila actual como double de Java.
double getDouble(String columnName) Obtiene el valor de una columna de la fila actual como double de Java.
float getFloat(int columnIndex) Obtiene el valor de una columna de la fila actual como float de Java.
float getFloat(String columnName) Obtiene el valor de una columna de la fila actual como float de Java.
int getInt(int índiceColumnas) Devuelve el valor de la columna designada en la fila actual de este objeto ResultSet como entero en el lenguaje de programación Java.
int getInt(String nombreColumna) Devuelve el valor de la columna designada en la fila actual de este objeto ResultSet como entero en el lenguaje de programación Java.
long getLong(int columnIndex) Obtiene el valor de una columna de la fila actual como long de Java.
long getLong(String columnName) Obtiene el valor de una columna de la fila actual como long de Java.
ResultSetMetaData getMetaData() Recupera el número, los tipos y las propiedades de las columnas de este objeto ResultSet.
Object getObject(int índiceColumnas) Obtiene el valor de una columna de la fila actual como objeto Java.
Object getObject(String nombreColumna) Obtiene el valor de una columna de la fila actual como objeto Java.
int getRow() JDBC 2.0. Recupera el número de la fila actual.
short getShort(int índiceColumnas) Obtiene el valor de la columna designada en la fila actual de este objeto ResultSet como short en el lenguaje de programación Java.
short getShort(String nombreColumna) Obtiene el valor de la columna designada en la fila actual de este objeto ResultSet como short en el lenguaje de programación Java.
Statement getStatement() JDBC 2.0. Devuelve la sentencia (Statement) que ha producido este objeto ResultSet.
String getString(int índiceColumnas) Obtiene el valor de la columna designada en la fila actual de este objeto ResultSet como String en el lenguaje de programación Java.
String getString(String nombreColumna) Obtiene el valor de la columna designada en la fila actual de este objeto ResultSet como String en el lenguaje de programación Java.
Time getTime(int índiceColumnas) Obtiene el valor de la columna designada en la fila actual de este objeto ResultSet como objeto java.sql.Time en el lenguaje de programación Java.
Time getTime(String nombreColumna) Obtiene el valor de la columna designada en la fila actual de este objeto ResultSet como objeto java.sql.Time en el lenguaje de programación Java.
Timestamp getTimestamp(String nombreColumna) Obtiene el valor de la columna designada en la fila actual de este objeto ResultSet como objeto java.sql.Timestamp en el lenguaje de programación Java.
Timestamp getTimestamp(int índiceColumnas) Obtiene el valor de la columna designada en la fila actual de este objeto ResultSet como objeto java.sql.Timestamp en el lenguaje de programación Java.
int getType() JDBC 2.0. Devuelve el tipo de este conjunto resultante.
SQLWarning getWarnings() Devuelve el primer aviso informado por llamadas a este ResultSet.
boolean isAfterLast() JDBC 2.0. Indica si el cursor se encuentra detrás de la última fila del conjunto resultante.
boolean isBeforeFirst() JDBC 2.0. Indica si el cursor se encuentra delante de la primera fila del conjunto resultante.
boolean isFirst() JDBC 2.0. Indica si el cursor se encuentra en la primera fila del conjunto resultante.
boolean isLast() JDBC 2.0. Indica si el cursor se encuentra en la última fila del conjunto resultante. No se soporta este método para conjuntos resultantes de tipo TYPE_FORWARD_ONLY.
boolean last() JDBC 2.0. Mueve el cursor a la última fila del conjunto resultante.
boolean next() Mueve el cursor una fila hacia abajo a partir de su posición actual.
boolean previous() JDBC 2.0. Mueve el cursor a la fila anterior del conjunto resultante.
boolean relative(int filas) JDBC 2.0. Mueve el cursor un número relativo de filas, ya sea positivo o negativo.
boolean wasNull() Informa sobre si la última columna leída tenía un valor NULL de SQL.

Tareas relacionadas

Consulta relacionada