FAQ HibernateConsultez toutes les FAQ

Un fichier de mapping est tout simplement un fichier XML qui va permettre à Hibernate de faire le lien entre vos objets Java et la base de données.

Voici sa structure la plus basique :

1
2
3
4
5
6
7
8
9
10
11
12
<?xml version="1.0"?> 
<!DOCTYPE hibernate-mapping PUBLIC 
        "-//Hibernate/Hibernate Mapping DTD 3.0//EN" 
        "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"> 
  
<hibernate-mapping> 
  
    <class name="NomDeLaClasse" table="NOMDELATABLE"> 
  
    </class> 
  
</hibernate-mapping>

Pour ajouter une propriété à un de vos objets, il vous faut modifier le fichier de mapping de cet objet.

L'ajout d'une propriété est très simple, il vous suffit d'ajouter une ligne comme celle-ci :

<property name="nomDeLaVariable" type="typeDeLaValeur" column="ColonneOuTrouverCetteValeur"/>

Comme il est conseillé de bien séparer la couche de persistance de la couche métier, vos classes de persistance, seront de simples classes avec des getters et des setters, des Javabeans. Il faudrait éviter d'implémenter des opérations métiers dans ces classes, mais cette restriction est très relative et plusieurs opinions existent sur le sujet. L'important étant que vous sépariez correctement les couches de votre application.

Voici un simple exemple d'une de ces classes :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
public class OdActeur { 
	private String nom = null; 
	private String prenom = null; 
  
	public String getNom(){ 
		return nom; 
	} 
  
	public void setNom(String nom){ 
		this.nom = nom; 
	} 
  
	public String getPrenom(){ 
		return prenom; 
	} 
  
	public void setPrenom(String prenom){ 
		this.prenom = prenom; 
	} 
}

La réponse est oui. Effectivement, Hibernate permet de mapper les classes qui n'ont pas de clé primaire.

Lorsqu'une table n'a pas de clé primaire, le tag <generator .. > à l'intérieur du tag <id .....> </id> n'est pas indispensable car par defaut, il est à "assigned". Mais le tag <id .....> </id> est obligatoire car Hibernate se sert de ce tag pour rechercher (loader) vos objets. Dans vos fichiers de mapping, vous devez avoir ceci :

1
2
3
4
5
6
7
8
<id 
	column="nomColumn" 
	name="unNom" 
	type="LeType" 
> 
	<generator class="assigned" /> 
</id> 
<property ... />

1
2
3
4
5
6
7
<id 
	column="nomColumn" 
	name="unNom" 
	type="LeType" 
> 
</id> 
<property ... />

Hibernate dispose de trois types de mapping gérés nativement : "yes_no", "true_false" et "boolean". Le premier permet de mapper une ligne de la base de données contenant "Y" ou "N", le second, "T" ou "F".

Exemple avec yes_no : pour un attribut nommé "is_public" de la table "logic_data" de la base de données, voici la correspondance du fichier de mapping (hbm.xml) :

1
2
3
4
5
6
7
8
<hibernate-mapping> 
    <class name="com.mycompany.mypackage.LogicData" table="logic_data"> 
        <property name="isPublic" type="yes_no"> 
            <column name="is_public" /> 
        </property> 
        [...] 
    </class> 
</hibernate-mapping>

1
2
3
4
5
6
7
8
9
10
11
public class LogicData implements java.io.Serializable { 
	private Boolean		isPublic; 
        [...] 
	public Boolean getIsPublic() { 
		return this.isPublic; 
	}	 
	public void setIsPublic(Boolean isPublic) { 
		this.isPublic = isPublic; 
	} 
        [...] 
}