Ajouter ou remplacer les mappages d'entité dans le fichier orm.xml

Vous pouvez utiliser l'éditeur XML de mappage ORM pour définir les mappages objet-relationnel de beans entity JPA dans le fichier orm.xml.

Pourquoi et quand exécuter cette tâche

Lorsque vous spécifiez des mappages objet-relationnel à l'aide des outils JPA, les informations de mappage prennent la forme d'annotations Java placées à l'intérieur des fichiers de classe Java™. Cependant, vous pouvez aussi choisir de définir les mappages objet-relationnel en XML, dans un fichier appelé orm.xml.

Les informations de mappage définies dans le fichier orm.xml prévalent sur le comportement JPA par défaut et les éventuels mappages définis au moyen d'annotations. Vous avez donc la possibilité, par exemple, d'adapter des beans d'entité JPA existants à un ensemble différent de tables de base de données sans modifier leurs fichiers de classe.

Important : L'éditeur XML ORM (Object Relational Mapping) ne s'applique pas aux projets avec JPA version 2.1. Utilisez plutôt la vue des détails JPA.

Pour éditer le fichier orm.xml qui se trouve dans le répertoire META-INF du projet JPA, procédez comme suit :

Procédure

  1. Dans la vue Explorateur de packages, cliquez avec le bouton droit de la souris sur le fichier orm.xml du projet JPA que vous voulez éditer et sélectionnez Ouvrir avec > Editeur XML de mappage ORM.
  2. Cliquez sur l'onglet Conception de l'éditeur XML de mappage ORM et ajoutez les informations de mappage objet-relationnel.
  3. Cliquez sur Fichier > Enregistrer pour enregistrer vos modifications.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: t_editing_orm.html