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.