Commande wsdbgen
Cette commande permet d'utiliser la fonction pureQuery dans des applications JPA (Java™ Persistence API).
Cette commande a été renommée wsdbgen pour le module de fonctions Feature Pack for OSGi Applications and JPA 2.0 et les éditions ultérieures. Cette commande est utilisée de la même manière que la commande wsdb2gen. La commande, wsdb2gen, qui implique une utilisation uniquement sous DB2, fonctionne uniquement pour les bases de données DB2 dans WebSphere Application Server V7.0. Dans cette édition, la commande peut être utilisée pour les bases de données DB2, Informix et Oracle. Pour cette raison, un synonyme, la commande wsdbgen, est introduite.
Les commandes JPA (.bat sous Windows ou .sh sous UNIX) sont exécutées à partir du répertoire racine_profil/bin et non à partir du répertoire racine_serveur_app/bin. Ainsi, vous êtes sûr d'avoir la dernière version des commandes correspondant à votre édition.
Syntaxe
La syntaxe de la commande est la suivante :
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
wsdbgen.sh [paramètres]
![[IBM i]](../images/iseries.gif)
wsdbgen [paramètres]
![[Windows]](../images/windows.gif)
wsdbgen.bat [paramètres]
Avant d'exécuter la commande, le fichier persistence.xml doit se trouver dans le répertoire META-INF qui doit lui-même se trouver dans le chemin d'accès aux classes.
Paramètres
- -help : Ce paramètre affiche l'aide.
- -pu : Nom de l'unité de persistance définie dans le fichier persistence.xml.
- -collection : ID collection affecté aux noms des modules. La valeur par défaut est NULLID.
- -url : URL de la base de données cible.
L'URL est utilisée pour valider le langage SQL généré. Une URL doit être indiquée soit dans le fichier persistence.xml soit comme une option de commande. Si les deux sont indiqués, l'URL utilisée sera celle spécifiée dans l'option de commande.
- -user : ID utilisateur.
- -pw : Mot de passe de connexion à la base de données cible.
Si ce paramètre n'est pas indiqué, la valeur utilisée est celle indiquée dans le fichier persistence.xml.
- -package : si ce paramètre est indiqué, le paramètre -package prend le nom du module de valeur de chaîne et un module de base de données unique avec le nom spécifié est généré. Si le paramètre -package n'est pas indiqué, un module est alors généré pour chaque classe d'entité. Le nom d'entité est utilisé en tant que nom de package si l'option -package n'est pas spécifiée. La limite de longueur du nom est la limite du nom de la base de données moins 1, par exemple, 128 - 1 = 127.
Utilisation
Le fichier persistence.xml doit être inclus dans le fichier JAR (Java archive) et doit également être utilisé comme entrée dans la liaisonDB2 pour créer le package DB2. La commande nécessite une connexion à la base de données pour valider le code SQL généré. La base de données n'est pas nécessairement identique à celle de la phase d'exécution mais doit être de la même version et du même niveau d'édition.
- pdq.jar
- pdqmgmt.jar
- db2jcc.jar
- db2jcc_licence_cu.jar
Exemples
- DB2
wsdbgen.sh -pu payroll -collection prod1 -url jdbc:db2://myhostname:50000/proddb -user produser -pw secret
wsdbgen -pu payroll -collection prod1 -url jdbc:db2://myhostname:50000/proddb -user produser -pw secret
wsdbgen.bat -pu payroll -collection prod1 -url jdbc:db2:\\myhostname:50000\proddb -user produser -pw secret
- Informix
wsdbgen.sh -pu payroll -collection prod1 -url jdbc:ids://myhostname:9089/proddb -user produser -pw secret
wsdbgen -pu payroll -collection prod1 -url jdbc:ids://myhostname:9089/proddb -user produser -pw secret
wsdbgen.bat -pu payroll -collection prod1 -url jdbc:ids:\\myhostname:9089\proddb -user produser -pw secret