Apache Torque est une boîte à outils de persistance pour les applications Java qui utilisent des bases de données relationnelles. Torque est un projet en code source ouvert issu de l'environnement d'applications web Jakarta Apache Turbine, mais il en est désormais totalement indépendant. Torque supporte la plupart des bases de données en code source ouvert et commerciales populaires via JDBC, notamment Oracle, Microsoft SQL Server, IBM DB/2, MySQL et PostgreSQL.
Vous pouvez utiliser Torque pour générer le code Java de votre couche d'accès aux données. Vous pouvez aussi y avoir recours pour "désosser" les objets Java à partir de votre schéma de base de données existant si vous possédez déjà une couche d'objets d'accès aux données (DAO). Pour de nouveaux projets, si vous modélisez vos objets métier en XML, Torque génèrera des scripts SQL pour créer vos tables de base de données, ainsi que des objets Java pour lire, écrire et trouver des données.
Les développeurs J2EE disposent d'un certain nombre d'options remarquables pour établir une couche de persistance gérée (consultez cet encadré pour connaître les diverses alternatives). Nous étudierons ici ce que Torque a à offrir et la manière de le mettre en application.
Vous pouvez télécharger l'exemple de code utilisé dans cet article.
Utiliser Torque pour générer votre couche d'accès aux données et vos objets de valeur
Torque possède deux composants majeurs : un composant de génération et un composant d'exécution. Vous pouvez utiliser Torque pour générer des objets de valeur, des scripts de création de tables SQL et la couche d'accès aux données. Apache Ant ou Apache Maven peuvent l'un et l'autre exécuter le générateur Torque. Pour cet article, j'utiliserai Ant.
Torque facilite la maintenance du code, car vos objets de valeur, vos objets d'accès aux données et votre code SQL sont générés à partir d'un même fichier XML, qu'on appelle schéma. Nommez ce fichier nomduprojet-schema.xml et placez-le dans le sous-répertoire schema de l'installation Torque. Ce fichier XML contient une description de chacun de vos objets de valeur, notamment les noms, les attributs et les relations avec les autres objets. Le fichier de schéma XML que nous avons utilisé pour cet exemple est appelé builder-schema.xml dans l'exemple de code que vous pouvez télécharger pour cet article. Notez que nous avons créé une référence de clé étrangère de la table Product vers la table Vendor. En effet, la relation est telle qu'un fournisseur (vendor) peut avoir plusieurs produits, mais que chaque produit n'a qu'un fournisseur.
L'autre fichier de configuration important est build.properties, situé à la racine de l'installation Torque. Vous devez modifier ce fichier pour y inclure le nom de votre projet, le logiciel de base de données utilisé, les informations de connexion JDBC requises et le package dans lequel seront placés les fichiers de classe générés. Ce fichier fait également partie de notre exemple de code à télécharger.
Créez la base de données avec votre outil d'administration de base de données et assurez-vous que vous possédez la version 1.5 ou supérieure d'Apache Ant. Ajoutez le fichier JAR pour vos pilotes JDBC dans le sous-répertoire lib de l'installation Torque. Ensuite, exécutez la commande suivante à partir du répertoire Torque:
ant –f build-torque.xml
Torque doit générer tous vos fichiers de classe dans un répertoire src/java sous l'installation principale Torque. Les scripts SQL doivent résider dans src/sql.