Développer des procédures stockées en Java

Pour créer une procédure stockée Java ou SQLJ, vous avez besoin des fichiers suivants :

Le fichier source Java qui définit le comportement de la procédure stockée. Il doit avoir une extension de fichier .java ou .sqlj.
Le fichier DDL qui crée la procédure stockée Java à l'aide d'une instruction CREATE PROCEDURE . Vous pouvez créer et déployer en utilisant Db2 Developer Extension. Ce fichier doit porter l'extension .sqsql ou .javaspsql.

Travailler avec Eclipse Outils Java

Créez un projet Java Eclipse pour héberger votre source de développement. Eclipse fournit la perspective Java pour le développement de projets Java.
1. Pour ouvrir cette perspective, cliquez sur Fenêtre > Perspective > Ouvrir une perspective, puis sélectionnez Java dans la liste des perspectives disponibles.
2. Dans l' explorateur de paquets, cliquez avec le bouton droit de la souris et sélectionnez Nouveau > Projet Java.
3. Vous pouvez créer un dossier séparé pour héberger toutes les dépendances JAR de votre procédure.
4. Pour configurer le chemin de construction Java afin d'inclure toutes les bibliothèques JAR dont dépendent vos procédures stockées Java, cliquez avec le bouton droit de la souris sur le projet et sélectionnez Chemin de construction > Configurer le chemin de construction.
5. Vous pouvez créer un dossier distinct pour héberger les fichiers .sql, .spsql ou .javaspsql qui contiennent les instructions CREATE PROCEDURE utilisées pour déployer la procédure stockée Java.
6. La capture d'écran suivante montre un exemple de projet Java contenant deux procédures stockées :
7. Si vous décidez de réutiliser les projets de développement de données IBM Data Studio que vous pourriez avoir dans un espace de travail Developer for z/OS® 15.0.x, vous pouvez les importer dans la vue Java Explorer. Les projets de développement de données sont des projets Java.
8. Si vous souhaitez que l'outil de développementDb2® for z/OS se trouve dans la même perspective que vos projets Java, vous pouvez ajouter la vue Projetsz/OS et la vue Systèmes distants à la perspective Java:
  1. Ouvrez la perspective Java.
  2. Dans la barre de menus, sélectionnez Fenêtre > Afficher la vue > Autre.
  3. Dans la fenêtre Afficher la vue, développez Systèmes distants, puis sélectionnez Systèmes distants et cliquez sur Ouvrir.
  4. Dans la barre de menus, sélectionnez Fenêtre > Afficher la vue > Autre.
  5. Dans la fenêtre Show View, développez z/Os Project Views, puis sélectionnez z/Os Projects et cliquez sur Open.
Pour plus d'informations sur le développement de projets Java, voir le guide de l'utilisateur du développement Java.

Travailler avec des fichiers Java

Si la classe Java déclare un chemin d'accès au paquetage, son emplacement doit correspondre au chemin d'accès au paquetage pour que la compilation se fasse correctement.
Une procédure stockée Java doit comporter la méthode public static void, qui sert de point d'entrée à la procédure stockée.

Travailler avec des fichiers.javasql :

La clause EXTERNAL NAME doit contenir un external-java-routine-name valide, spécifié dans le format suivant :

jar-name:package-id...class-id.method-id(method-signature)

Le site package-id doit correspondre à la déclaration de paquetage dans le code source Java. Le site class-id doit correspondre au nom de la classe Java. Le site method-id doit correspondre au nom de la méthode Java. Le site method-signature est facultatif.

Le nom de la classe, le paquetage déclaré et le nom de la méthode doivent correspondre au nom externe défini dans la déclaration CREATE PROCEDURE
La prise en charge des procédures stockées Java dans l'éditeur SQL comprend deux modèles : createProcedureJavaInOut et createProcedureJavaResultSet. Pour voir les modèles SQL, ouvrez la fenêtre Préférences et accédez à Solutions z/OS > Db2 for z/OS > Modèles Db2.

Pour plus d'informations, voir l' instruction CREATE PROCEDURE (procédure externe) dans la documentation Db2 for z/OS.

Exemple de procédure stockée en Java


CREATE PROCEDURE USERIBM.JDBC_JSP()
    LANGUAGE JAVA
    EXTERNAL NAME 'USERIBM.JDBC_JSP:JdbcJavaSP.getEmp(java.sql.ResultSet[])'
    PARAMETER STYLE JAVA
    WLM ENVIRONMENT WLMJAVA
    READS SQL DATA
    DYNAMIC RESULT SETS 1