====== Mise en oeuvre de mappings Objet/Relationnels ======

===== Modalités de rendu =====

  * Ce TP sera à rendre pour le **dimanche <del>21/10/2012</del> 28/10/2012** par dépôt sur la page Spiral suivante: [[http://spiralconnect.univ-lyon1.fr/spiral/spiral.html#/activities/goto_folder/1837569|Zone de dépôt]]. 
  * Il est demandé de rendre un zip du projet maven, sans le répertoire ''target''. Bien penser à remplir le fichier ''etudiants.txt''. Il est possible d'ajouter dans ce fichier tout commentaire à destination du correcteur.
  * Un rendu par binôme, trinômes interdits.
  * On précisera dans le fichier ''etudiants.txt'' si le TP a été réalisé avec PostgreSQL ou bien avec Oracle.

===== Introduction =====

L'objectif de ce TP est de mettre en place un mapping Objet/Relationnel via l'API [[http://en.wikipedia.org/wiki/Java_Persistence_API|JPA]].

Quelques liens:
  * [[http://java.sun.com/javaee/5/docs/api/|API JEE 5]] -> package ''javax.persistence''
  * [[http://en.wikipedia.org/wiki/Java_Persistence_API|JPA]]
  * [[https://www.hibernate.org/|Hibernate]]
  * [[http://java.sun.com/javaee/5/docs/tutorial/doc/bnbpz.html|Tutoriel JPA]] en anglais
  * {{:enseignement:bdav:bdav-orms.pdf|Transparents du cours ORM}}
  * [[tp-orm|Un ancien TP sur les ORM]]

===== Schema relationnel =====

On considère le schéma relationnel fourni dans un des fichiers suivants (selon le SGBD choisi): {{:enseignement:tp:bd:tp-orm:mif18-2012-postgres.sql|schema PostgreSQL}}, {{:enseignement:tp:bd:tp-orm:mif18-2012-oracle.sql|schema Oracle}}

Utiliser le script choisi pour créer les tables:
  * soit dans le schéma public de la base postgres du serveur postgresql installé sur votre machine (rappel serveur: localhost, base: postgres, login: etudiant, mdp: etudiant)
  * soit dans votre compte Oracle (voir tomusss.univ-lyon1.fr pour le login)
    * dans ce cas, il sera nécessaire télécharger en plus le fichier [[http://liris.cnrs.fr/~ecoquery/files/ojdbc6.jar|ojdbc6.jar]] et d'exécuter la commande suivante (commande sous Linux/Mac, à adapter sous Windows) en remplaçant ''mon_repertoire'' par le répertoire où se trouve le fichier ''ojdbc6.jar'':<code shell>mvn install:install-file  -Dfile=mon_repertoire/ojdbc6.jar -DgroupId=com.oracle -DartifactId=ojdbc -Dversion=6 -Dpackaging=jar -DgeneratePom=true -DcreateChecksum=true</code>

===== Projet embryonnaire =====

Maven est un utilitaire de compilation/exécution/test de projet Java qui sera utilisé dans le cadre des TP de l'UE.
Configurer Maven comme indiqué [[enseignement:aide:logiciels#maven|dans l'aide]].

Télécharger et décompresser le projet de base: {{:enseignement:tp:bd:tp-orm:mif18-tp-orm-base.zip|bdav-tp-orm-base.zip}}.

Un projet Maven possède deux répertoires de sources: src/main et src/test. Le premier contient les classes "métier" alors que le second ne contient que le code de test.

Dans Eclipse, il faut importer le projet en utilisant ''Import existing maven project''.

Le fichier ''pom.xml'' contient les dépendances sur les bibliothèques nécessaires au TP.

Le fichier ''src/main/resources/META-INF/persistence.xml'' contient les informations pour mettre en place le cadre de persistence.

<note tip>Si vous utilisez Oracle, ces deux fichiers sont à modifier en suivant les commentaires qui sont dedans.</note>

===== Travail demandé =====

  - Concevoir un modèle objet correspondant au modèle relationnel fourni et créer des classes Java correspondantes.
  - Annoter les classes via des annotations du package ''javax.persistence'', afin d'établir les liens entre le modèle relationnel et votre modèle objet. 

==== Remarques additionnelles ====

=== Tester le mapping ===

Le mapping relationnel objet peut être tester à travers le [[:enseignement:aide:apis#junit|TestCase JUnit]] placé dans ''src/test/java/bdav/orm/MappingTest.java''.
Cette classe est exécutable directement comme test JUnit dans Eclipse ou Netbeans.

=== Divers ===
  * 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''.
  * Les annotations @Column, @JoinColumn, @JoinTable sont à utiliser dans le mapping
  * Changer ''hibernate.hbm2ddl.auto'' de ''validate'' à ''update'' permet au framework de modifier le schéma relationnel. Cela peut être utile pour comprendre à quoi correspond le mapping en cours de développement, mais cela écrase le schéma de l'énoncé. A la fin du TP, le mapping doit fonctionner avec le schéma de fourni plus haut. En cas d'impossibilité, justifier les différences dans des commentaires appropriés dans les classes Java.
  * L'ordre suivant est suggéré dans la mise en place des classes et du mapping:
    * Classe Film sans association. On pourra utiliser/s'inspirer du code suivant:<code java>

@Entity(name = "film")
public class Film implements Serializable {
	private static final long serialVersionUID = 1L;

	@Id
	@GeneratedValue(generator = "film_gen", strategy = GenerationType.SEQUENCE)
	@SequenceGenerator(sequenceName = "film_seq", name = "film_gen")
	private int id;

	private String titre;

	private int annee;

	public String getTitre() {
		return titre;
	}

	public void setTitre(String titre) {
		this.titre = titre;
	}

	public int getAnnee() {
		return annee;
	}

	public void setAnnee(int annee) {
		this.annee = annee;
	}

	public int getId() {
		return id;
	}
	

// Généré dans Eclipse via "Source" -> "Generate hashCode and equals ..."
	@Override
	public int hashCode() {
		final int prime = 31;
		int result = 1;
		result = prime * result + annee;
		result = prime * result + id;
		result = prime * result + ((titre == null) ? 0 : titre.hashCode());
		return result;
	}

	@Override
	public boolean equals(Object obj) {
		if (this == obj)
			return true;
		if (obj == null)
			return false;
		if (getClass() != obj.getClass())
			return false;
		Film other = (Film) obj;
		if (annee != other.annee)
			return false;
		if (id != other.id)
			return false;
		if (titre == null) {
			if (other.titre != null)
				return false;
		} else if (!titre.equals(other.titre))
			return false;
		return true;
	}
}
</code>
    * Classe Personne sans association
    * Classe Societe sans association
    * Association Film réalisé par Personne
    * Association Société produit Film
    * Classe Role (''joue_dans'') sans association
    * Associations liées à la classe Role