Package javax.persistence

Interface Summary

Interface	Description
Cache	Interface used to interact with the second-level cache.
EntityManager	Interface used to interact with the persistence context.
EntityManagerFactory	Interface used to interact with the entity manager factory for the persistence unit.
EntityTransaction	Interface used to control transactions on resource-local entity managers.
Parameter<T>	Type for query parameter objects.
PersistenceUnitUtil	Utility interface between the application and the persistence provider managing the persistence unit.
PersistenceUtil	Utility interface between the application and the persistence provider(s).
Query	Interface used to control query execution.
Tuple	Interface for extracting the elements of a query result tuple.
TupleElement<X>	The TupleElement interface defines an element that is returned in a query result tuple.
TypedQuery<X>	Interface used to control the execution of typed queries.

Class Summary

Class	Description
Persistence	Bootstrap class that provides access to an EntityManagerFactory.

Enum Summary

Enum	Description
AccessType	Is used with the Access annotation to specify an access type to be applied to an entity class, mapped superclass, or embeddable class, or to a specific attribute of such a class.
CacheRetrieveMode	Used as the value of the javax.persistence.cache.retrieveMode property to specify the behavior when data is retrieved by the find methods and by queries.
CacheStoreMode	Used as the value of the javax.persistence.cache.storeMode property to specify the behavior when data is read from the database and when data is committed into the database.
CascadeType	Defines the set of cascadable operations that are propagated to the associated entity.
DiscriminatorType	Defines supported types of the discriminator column.
EnumType	Defines mapping for enumerated types.
FetchType	Defines strategies for fetching data from the database.
FlushModeType	Flush mode setting.
GenerationType	Defines the types of primary key generation strategies.
InheritanceType	Defines inheritance strategy options.
LockModeType	Lock modes can be specified by means of passing a LockModeType argument to one of the EntityManager methods that take locks (lock, find, or refresh) or to the Query.setLockMode() or TypedQuery.setLockMode() method.
PersistenceContextType	Specifies whether a transaction-scoped or extended persistence context is to be used in PersistenceContext.
PessimisticLockScope	Defines the values of the javax.persistence.lock.scope property for pessimistic locking.
SharedCacheMode	Specifies how the provider must use a second-level cache for the persistence unit.
TemporalType	Type used to indicate a specific mapping of java.util.Date or java.util.Calendar.
ValidationMode	The validation mode to be used by the provider for the persistence unit.

Exception Summary

Exception	Description
EntityExistsException	Thrown by the persistence provider when EntityManager.persist(Object) is called and the entity already exists.
EntityNotFoundException	Thrown by the persistence provider when an entity reference obtained by EntityManager.getReference is accessed but the entity does not exist.
LockTimeoutException	Thrown by the persistence provider when an pessimistic locking conflict occurs that does not result in transaction rollback.
NonUniqueResultException	Thrown by the persistence provider when Query.getSingleResult() or TypedQuery.getSingleResult() is executed on a query and there is more than one result from the query.
NoResultException	Thrown by the persistence provider when Query.getSingleResult() or TypedQuery.getSingleResult()is executed on a query and there is no result to return.
OptimisticLockException	Thrown by the persistence provider when an optimistic locking conflict occurs.
PersistenceException	Thrown by the persistence provider when a problem occurs.
PessimisticLockException	Thrown by the persistence provider when an pessimistic locking conflict occurs.
QueryTimeoutException	Thrown by the persistence provider when a query times out and only the statement is rolled back.
RollbackException	Thrown by the persistence provider when EntityTransaction.commit() fails.
TransactionRequiredException	Thrown by the persistence provider when a transaction is required but is not active.

Annotation Types Summary

