TP1 - ORM

L'objectif de ce TP est de ce familiariser avec les technologies de mapping objet-relationnel au travers de l'API JPA de Java. Pour cela il est demandé de compléter le code de l'application fournie afin de la rendre fonctionnelle.

Le TP peut être réalisé seul ou en binôme.

<note>Les instructions pour ce TP ont été testées sous Linux et MacOSX. Le TP doit fonctionner à priori sans problème sous Windows, mais cela n'a pas été testé.</note>

<note warning>Problèmes de quota disque liés à maven: changer la configuration comme indiqué ici</note>

<note warning>Problèmes d'entrées/sortie sur H2: changer l'url H2 en jdbc:h2:tcp://localhost//tmp/gdw-db dans l'interface de connexion à H2 et dans le fichier src/main/resources/META-INF/persistence.xml1)</note>

<note important>Ce TP n'est pas à rendre, mais un contrôle portant sur le TP est prévu le jeudi 5 octobre après-midi en alternance avec le TD de Bases de l'IA.</note>

Mise en route

Créer un projet sur la forge et partagez le avec votre binôme. Cloner votre projet (on supposera que l'identifiant du projet est pxxxx/gdw-tp1):

git clone https://forge.univ-lyon1.fr/pxxxx/gdw-tp1.git

Tirer ensuite le contenu de l'application depuis le dépôt de l'énoncé, puis pousser le tout vers votre dépôt sur la forge.

cd gdw-tp1
git pull https://forge.univ-lyon1.fr/EMMANUEL.COQUERY/inf1090m-2016-tp1.git
git push

Charger le projet dans votre IDE favori.

Mise en place de la base de données

La base de données relationnelle utilisée dans ce TP est H2. Télécharger la base de données, puis lancer la console:

cd ..../h2/bin
./h2.sh -web -webAllowOthers -tcp -tcpAllowOthers -browser

Vérifier les paramètres dans la page web qui s'ouvre (enregistrer la connexion pour plus tard au cas où):

  • Pilote JDBC: org.h2.Driver
  • URL JDBC: jdbc:h2:tcp://localhost/~/gdw-db (ou jdbc:h2:tcp://localhost//tmp/gdw-db sur les machines de TP Linux à cause des problèmes liés au montage réseau)
  • Nom d'utilisateur: vide
  • Mot de passe: vide

Utiliser le script SQL src/main/resources/microblog.sql pour générer les tables de la base de données.

Laisser la base de données démarrée.

Vérifier la connexion entre Java et la base H2 en lançant le test unitaire JPATest.

Tour d'horizon de l'application "microblog"

Pour lancer l'application, deux possibilités:

  • exécuter la classe mif04.gdw.tp1.App depuis l'IDE
  • lancer la commance mvn exec:java depuis la racine du projet

L'application lance une interface dans un navigateur. Cette interface n'est pour le moment pas réellement fonctionnelle, c'est à vous de prendre la main pour la compléter.

Le code comporte 3 packages d'intérêt:

  • modele contient les classes que l'on fera correspondre à des tables de la base de données (à annoter avec JPA)
  • dao contient le code des classes faisant l'interface entre le support de persistance (i.e. JPA) et le code métier
  • metier contient une seule classe, Blog qui contient du code métier utilisé par l'interface. Les transactions sont gérées dans cette classe et ne doivent pas être gérées au niveau des DAOs.

Par ailleurs, le package itf contient le code qui gère l'interface Web. Il n'est à priori pas nécessaire de comprendre en profondeur ce code.

Travail demandé

  1. Comprendre le schéma relationnel en particulier les clés utilisées
  2. Annoter les classes du package modele avec JPA, en procédant par exemple comme suit:
    • Compléter et annoter la classe User
    • Compléter et annoter la classe Categorie sauf ce qui concerne la collection des billets. Attention à la gestion de la clé primaire.
    • Compléter et annoter la classe Billet en faisant attention aux clés primaires et étrangères définies sur la table BILLET
    • Terminer de compléter et d'annoter la classe Categorie
  3. Compléter le code des classes DAO. S'il est nécessaire de créer des requêtes dans le langage JPA (JPQL), ces requêtes pourront être définies dans les classes entités correspondantes via l'annotation @NamedQueries.
  4. Ecrire des tests unitaires pour les différents DAO.
  5. Vérifier le bon fonctionnement de l'application.

Remarque: Le test unitaire JPATest permet de vérifier que le mapping défini par les annotation est cohérent avec le schéma de la base H2.

Contraintes

Les modifications apportées au projet doivent respecter les contraintes suivantes:

  • Pas de modification du schéma de la base H2
  • Pas de suppression ou de modification des méthodes/constructeurs publics des classes fournies. Il est cependant possible d'ajouter d'autres méthodes dans ces classes.

Indications

Liens utiles

Remarques sur les annotations

  • Lorsqu’une entité/classe possède un identifiant portant sur plusieurs attributs, il faut créer une classe spécifique (qui n'est pas une entité) pour regrouper ces champs, et utiliser un champ de cette classe en lieu et place du groupe de champs servant d'identifiants dans votre modèle objet. Voir @EmbeddedId, @Embbedable, @IdClass. Voir également @ElementCollection/@CollectionTable si les éléments de la collection ne sont pas des entités.
  • Les annotations @Column, @JoinColumn peuvent être dans le mapping
  • Avec le paramètre mappedBy, il est possible d'utiliser une valeur du type maCle.unChamp pour indiquer que la relation inverse est référencée à partir d'un champ dans une clé composée (i.e. en présence de @Embbedable/@EmbbeddedId).
  • L'annotation @Lob peut être utilisée pour les champs contenant de grandes données (type TEXT, CLOB ou BLOB).
  • Pour les id numériques, on peut utiliser @GeneratedValue pour indiquer que l'ID doit être généré automatiquement.
1)
Editer ce fichier en texte, pas avec l'éditeur “formulaire” de Netbeans/Eclipse