Une fois les accès définis pour les instructions SQL dans les modules d'une base de données DB2, vous pouvez appliquer votre code de façon qu'il exécute les
instructions SQL en mode statique.
Avant de commencer
- Votre projet doit être associé à une base de données DB2 prise en charge.
- Le fichier pdqmgmt.jar doit se trouver dans le chemin de génération de votre projet Java.
Procédure
Pour exécuter un code pureQuery utilisant des instructions SQL statiques, effectuez l'une des trois opérations suivantes :
- Modifiez votre application de telle sorte qu'elle utilise un objet Properties paramétrant la propriété executionMode sur STATIC. Votre code doit transmettre cet objet à la méthode DataFactory.getData() lorsqu'il crée une instance de l'implémentation de l'interface.
Exemple :
java.util.Properties myPdqProperties = new java.util.Properties();
myPdqProperties.put("pdq.executionMode", "STATIC");
data = DataFactory.getData (nom_interface, "URL_jdbc_base_de_données",
"ID_utilisateur", args[0], myPdqProperties);
- Paramétrez le mode d'exécution de l'application sur STATIC via une propriété système JVM.
- Cliquez avec le bouton droit de la souris sur l'implémentation de votre interface et sélectionnez Exécuter en tant que > Exécuter.
- Dans le fenêtre Exécuter, sélectionnez l'onglet Arguments.
- Dans la zone Arguments VM, entrez -Dpdq.executionMode="STATIC"
- Cliquez sur Exécuter. La sortie apparaît dans la vue Console.
- Paramétrez le mode d'exécution de votre application sur STATIC via un fichier
nommé pdq.properties. Vous pouvez placer ce fichier soit sur le système de fichiers, soit dans le
chemin d'accès aux classes de votre application.
Voici un exemple de fichier de propriétés. Les propriétés sont définies sous forme
de paires de clés et de valeurs. Le symbole dièse (#) placé au début d'une ligne
indique qu'il s'agit d'une ligne de commentaire.
# Définition du mode d'exécution.
pdq.executionMode="STATIC"
Par défaut, pureQuery s'attend à ce que le fichier porte le nom de pdq.properties
et qu'il se trouve dans le chemin d'accès aux classes de votre application.
Si vous utilisez un nom de fichier différent et/ou si vous placez le fichier en
un point différent, suivez les étapes ci-après lorsque vous exécutez
l'application :
-Dpdq.configFile=chemin_et_nom_fichier ou nom_ressource
- Cliquez avec le bouton droit de la souris sur l'implémentation de votre interface et sélectionnez Exécuter en tant que > Exécuter.
- Dans le fenêtre Exécuter, sélectionnez l'onglet Arguments.
- Dans la zone Arguments VM, entrez -Dpdq.config.file=nom_fichier
- Cliquez sur Exécuter. La sortie apparaît dans la vue Console.
Si
vous développez une application Web, placez le fichier pdq.properties dans le dossier
WEB-INF/classes de votre application ou dans un fichier JAR du dossier WEB-INF/lib.
Si vous développez une application
autonome, placez le fichier pdq.properties dans n'importe quel dossier ou fichier JAR se trouvant dans le chemin d'accès aux classes pour l'application.