Plusieurs éléments du mapping Hibernate acceptent l'attribut node
. Ceci vous permet de spécifier le nom d'un attribut XML ou d'un élément qui contient la propriété ou les données de l'entité.
Le format de l'attribut node
doit être un des suivants :
"element-name"
- mappe vers l'élément XML nommé
"@attribute-name"
- mappe vers l'attribut XML nommé
"."
- mappe vers le parent de l'élément
"element-name/@attribute-name"
- mappe vers l'élément nommé de l'attribut nommé
Pour des collections et de simples associations valuées, il y a un attribut embed-xml
supplémentaire. Si embed-xml="true"
, qui est la valeur par défaut, l'arbre XML pour l'entité associée (ou la collection des types de valeurs) sera embarquée
directement dans l'arbre XML pour l'entité qui possède l'association. Sinon, si embed-xml="false"
, alors seule la valeur de l'identifiant référencé apparaîtra dans le XML pour de simples associations de points, et les collections
n'appraîtront simplement pas.
Vous devriez faire attention à ne pas laisser embed-xml="true"
pour trop d'associations, puisque XML ne traite pas bien les liens circurlaires.
<class name="Customer" table="CUSTOMER" node="customer"> <id name="id" column="CUST_ID" node="@id"/> <map name="accounts" node="." embed-xml="true"> <key column="CUSTOMER_ID" not-null="true"/> <map-key column="SHORT_DESC" node="@short-desc" type="string"/> <one-to-many entity-name="Account" embed-xml="false" node="account"/> </map> <component name="name" node="name"> <property name="firstName" node="first-name"/> <property name="initial" node="initial"/> <property name="lastName" node="last-name"/> </component> ... </class>
dans ce cas, nous avons décidé d'embarquer la collection d'identifiants de compte, mais pas les données actuelles du compte. La requête HQL suivante :
from Customer c left join fetch c.accounts where c.lastName like :lastName
devrait retourner l'ensemble de données suivant :
<customer id="123456789"> <account short-desc="Savings">987632567</account> <account short-desc="Credit Card">985612323</account> <name> <first-name>Gavin</first-name> <initial>A</initial> <last-name>King</last-name> </name> ... </customer>
Si vous positionnez embed-xml="true"
sur le mapping <one-to-many>
, les données pourraient ressembler plus à ça :
<customer id="123456789"> <account id="987632567" short-desc="Savings"> <customer id="123456789"/> <balance>100.29</balance> </account> <account id="985612323" short-desc="Credit Card"> <customer id="123456789"/> <balance>-2370.34</balance> </account> <name> <first-name>Gavin</first-name> <initial>A</initial> <last-name>King</last-name> </name> ... </customer>