Procedimientos almacenados

Los procedimientos almacenados sirven para definir procesos de actualización de datos e informes que se ejecutan en el servidor. Tienen las siguientes ventajas:

• Permiten aislar el interfaz de la aplicación de la complejidad del tratamiento de la base de datos.
• Evitan que la latencia de Internet afecte al rendimiento de la aplicación.

En BD4 se pueden definir dos tipos de procedimientos almacenados:

• Procedimientos nativos:
  Están escritos en lenguaje Java, forman parte del servidor BD4 y son compartidos por todas las bases de datos.
• Procedimientos de tipo script:
  Están escritos en el lenguaje BD4 script y son exclusivos de las bases de datos donde estén definidos.

Sentencias SQL para definir procedimientos

Crear un procedimiento:

    CREATE PROCEDURE nombre_procedimiento,?

Modificar un procedimiento:

    ALTER PROCEDURE nombre_procedimiento,?

Borrar un procedimiento:

    DROP PROCEDURE nombre_procedimiento

Obtener un procedimiento de tipo script:

    GET PROCEDURE nombre_procedimiento

En las sentencias CREATE y ALTER el texto del script del procedimiento se debe indicar como parámetro en una sentencia preparada. Téngase en cuenta que en las sentencias preparadas los parámetros se definen con el carácter '?'.

BD4 script

BD4 script es un lenguaje muy parecido a JavaScript que permite interactuar con Java. Al ser casi idéntico a JavaScript se puede usar cualquier editor que soporte este lenguaje.

Estas son algunas de las carácterísticas de BD4 script:

• Se pueden invocar funciones definidas en BD4 script desde Java, y también, a la inversa.
• En la clase que permite ejecutar scripts se puede definir qué objetos será posible crear y obtener.
• El operador '==' equivale a la función 'equals' de Java, por tanto, hay que usar '==' y '!=' en lugar de '===' y '!==', que no están permitidos.
• Todas las sentencias deben terminar con punto y coma.
• Las funciones sólo se pueden definir mediante sentencias en el programa principal, por lo que una función no se puede asignar a una variable.
• Sólo se pueden usar variables y constantes que se hayan declarado previamente.
• En las funciones se puede acceder a las variables y constantes definidas en el programa principal, y éstas son las únicas que se pueden redefinir dentro de las funciones.
• Una variable definida en un ámbito no se puede redefinir en otro ámbito anidado (bloque entre llaves).
• Las variables no inicializadas contendrán el valor 'null'. No existe el valor 'undefined'.
• Soporta por defecto variables de tipo entero (32 bits), cadena y booleano, y además todos los tipos que provengan de objetos Java.
• Los arrays y las tablas hash se usan mediante objetos de Java, y además se puede usar el operador corchete para acceder a sus elementos.
• Un script se podría considerar como una clase en la que su estado interno se guarda en las variables del programa principal y su interfaz está definido por las funciones.

Funciones especiales que se pueden definir en el script

En los scripts se pueden definir todas las funciones que sean necesarias, pero algunas funciones son "especiales".

Si el procedimiento debe devolver un resultado, el tipo se puede definir al principio del script sin incluirlo en ninguna función.

    var tipo = new SQLRowType();
    tipo.add("CODIGO", Types.CHAR);
    tipo.add("NOMBRE", Types.CHAR);
    setReturnRowType(tipo);

La función run se llamará cuando se ejecute el procedimiento almacenado.

    function run(param)
    {
        var it = param.iterator();

        var primerParametro  = it.next(),
            segundoParametro = it.next();

        assert(!it.hasNext());
        ...
    }

Si el procedimiento debe devolver un resultado, hay que definir la función 'next'. Esta función devolverá una fila del resultado o 'null' en caso de que no queden datos que devolver.

    function next()
    {
        var fila = newReturnRow();
        ...
        return fila;
    }

Finalmente, es necesario definir una función close que al finalizar la ejecución del procedimiento cierre las sentencias y las conexiones que haya realizado.

    function close()
    {
        ...
    }

Funciones que se pueden llamar en el script

En los scripts se pueden llamar a las funciones de los objetos y además a las siguientes funciones especiales:

• createStatement : crea una sentencia SQL
• prepareStatement : prepara una sentencia SQL
• commit : confirma una transacción
• rollback : deshace una transacción
• ...