Fichier XML du descripteur de métadonnées d'entité

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 : 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éments enfant

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éments enfant

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éments enfant

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éments enfant

Elément attributes

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éments enfant

Elément entity-mappings

Eléments enfant

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.