Java

1. Generalidades

Para cada clase cargada en la base de datos por loadjava, se crea un objeto y el nombre de dicho objeto hace referencia al nombre completo de la clase Java. En este objeto se almacena el código fuente, el código ejecutable y los diferentes recursos necesarios para la correcta ejecución de la clase. Loadjava también almacena los diferentes valores de las opciones en una tabla.

El programa Java puede crearse mediante una herramienta de desarrollo externa a la base de datos y, a continuación, loadjava permite cargar el archivo .class. Pero también es posible cargar el archivo fuente (.java) y luego compilar el código en la base de datos.

El nombre del objeto creado recibe el nombre completo de la clase Java, es decir, el nombre del paquete seguido del nombre de la clase. Estos nombres pueden tener una longitud máxima de 4000 caracteres en la base de datos. Sin embargo, Oracle solo admite identificadores con una longitud máxima de 30 caracteres para los objetos de la base de datos. Por tanto, es necesario implementar un método de resolución de nombres con el fin de poder manipular estos objetos desde PL/SQL.

2. Permisos de uso

Por omisión, los procedimientos almacenados Java utilizan los privilegios concedidos al usuario de Oracle que ejecuta el procedimiento. Este tipo de resolución de permisos permite personalizar los privilegios concedidos a cada usuario. Además, el código puede centralizarse en un determinado punto de la base de datos y utilizarse de distintas maneras.

Este problema se explica en el siguiente ejemplo:

En este ejemplo, los dos usuarios Pedro y Ana utilizan el mismo procedimiento almacenado Java (Análisis) que se aplica a la tabla Ventas. Dado que el procedimiento almacenado se ejecuta usando los permisos concedidos al usuario que lo ejecuta, accede a las tablas que el usuario posee. Por tanto, en este caso, el mismo código se comparte...

1. Correspondencia entre tipos de datos

La correspondencia entre los tipos de datos SQL y Java se rige por la siguiente tabla.

2. Creación de una función Java o de un procedimiento Java

Sintaxis

CREATE [OR REPLACE]  
{PROCEDURE nombre_procedimiento [(parámetro, ...)]  
| FUNCTION nombre_función [(parámetro, ...)] RETURN type_sql}  
[AUTHID {DEFINER|CURRENT_USER}]...

1. Llamada a un procedimiento Java desde SQL*Plus

La instrucción CALL

La instrucción CALL permite llamar desde el indicador de PL/SQL a un procedimiento almacenado Java que se haya publicado como función, procedimiento o elemento de un paquete.

Sintaxis

CALL [nombre_esquema.][nombre_paquete.]  
{nombre_procedimiento (parámetro,...)|nombre_función(parámetro,...)}
 

Los parámetros se definen en SQL*Plus y pueden ser valores literales o variables host.

Ejemplo

Uso de la función Cuenta para conocer el número de clientes presentes en la tabla:

SQL> variable numero number  
SQL> call cuenta('CLIENTES') into:numero;  
 
Llamada terminada.  
 
SQL> print numero  
 
    NUMERO  
----------  
        13  
 
SQL> 
 

Creación de la tabla TTEST y eliminación de la misma a continuación usando el procedimiento Java Borrar:

SQL> create table TTEST (col1 char(5));  
 
Tabla creada.  
 
SQL> call borrar('TABLE','TTEST');  
 
Llamada terminada.  
 
SQL> desc TTEST  
ERROR:  
ORA-04043: el objeto TTEST no existe  
 
 
SQL> 
 

Cómo redirigir la salida

Determinados procedimientos almacenados Java emplean el dispositivo estándar de error (System.err) o de salida (System.out) para mostrar determinados datos. Estos dispositivos se pueden redirigir a SQL*Plus utilizando los dos comandos siguientes:

SET SERVEROUTPUT ON [SIZE tamaño]  
CALL dbms_java.set_output(tamaño)
 

Con estos comandos, los datos se muestran una vez que el procedimiento se ha terminado de ejecutar. El parámetro tamaño, cuyo valor predeterminado es 2000 bytes, permite precisar el tamaño del búfer. Este tamaño no puede ser mayor de 1.000.000 bytes.

Ejemplo

Código fuente. El procedimiento...