Paramétrage pour appel de blocs PL/SQL

< view_type name =" PLSQL " document =" PLSQL ">

< retrieve >

< plsql_bloc key =" TEST " resolverClass =" fr.ACE.technicalframework.application.DefaultPLSQLBlockResolver " value =" begin insert into roa values (?); end; "/>

< plsql_bloc key =" OT " resolverClass =" fr.ACE.technicalframework.application.DefaultPLSQLBlockResolver " value =" begin gxp_ot.pro_rec_fast(); end; "/>

</ retrieve >

< sort />

</ view_type >

< document name =" PLSQL " class =" fr.ACE.technicalframework.application.document.PLSQLDocumentImpl "/>

La cinématique est du type :

retrieve(),assimilate()

L’action retrieve() provoque la résolution des inconnues, l’action assimilate() provoque l’exécution du bloc PL/SQL.

L’appel étant asynchrone, aucun résultat n’est attendu. Seule l'action assimilate() permet l'exécution. Un code retour éventuel est positionné dans le flux XML de présentation.

Les blocs PL/SQL définis dans la configuration ne doivent pas, sauf cas exceptionnel, gérer eux-mêmes les validations/annulations de la transaction courante. Le cas particulier de la définition de procédures stockées, capable de s'exécuter dans une autre transaction Oracle, ne vient pas perturber la transaction courante.

Néanmoins, il est fortement déconseillé de gérer une seconde transaction.

La syntaxe est la suivante :

begin toto(?,?,~); end;

On ne considère dans ce type de document les variables de type bindées (définies par des ?) en entrée, les remplacements littéraux étant inutiles pour des appels à des procédures stockées. Afin de permettre de retourner d'éventuels codes erreurs dans le flux de présentation, deux mécanismes peuvent être exploités :

• Soit un positionnant un paramètre de retour, signifié par le caractère "~" (il n'y a pas de limite quant au nombre de paramètres de retours de la procédure stockée),
• Soit en utilisant le package dbms_output au sein même de la procédure stockée

Le caractère "~" a été choisi arbitrairement car il n'est en général pas utilisé dans des blocs PL/SQL. Le mécanisme mis en place remplace (lors de l’exécution du retrieve()) tous les " ~" par des variables bindées nommées. En interne, le nom de ces variables bindées débute par " :returnValue" suivi d'un numéro d'indice correspondant à la position du paramètre dans le bloc PL/SQL.

On trouvera pour les codes retours un élément père (balise) de type <executed> directement sous le nom du document dans le flux de présentation. Sous cet élément, une liste de balise <outputParameter> donne les codes de retour. Chaque <outputParameter> est indicée via l'attribut 'index', ce numéro représentant l'indice du paramètre de code retour. La dernière annotation est allouée au buffer dbms_output avec un nœud de même nom. Le flux est de la forme suivante :

Exemple de flux suite à un appel qui s’est bien passé :

< executed >

< outputParameter index =" 1 "> retour de paramètre 1 </ outputParameter >

< outputParameter index =" 2 "> retour de paramèter 2 </ outputParameter >

< dbmsOutput > Exemple de retour dbms </ dbmsOutput >

</ executed >

Exemple de flux suite à un appel qui s’est mal passé :

< executed >

< outputParameter index =" 2 "> null </ outputParameter >

< outputParameter index =" 1 "> -1 </ outputParameter >

< dbmsOutput > Erreur ; ORA-00001: violation de contrainte unique (SOC3.EVE_IDX1) </ dbmsOutput >

</ executed >

A titre informatif, le code exécutant les blocs PL/SQL exploite un adaptateur. Cela permet éventuellement de disposer de plusieurs classes d'implémentations en fonction des versions d' Oracle, de BC4J ou de drivers JDBC exploités.

Exemples de blocs exécutables:

begin update pro set fampro=? where codsoc=? and fampro=?; end;

begin gxp_ot.pro_rec_complete(); end;

begin select to_char(sysdate,'yyyymmdd hh24mi') into ~ from dual; end;