![]() |
Gestión de Bases de datos en Internet: JDBC |
La interfaz ResultSet
Mediante esta
interfaz, se organizan en tablas los resultados de las órdenes
SQL. Las filas deben leerse una detrás de otra, pero las
columnas pueden leerse en cualquier orden.
Los métodos
Siguiente fila: next()
public abstract boolean next() throws SQLException
Pasa a la siguiente fila, o a la
primera cuando se ejecuta por primera vez. Devuelve true si se
consigue y false si no quedan filas.
Cierre del ResultSet: close()
public abstract void close() throws SQLException
Cierra inmediatamente el ResultSet, liberando los recursos utilizados.
Resultados nulos: wasNull()
public abstract boolean wasNull() throws SQLException
Se usa después de obtener un null
con un método getXXX() para comprobar que corresponde a un valor
NULL SQL.
Obtención de valores: getXXX()
public abstract tipoJava
getXXX(int indiceColumna) throws SQLException
public abstract tipoJava
getXXX(String nombreColumna) throws SQLException
Obtienen el valor contenido en la
columna como un tipoJava, o un null si se trataba de un valor NULL de
SQL.
Método getXXX() | tipo Java |
getString | String |
getBoolean | boolean |
getByte | byte |
getShort | short |
getInt | int |
getLong | long |
getFloat | float |
getDouble | double |
getBigDecimal* | BigDecimal |
getBytes | byte[] |
getDate | Date |
getTime | Time |
getTimestamp | Timestamp |
getAsciiStream** | InputStream |
getUnicodeStream** | InputStream |
getBinaryStream** | InputStream |
** Traducen el valor a cadenas de caracteres
ASCII, Unicode o bytes. Estas corrientes deben leerse completas
antes de continuar con ninguna otra columna, ya que esto
provocaría el cierre automático de la corriente.
public abstract BigDecimal
getBigDecimal (columna,
int precision) throws SQLException
Donde precision indica el número de cifras decimales.
Lectura de avisos: getWarnings()
public abstract SQLWarning getWarnings() throws SQLException
Obtiene el primer aviso de la cadena
de avisos SQL producidos durante el trabajo con este ResultSet o
null si no hay ninguno. La cadena de avisos se renueva con cada
fila.
Borrado de avisos: clearWarnings()
public abstract void clearWarnings() throws SQLException
Borra todos los avisos de la cadena.
Obtención del nombre del cursor: getCursorName()
public abstract String getCursorName() throws SQLException
Obtiene el nombre del cursor asignado
a este ResultSet.
Propiedades del ResultSet: getMetaData()
public abstract ResultSetMetaData getMetaData() throws SQLException
Obtiene en un objeto ResultSetMetaData información sobre el número de columnas y su
estructura.
Obtención de Objetos: getObject()
public abstract Object
getObject(int indiceColumna) throws SQLException
public abstract Object
getObject(int nombreColumna) throws SQLException
Obtiene el valor contenido en la
columna como un objeto Java cuyo tipo sigue la traducción
estándar JDBC de tipos SQL a tipos Java. Este método es válido
para tipos específicos de la base de datos.
Indices de las columnas: findColumn()
public abstract int findColumn(String nombreColumna) throws SQLException
Obtiene el índice de una columna conocido su nombre.