Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

EclipseLink/UserGuide/JPA/Basic JPA Development/Entities/Creating and Configuring Entities

EclipseLink JPA

Eclipselink-logo.gif
EclipseLink
Website
Download
Community
Mailing ListForumsIRCmattermost
Issues
OpenHelp WantedBug Day
Contribute
Browse Source

Elug api package icon.png Native API


Configuring Entities

An entity is a lightweight persistence domain object. Typically, an entity represents a table in a relational database, and each entity instance corresponds to a row in the table. The primary programming artifact of an entity is the entity class, although entities can use helper classes.

The persistent state of an entity is represented either through persistent fields or persistent properties. These fields or properties use object/relational mapping annotations to map the entities and entity relationships to the relational data in the underlying data store.

Identifying an Entity

Use the @Entity annotation to specify that a class is an entity, as shown in the following example:

@Entity
public class Employee implements Serializable {
...
}

Elug note icon.png

Note: The entity class must also be listed in your persistence.xml file, unless you set the tag <exclude-unlisted-classes> to false. An entity can also be defined using an orm.xml file and the <entity> tag.

Elug javaspec icon.gif

For more information, see Chapter 2 "Entities" in the JPA Specification.

Configuring an Entity's Persistent Identity

Every entity must have a persistent identity, which is an equivalent of a primary key in a database table that stores the entity state.

By default, the EclipseLink persistence provider assumes that each entity has at least one field or property that serves as a primary key.

You can generate and/or configure the identity of your entities by using the following annotations:

You can also use these annotations to fine-tune how your database maintains the identity of your entities.

Elug note icon.png

Note: If your class does not have a logical Id then you need to add a generated one. Embedded objects do not require an Id.



Eclipselink-logo.gif
Version: 2.2.0 DRAFT
Other versions...

Back to the top