2.5.2.9. Many To One
When an entity A references a single entity B, and other As might also reference the same B, we say there is a many to one relation from A to B.
In our sample model, for example, each magazine has a reference to its publisher.
Multiple magazines might have the same publisher.
We say, then, that the
Magazine.publisher field is a many to one relation from magazines to publishers.
JPA indicates many to one relations between entities with the ManyToOne annotation.
This annotation has the following properties:
-
Class targetEntity: The class of the related entity type. -
CascadeType[] cascade: Array of enum values defining cascade behavior for this field. We explore cascades below. Defaults to an empty array. -
FetchType fetch: Whether to load the field eagerly (FetchType.EAGER) or lazily (FetchType.LAZY). Defaults toFetchType.EAGER. See Fetch Type above for details on fetch types. -
boolean optional: Whether the related object must exist. Iffalse, this field cannot be null. Defaults totrue.
The equivalent XML element is many-to-one.
It accepts the following attributes:
-
name: The name of the field or property. This attribute is required. -
target-entity: The class of the related type. -
fetch: One ofEAGERorLAZY. -
optional: Boolean indicating whether the field value may be null.