Pour exécuter le code pureQuery avec SQL statique, vous devez attribuer
la valeur "STATIC" à la propriété executionMode.
Avant de commencer
Le module contenant les instructions SQL statiques doit être lié à la base de données
que l'application utilise. Si vous attribuez la valeur "STATIC" à la propriété
executionMode mais que le module n'est pas lié, pureQuery émet une exception. pureQuery
ne retourne pas à une instruction SQL dynamique.
Procédure
Pour attribuer la valeur "STATIC" au mode d'exécution, procédez de l'une des
façons suivantes :
- Transmettez un objet de propriétés à DataFactory lors de l'implémentation
d'une interface, en spécifiant
executionMode="STATIC" comme l'une des propriétés (voir l'exemple
ci-après).
con = DriverManager.getConnection...;
java.util.Properties myPdqProperties = new java.util.Properties();
myPdqProperties.put("pdq.executionMode", "STATIC");
BasicAnnotatedMethodInterface bami =
DataFactory.getData(BasicAnnotatedMethodInterface.class, con,
myPdqProperties);
- Attribuez une valeur à une propriété système JVM lors de l'appel du JRE (voir l'exemple ci-après).
java -Dpdq.executionMode="STATIC" myjavapkg.myPDQapp
- 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 placez le fichier dans un autre emplacement,
utilisez la propriété système configFile pour pointer vers le fichier lors de l'exécution
de votre application, comme suit :
-Dpdq.configFile=nom-chemin-et-fichier ou nom-ressource package-Java.application
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.