Le fichier du descripteur de métadonnées d'entité est un fichier XML
utilisé pour définir un schéma d'entité pour WebSphere eXtreme Scale. Définissez
toutes les métadonnées d'entité dans le fichier XML ou définissez les
métadonnées d'entité comme annotations sur le fichier de classe Java de
l'entité. Il est principalement destiné aux entités qui ne peuvent pas
utiliser d'annotations Java.
Utilisez une configuration XML pour créer des métadonnées
d'entité basées sur le fichier XML. Lorsqu'ils sont utilisés conjointement avec
une annotation, certains des attributs définis dans la configuration XML
remplacent les annotations correspondantes. Si vous remplacez un élément, ce
remplacement se trouve explicitement dans les sections qui suivent. Pour un
exemple de fichier XML de descripteur de métadonnées d'entité, voir Fichier emd.xsd.
Elément id
L'élément id implique que l'attribut est une
clé. Vous devez spécifier au moins un élément id. Vous pouvez spécifier
plusieurs clés id à utiliser comme clé composée.
Attributs- name
- Indique le nom de l'attribut. Cet attribut doit exister dans le fichier Java.
- alias
- Indique l'alias de l'élément. La valeur de l'alias est remplacée si
elle est utilisée conjointement avec une entité annotée.
Elément basic
L'élément basic implique que
l'attribut correspond à un type de primitive ou à des encapsuleurs de types de primitive :
- java.lang.String
- java.math.BigInteger
- java.math.BigDecimal
- java.util.Date
- java.util.Calendar
- java.sql.Date
- java.sql.Time
- java.sql.Timestamp
- byte[]
- Byte[]
- char[]
- Character[]
- enum (Java Platform,
Standard Edition Version 5)
Il n'est pas nécessaire de spécifier d'attribut basic. Les
attributs de l'élément basic sont configurés automatiquement à l'aide de la
réflexion.
Attributs- name
- Indique le nom de l'attribut dans la classe.
- alias
- Indique l'alias de l'élément. La valeur de l'alias est remplacée si
elle est utilisée conjointement avec une entité annotée.
- fetch
- Indique le type d'extraction. Les valeurs valides sont : LAZY ou EAGER.
Elément id-class
L'élément id_class spécifie
une classe de clé composée, qui permet de rechercher les entités contenant des
clés composées.
Attributs- class-name
- Indique le nom de la classe, qui est une classe d'id, à utiliser avec
l'élément id-class.
Elément transient
L'élément transient implique que cet élément est
ignoré et non traité. Il peut également être remplacé s'il est utilisé
conjointement avec des entités annotées.
Attributs- name
- Indique le nom de l'attribut, qui est ignoré.
Elément version
Attributs- name
- Indique le nom de l'attribut, qui est ignoré.
Elément cascade-type
Eléments enfant- cascade-all :
cascade toute l'opération vers les associations.
- cascade-persist :
cascade l'opération persist vers les associations.
- cascade-remove :
cascades l'opération remove vers les associations.
- cascade-merge : non utilisé actuellement.
- cascade-refresh : non utilisé actuellement.
Elément one-to-one
Attributs
- name
- Indique le nom de la classe, qui a une relation un-un.
- alias
- Spécifie un nom d'alias.
- target-entity
- Spécifie la classe d'association. Cette valeur est un nom de classe qualifié complet.
- fetch
- Indique le type d'extraction. Les valeurs valides sont : LAZY ou EAGER.
- mapped-by
- Indique la zone qui détient la relation. L'élément mapped-by est spécifié sur le côté inverse (non-propriétaire) de l'association.
- id
- Identifie l'association comme clé.
Elément one-to-many
Attributs
- name
- Indique le nom de l'attribut dans la classe.
- alias
- Spécifie un nom d'alias.
- target-entity
- Spécifie la classe d'association. Cette valeur est un nom de classe qualifié complet.
- fetch
- Indique le type d'extraction. Les valeurs valides sont : LAZY ou EAGER.
- mapped-by
- Indique la zone qui détient la relation. L'élément mapped-by est spécifié sur le côté inverse (non-propriétaire) de l'association.
Elément many-to-one
Attributs
- name
- Indique le nom de l'attribut dans la classe.
- alias
- Spécifie un nom d'alias.
- target-entity
- Indique la classe à laquelle l'attribut fait référence. Cette valeur est un nom de classe qualifié complet.
- fetch
- Indique le type d'extraction. Les valeurs valides sont : LAZY ou EAGER.
- id
- Identifie l'association comme clé.
Elément many-to-many
Attributs
- name
- Indique le nom de l'attribut dans la classe.
- alias
- Spécifie un nom d'alias.
- target-entity
- Indique la classe à laquelle l'attribut fait référence. Cette valeur est un nom de classe qualifié complet.
- fetch
- Indique le type d'extraction. Les valeurs valides sont : LAZY ou EAGER.
- mapped-by
- Indique la zone qui détient la relation. L'élément mapped-by est spécifié sur le côté inverse (non-propriétaire) de l'association.
Elément Entity
Attributs- name(requis)
- Définit le nom de l'attribut dans la classe.
- class-name
- Spécifie le nom de classe qualifié complet.
- access
- Définit le type d'accès. Les valeurs valides sont PROPERTY ou FIELD.
- schemaRoot
- Spécifie que cette entité est la racine du schéma et elle est utilisée comme classe parent pour les données partitionnées.
Elément entity-listener
Attributs- class-name (requis)
- Définit le nom de la classe d'écoute.
Elément PrePersist
Attributs- method-name (requis)
- Indique la méthode de rappel de cycle de vie de l'événement PrePersist.
Elément PostPersist
Attributs- method-name (requis)
- Indique la méthode de rappel de cycle de vie de l'événement PostPersist.
Elément PreRemove
Attributs- method-name (requis)
- Indique la méthode de rappel de cycle de vie de l'événement PreRemove.
Elément PreUpdate
Attributs- method-name (requis)
- Indique la méthode de rappel de cycle de vie de l'événement PreUpdate.
Elément PostUpdate
Attributs- method-name (requis)
- Indique la méthode de rappel de cycle de vie de l'événement PostUpdate.
Elément PostLoad
Attributs- method-name (requis)
- Indique la méthode de rappel de cycle de vie de l'événement PostLoad.