Annotation Type	Description
Access	Used to specify an access type to be applied to an entity class, mapped superclass, or embeddable class, or to a specific attribute of such a class.
AssociationOverride	Used to override a mapping for an entity relationship.
AssociationOverrides	Used to override mappings of multiple relationship properties or fields.
AttributeOverride	Used to override the mapping of a Basic (whether explicit or default) property or field or Id property or field.
AttributeOverrides	Used to override mappings of multiple properties or fields.
Basic	The simplest type of mapping to a database column.
Cacheable	Specifies whether an entity should be cached if caching is enabled when the value of the persistence.xml caching element is ENABLE_SELECTIVE or DISABLE_SELECTIVE.
CollectionTable	Specifies the table that is used for the mapping of collections of basic or embeddable types.
Column	Is used to specify the mapped column for a persistent property or field.
ColumnResult	References name of a column in the SELECT clause of a SQL query - i.e., column alias, if applicable.
DiscriminatorColumn	Specifies the discriminator column for the SINGLE_TABLE and JOINED Inheritance mapping strategies.
DiscriminatorValue	Specifies the value of the discriminator column for entities of the given type.
ElementCollection	Defines a collection of instances of a basic type or embeddable class.
Embeddable	Defines a class whose instances are stored as an intrinsic part of an owning entity and share the identity of the entity.
Embedded	Specifies a persistent field or property of an entity whose value is an instance of an embeddable class.
EmbeddedId	Applied to a persistent field or property of an entity class or mapped superclass to denote a composite primary key that is an embeddable class.
Entity	Specifies that the class is an entity.
EntityListeners	Specifies the callback listener classes to be used for an entity or mapped superclass.
EntityResult	Used to map the SELECT clause of a SQL query to an entity result.
Enumerated	Specifies that a persistent property or field should be persisted as a enumerated type.
ExcludeDefaultListeners	Specifies that the invocation of default listeners is to be excluded for the entity class (or mapped superclass) and its subclasses.
ExcludeSuperclassListeners	Specifies that the invocation of superclass listeners is to be excluded for the entity class (or mapped superclass) and its subclasses.
FieldResult	Is used to map the columns specified in the SELECT list of the query to the properties or fields of the entity class.
GeneratedValue	Provides for the specification of generation strategies for the values of primary keys.
Id	Specifies the primary key of an entity.
IdClass	Specifies a composite primary key class that is mapped to multiple fields or properties of the entity.
Inheritance	Defines the inheritance strategy to be used for an entity class hierarchy.
JoinColumn	Specifies a column for joining an entity association or element collection.
JoinColumns	Defines mapping for composite foreign keys.
JoinTable	Used in the mapping of associations.
Lob	Specifies that a persistent property or field should be persisted as a large object to a database-supported large object type.
ManyToMany	Defines a many-valued association with many-to-many multiplicity.
ManyToOne	Defines a single-valued association to another entity class that has many-to-one multiplicity.
MapKey	Specifies the map key for associations of type java.util.Map when the map key is itself the primary key or a persistent field or property of the entity that is the value of the map.
MapKeyClass	Specifies the type of the map key for associations of type java.util.Map.
MapKeyColumn	Specifies the mapping for the key column of a map whose map key is a basic type.
MapKeyEnumerated	Specifies the enum type for a map key whose basic type is an enumerated type.
MapKeyJoinColumn	Specifies a mapping to an entity that is a map key.
MapKeyJoinColumns	Supports composite map keys that reference entities.
MapKeyTemporal	This annotation must be specified for persistent map keys of type Date and Calendar.
MappedSuperclass	Designates a class whose mapping information is applied to the entities that inherit from it.
MapsId	Designates a ManyToOne or OneToOne relationship attribute that provides the mapping for an EmbeddedId primary key, an attribute within an EmbeddedId primary key, or a simple primary key of the parent entity.
NamedNativeQueries	Used to specify multiple native SQL named queries.
NamedNativeQuery	Specifies a named native SQL query.
NamedQueries	Specifies multiple named Java Persistence query language queries.
NamedQuery	Specifies a static, named query in the Java Persistence query language.
OneToMany	Defines a many-valued association with one-to-many multiplicity.
OneToOne	Defines a single-valued association to another entity that has one-to-one multiplicity.
OrderBy	Specifies the ordering of the elements of a collection valued association or element collection at the point when the association or collection is retrieved.
OrderColumn	Specifies a column that is used to maintain the persistent order of a list.
PersistenceContext	Expresses a dependency on a container-managed EntityManager and its associated persistence context.
PersistenceContexts	Declares one or more PersistenceContext annotations.
PersistenceProperty	Describes a single container or persistence provider property.
PersistenceUnit	Expresses a dependency on an EntityManagerFactory and its associated persistence unit.
PersistenceUnits	Declares one or more PersistenceUnit annotations.
PostLoad	Is used to specify callback methods for the corresponding lifecycle event.
PostPersist	Is used to specify callback methods for the corresponding lifecycle event.
PostRemove	Is used to specify callback methods for the corresponding lifecycle event.
PostUpdate	Is used to specify callback methods for the corresponding lifecycle event.
PrePersist	Is used to specify callback methods for the corresponding lifecycle event.
PreRemove	Is used to specify callback methods for the corresponding lifecycle event.
PreUpdate	Is used to specify callback methods for the corresponding lifecycle event.
PrimaryKeyJoinColumn	Specifies a primary key column that is used as a foreign key to join to another table.
PrimaryKeyJoinColumns	Groups PrimaryKeyJoinColumn annotations.
QueryHint	Used to supply a query property or hint to the NamedQuery or NamedNativeQuery annotation.
SecondaryTable	Specifies a secondary table for the annotated entity class.
SecondaryTables	Specifies multiple secondary tables for an entity.
SequenceGenerator	Defines a primary key generator that may be referenced by name when a generator element is specified for the GeneratedValue annotation.
SqlResultSetMapping	Specifies the mapping of the result of a native SQL query.
SqlResultSetMappings	Is used to define one or more SqlResultSetMapping annotations.
Table	Specifies the primary table for the annotated entity.
TableGenerator	Defines a primary key generator that may be referenced by name when a generator element is specified for the GeneratedValue annotation.
Temporal	This annotation must be specified for persistent fields or properties of type java.util.Date and java.util.Calendar.
Transient	Specifies that the property or field is not persistent.
UniqueConstraint	Specifies that a unique constraint is to be included in the generated DDL for a primary or secondary table.
Version	Specifies the version field or property of an entity class that serves as its optimistic lock value.