jme.script.sql

Interface AbstractSql

public interface AbstractSql

Interfaz para la representación abstracta de una conexión a SGBDR mediante SQL

Since:

0.6.2.0, JMEScript 0.2.0

Author:

Miguel Alejandro Moreno Barrientos, (C)2020-2021

Method Summary

Modifier and Type	Method and Description
void	cerrar(java.lang.Object idConexion) Cerrar la conexión
void	conectar(java.lang.Object idConexion, java.lang.String host, java.lang.String usuario, java.lang.String password) Conectar a la BBDD
boolean	ejecutar(java.lang.Object idConexion, java.lang.Object idSentencia, java.lang.String sql) Ejecuta una sentencia SQL
java.lang.Object	getData(java.lang.Object idConexion, java.lang.Object idSentencia, java.lang.String nombreCol) Devuelve el siguiente registro (fila) del resultado de la sentencia, o el conteo de actualizaciones para una sola columna de la tabla o para todas '*'
java.lang.Object	getData(java.lang.Object idConexion, java.lang.Object idSentencia, java.lang.String[] arrayCol) Devuelve el siguiente registro (fila) del resultado de la sentencia, o el conteo de actualizaciones para las columnas seleccionadas

Method Detail

conectar

void conectar(java.lang.Object idConexion,
              java.lang.String host,
              java.lang.String usuario,
              java.lang.String password)
       throws java.lang.Throwable

Conectar a la BBDD

Parameters:

idConexion - identificador de conexión, para diferenciarla de múltiples conexiones

host - host de la BBDD

usuario - nombre de usuario de la BBDD

password - contraseña de la BBDD

Throws:

java.lang.Throwable - error en la conexión

cerrar

void cerrar(java.lang.Object idConexion)
     throws java.lang.Throwable

Cerrar la conexión

Parameters:

idConexion - identificador de conexión

Throws:

java.lang.Throwable - error al cerrar la conexión

ejecutar

boolean ejecutar(java.lang.Object idConexion,
                 java.lang.Object idSentencia,
                 java.lang.String sql)
          throws java.lang.Throwable

Ejecuta una sentencia SQL

Parameters:

idConexion - identificador de conexión

idSentencia - identificador de la sentencia, para poder acceder a sus resultados particulares

sql - sentencia SQL del SGBDR utilizado

Returns:

true si el valor devuelto es un conjunto de resultados o false si no hay resultados o es conteo de actualizaciones

Throws:

java.lang.Throwable - error en la sentencia

getData

java.lang.Object getData(java.lang.Object idConexion,
                         java.lang.Object idSentencia,
                         java.lang.String nombreCol)
                  throws java.lang.Throwable

Devuelve el siguiente registro (fila) del resultado de la sentencia, o el conteo de actualizaciones para una sola columna de la tabla o para todas '*'

Parameters:

idConexion - identificador de conexión

idSentencia - identificador de sentencia

nombreCol - nombre de la columna de la que se quiere obtener información

Returns:

registro o conteo de actualizaciones (int) o null si no hay más registros

Throws:

java.lang.Throwable - no se pueden obtener más resultados o la sentencia está terminada

See Also:

getData(Object, Object, String[])

getData

java.lang.Object getData(java.lang.Object idConexion,
                         java.lang.Object idSentencia,
                         java.lang.String[] arrayCol)
                  throws java.lang.Throwable

Devuelve el siguiente registro (fila) del resultado de la sentencia, o el conteo de actualizaciones para las columnas seleccionadas

Parameters:

idConexion - identificador de conexión

idSentencia - identificador de sentencia

arrayCol - nombres de las columnas de las que se quiere obtener información

Returns:

registro o conteo de actualizaciones

Throws:

java.lang.Throwable - no se pueden obtener más resultados o la sentencia está terminada

See Also:

getData(Object, Object, String)