12.3. Annotations Hibernate

12.3.1. Annotations Hibernate

Tableau 12.7. Annotations définies d'Hibernate

Annotation Description
AccessType Type d'accès de propriété
Tous Définit une association ToOne pointant vers plusieurs types d'entités. L'association du type d'entité correspondant se fait à travers une colonne discriminatoire de métadonnées. Ce type de mappage devrait seulement être marginal.
AnyMetaDef Définit les métadonnées @Any et @manyToAny.
AnyMedaDefs Définit les ensembles de métadonnées @Any et @ManyToAny. Peut être défini au niveau d'entité ou de paquetage.
BatchSize Taille de lot pour chargement SQL.
Cache Ajouter une stratégie de mise en cache à une entité root ou une collection.
Cascade Appliquer une stratégie de cascade sur une association
Check Contraintes de vérification SQL arbitraires qui peuvent être définies aux niveaux de classe, de propriété ou de collection.
Columns Prend en charge une gamme de colonnes. Utile pour les mappages de type utilisateur de composant.
ColumnTransformer Expression SQL personnalisée utilisée pour lire la valeur depuis et écrire une valeur vers une colonne. Utiliser pour le chargement/enregistrement d'objet direct ainsi que les requêtes. L'expression de lecture doit contenir exactement un "?" pour la valeur.
ColumnTransformers Annotation plurielle pour @ColumnTransformer. Utile lorsque plus d'une colonne utilise ce comportement.
DiscriminatorFormula Formule discriminatoire à placer à l'entité de root.
DiscriminatorOptions Annotation optionnelle pour exprimer les propriétés discriminatoires spécifiques à Hibernate.
Entity Prolonge l'entité avec les caractéristiques Hibernate.
Fetch Définit la stratégie de récupération utilisée pour l'association donnée.
FetchProfile Définit le profil de stratégie de récupération
FetchProfiles Annotation plurielle pour @FetchProfile.
Filter Ajoute des filtres à une entité ou une entité de cible d'une collection.
FilterDef Définition de Filtre.
FilterDefs Gamme de définitions de filtre.
FilterJoinTable Ajoute des filtres pour une collection rejoindre une table
FilterJoinTables Ajoute de multiples @FilterJoinTable à une collection
Filters Ajoute de multiples @Filters.
Formula A utiliser comme remplacement pour @Column dans la plupart des emplacements. La formule doit être un fragment SQL valide.
Generated Cette propriété annotée est générée par la base de données.
GenericGenerator Annotation de générateur décrivant toute sorte de générateur Hibernate d'une manière non-typée.
GenericGenerators Gamme de définitions de générateur génériques.
Immutable
Marque une Entité ou une Collection comme immuable. Si aucune annotation, l'élément est mutable.
Une entité immuable peut ne pas être mise à jour par l'application. Les mises à jour vers une entité immuable seront ignorées, mais aucune exception ne sera levée.
Placer @Immutable sur une collection rend la collection immuable, ce qui signifie que les additions et suppressions vers et depuis la collection ne sont pas autorisées. Une HibernateException est levée dans ce cas.
Index Définit un indice de base de données.
JoinFormula A utiliser comme remplacement pour @JoinColumn dans la plupart des emplacements. La formule doit être un fragment SQL valable.
LazyCollection Définit le statut lazy d'une collection
LazyToOne Définit le statut lazy d'une association ToOne (c'est-à-dire OneToOne or ManyToOne).
Loader Ecrase la méthode FIND par défaut de Hibernate.
ManyToAny Définit une association ToMany en indiquant différent types d'entité. L'association du type d'entité correspondant se fait à travers une colonne discriminatoire de métadonnées. Ce type de mappage devrait seulement être marginal.
MapKeyType Définit le type de clé d'une mappe persistante.
MetaValue Représente une valeur discriminatoire associée à un type d'entité donné.
NamedNativeQueries Prolonge les NamedNativeQueries pour maintenir les objets NamedNativeQuery de Hibernate.
NamedNativeQuery Prolonge la NamedNativeQuery avec les caractéristiques Hibernate.
NamedQueries Etend les NamedQueries pour maintenir les objets NamedQuery de Hibernate.
NamedQuery Prolonge NamedQuery avec les caractéristiques Hibernate.
IdNaturel Indique que la propriété fait partie de l'identifiant naturel de l'entité.
NotFound Action à accomplir lorsqu'un élément est introuvable dans une association.
OnDelete Stratégie à utiliser pour la suppression de collections, de tableaux ou de sous-classes jointes. OnDelete des tableaux secondaires n'est pas actuellement pris en charge.
OptimisticLock Indique si une modification de la propriété annotée déclenchera une incrémentation de version d'entité. Si l'annotation n'est pas présente, la propriété est impliquée dans la stratégie de verrouillage optimiste (par défaut).
OptimisticLocking Utilisé pour définir le style de verrouillage optimiste à appliquer à une entité. Dans une hiérarchie, seulement valide sur l'entité de root.
OrderBy Ordonner une collection en utilisant l'ordre SQL (pas l'ordre HSL).
ParamDef Une définition de paramètre.
Paramètre Modèle clé/valeur
Parent Renvoie la référence de la propriété en tant que pointeur vers le propriétaire (en général l'entité propriétaire).
Persister Indique un persister personnalisé
Polymorphisme Utilisé pour définir le type de polymorphisme qu'Hibernate appliquera aux hiérarchies d'entité.
Proxy Configuration proxy et lazy d'une classe particulière.
RowId Prend en charge les caractéristiques de mappage ROWID de Hibernate
Tri Tri de collection (tri de niveau Java).
Source Annotation optionnelle conjointement avec les propriétés de Version et de version Timestamp. La valeur d'annotation décide de l'endroit où timestamp est généré.
SQLDelete Ecrase la méthode DELETE par défaut de Hibernate.
SQLDeleteAll Ecrase la méthode DELETE ALL par défaut de Hibernate.
SQLInsert Remplace la méthode INSERT INTO par défaut de Hibernate.
SQLUpdate Remplace la méthode UPDATE par défaut de Hibernate.
Subselect Mappe une entité immuable et en lecture seule vers une expression sous-sélection SQL donnée.
Synchronize S'assure qu'auto-flush fonctionne correctement et que les requêtes concernant l'entité dérivée ne renvoient pas des données obsolètes. Principalement utilisé avec Subselect.
Table Information complémentaire d'une table primaire ou secondaire
Tables Annotation plurielle de Table
Cible Définit une source explicite et évite la résolution de réflexion et de génériques.
Tuplizer Définit un tuplizer pour une entité ou un composant.
Tuplizers Définit un ensemble de tuplizers pour une entité ou un composant.
Type Type Hibernate.
TypeDef Définition d'un type Hibernate
TypeDefs Gamme de définition de Type Hibernate
Where Clause Where à ajouter à l'élément Entité ou entité de cible d'une collection. La clause est écrite en SQL.
WhereJoinTable Clause Where à ajouter à la collection joindre une table. La clause est écrite en SQL.

Note

L'annotation « Entity » est obsolète et doit être supprimée dans les versions à venir.