-
@Target({METHOD,FIELD}) @Retention(RUNTIME) public @interface ManyToOneSpecifies a single-valued association to another entity class that has many-to-one multiplicity. It is not usually necessary to specify the target entity explicitly since it can usually be inferred from the type of the object being referenced.If the relationship is bidirectional, the non-owning
OneToManyentity side must use themappedByelement to specify the relationship field or property of the entity that is the owner of the relationship.A
ManyToOneassociation usually maps a foreign key column or columns. This mapping may be specified using theJoinColumnannotation. Alternatively, an optionalOneToOneassociation is sometimes mapped to a join table using theJoinTableannotation.The
ManyToOneannotation may be used within an embeddable class to specify a relationship from the embeddable class to an entity class. If the relationship is bidirectional, the non-owningOneToManyentity side must use themappedByelement of theOneToManyannotation to specify the relationship field or property of the embeddable field or property on the owning side of the relationship. The dot (.) notation syntax must be used in themappedByelement to indicate the relationship attribute within the embedded attribute. The value of each identifier used with the dot notation is the name of the respective embedded field or property.Example 1: {@snippet :
- Since:
- 1.0
-
-
Optional Element Summary
Optional Elements Modifier and Type Optional Element Description CascadeType[]cascade(Optional) The operations that must be cascaded to the target of the association.FetchTypefetch(Optional) Whether the association should be lazily loaded or must be eagerly fetched.booleanoptional(Optional) Whether the association is optional.java.lang.Class<?>targetEntity(Optional) The entity class that is the target of the association.
-
-
-
-
cascade
CascadeType[] cascade
(Optional) The operations that must be cascaded to the target of the association.By default no operations are cascaded.
- Default:
- {}
-
-
-
fetch
FetchType fetch
(Optional) Whether the association should be lazily loaded or must be eagerly fetched.- The
EAGERstrategy is a requirement on the persistence provider runtime that the associated entity must be eagerly fetched. - The
LAZYstrategy is a hint to the persistence provider runtime.
If not specified, defaults to
EAGER.- Default:
- jakarta.persistence.FetchType.EAGER
- The
-
-
-
optional
boolean optional
(Optional) Whether the association is optional. If set to false then a non-null relationship must always exist.May be used in schema generation to infer that the mapped foreign key column is
not null.- Default:
- true
-
-