|
Gestión de Bases de datos en Internet: JDBC |
La interfaz PreparedStatement
Los objetos PreparedStatement contienen órdenes SQL precompiladas que pueden por tanto ejecutarse muchas veces.
Los métodos
Ejecución de órdenes: executeQuery()
public abstract ResultSet executeQuery() throws SQLException
Devuelve la tabla resultado de
ejecutar la orden precompilada. No devuelve nunca un valor null.
Ejecución de órdenes de actualización: executeUpdate()
public abstract int executeUpdate() throws SQLException
Devuelve el número de filas
afectadas por órdenes del tipo INSERT, UPDATE, DELETE, o
sentencias de definición de datos.
Parámetros nulos: setNull()
public abstract void setNull(int indiceParametro, int tipoSQL) throws SQLException
Asigna un valor nulo a un parámetro.
No puede omitirse el tipo SQL.
Asignación de valores a los parámetros: setXXX()
public abstract void setXXX(int indiceParametro, tipoJava valor) throws SQLException
Asigna el valor valor del tipo Java tipoJava al parámetro de índice indiceParametro, que es transformado por el controlador JDBC
en un tipo SQL correspondiente para pasarlo a la base de datos.
| Método setXXX() | Tipo Java | Tipo SQL |
| setBoolean | boolean | BIT |
| setByte | byte | TINYINT |
| setShort | short | SMALLINT |
| setInt | int | INTEGER |
| setLong | long | BIGINT |
| setFloat | float | FLOAT |
| setDouble | double | DOUBLE |
| setBigInt | BigInt | NUMERIC |
| setString | String | VARCHAR o LONGVARCHAR |
| setBytes | Array de bytes | VARBINARY o LONGVARBINARY |
| setDate | Date | DATE |
| setTime | Time | TIME |
| setTimestamp | Timestamp | TIMESTAMP |
| setAsciiStream* | InputStream | LONGVARCHAR |
| setUnicodeStream* | InputStream | LONGVARCHAR |
| setByteStream* | InputStream | LONGVARBINARY |
* public abstract
void setXXX(int indiceParametro,inputStream
corriente
, int longitud) throws SQLException
Se usan para valores muy grandes ASCII,
UNICODE o binarios.
Borrado de parámetros: clearParameters()
public abstract void clearParameters() throws SQLException
Borra todos los parámetros.
Asignación de objetos: setObject()
void setObject(int indiceParametro,
Object objeto [, int tipoSQL][, int decimales])
throws SQLException
Asigna un objeto a un parámetro para
ser convertido al tipo SQL especificado. Si el tipo SQL no se
especifica, se emplean las tablas de conversión del estándar
JDBC para entregarlo a la base de datos como el tipo adecuado.
Ordenes con múltiples resultados: execute()
public abstract boolean execute() throws SQLException
Se emplea para enviar órdenes que pueden devolver múltiples resultados.
Nota: El índice de los parámetros comienza en 1.