Notez que cette fonctionnalité est expérimentale dans Hibernate 3.0 et est en développement extrêmement actif. Hibernate vous laisse travailler avec des données XML persistantes de la même manière que vous travaillez avec des POJOs persistants. Un arbre XML peut être vu comme une autre manière de représenter les données relationnelles au niveau objet, à la place des POJOs. Hibernate supporte dom4j en tant qu'API pour la manipulation des arbres XML. Vous pouvez écrire des requêtes qui récupèrent des arbres dom4j à partie de la base de données, et avoir toutes les modifications que vous faites sur l'arbre automatiquement synchronisées dans la base de données. Vous pouvez même prendre un document XML, l'analyser en utilisant dom4j, et l'écrire dans la base de données via les opérations basiques d'Hibernate : persist(), saveOrUpdate(), merge(), delete(), replicate() (merge() n'est pas encore supporté). Cette fonctionnalité a plusieurs applications dont l'import/export de données, l'externalisation d'entités via JMS ou SOAP et les rapports XSLT. Un simple mapping peut être utilisé pour simultanément mapper les propriétés d'une classe et les noeuds d'un document XML vers la base de données, ou, si il n'y a pas de classe à mapper, il peut être utilisé juste pour mapper le XML. Voici un exemple de mapping d'un POJO et du XML simultanément : ... ]]> Voici un exemple dans lequel il n'y a pas de class POJO : ... ]]> Ce mapping vous permet d'accéder aux données comme un arbre dom4j, ou comme un graphe de paire nom de propriété/valeur (Maps java). Les noms des propriétés sont des constructions purement logiques qui peuvent être référées des dans requêtes HQL. 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. ... ]]> 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 : devrait retourner l'ensemble de données suivant : 987632567 985612323 Gavin A King ... ]]> Si vous positionnez embed-xml="true" sur le mapping <one-to-many>, les données pourraient ressembler plus à ça : 100.29 -2370.34 Gavin A King ... ]]> Relisons et mettons à jour des documents XML dans l'application. Nous faisons ça en obtenant une session dom4j : Il est extrêmement utile de combiner cette fonctionnalité avec l'opération replicate() d'Hibernate pour implémenter des imports/exports de données XML.