javax.persistence

Annotation Type PersistenceContext

@Target(value={TYPE,METHOD,FIELD})
 @Retention(value=RUNTIME)
public @interface PersistenceContext

Expresses a dependency on a container-managed EntityManager and its associated persistence context.

Since:

Java Persistence 1.0

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	name (Optional) The name by which the entity manager is to be accessed in the environment referencing context; not needed when dependency injection is used.
PersistenceProperty[]	properties (Optional) Properties for the container or persistence provider.
SynchronizationType	synchronization (Optional) Specifies whether the persistence context is always automatically synchronized with the current JTA transaction or whether the persistence context must be explicitly joined to the current JTA transaction by means of the EntityManager joinTransaction method
PersistenceContextType	type (Optional) Specifies whether a transaction-scoped persistence context or an extended persistence context is to be used.
String	unitName (Optional) The name of the persistence unit as defined in the persistence.xml file.

Element Detail

name

public abstract String name

(Optional) The name by which the entity manager is to be accessed in the environment referencing context; not needed when dependency injection is used.

Returns:

Name

Default:

""

unitName

public abstract String unitName

(Optional) The name of the persistence unit as defined in the persistence.xml file. If the unitName element is specified, the persistence unit for the entity manager that is accessible in JNDI must have the same name.

Returns:

unit name

Default:

""

type

public abstract PersistenceContextType type

(Optional) Specifies whether a transaction-scoped persistence context or an extended persistence context is to be used.

Returns:

type

Default:

javax.persistence.PersistenceContextType.TRANSACTION

synchronization

public abstract SynchronizationType synchronization

(Optional) Specifies whether the persistence context is always automatically synchronized with the current JTA transaction or whether the persistence context must be explicitly joined to the current JTA transaction by means of the EntityManager joinTransaction method

Returns:

sync

Since:

Java Persistence 2.1

Default:

javax.persistence.SynchronizationType.SYNCHRONIZED

properties

public abstract PersistenceProperty[] properties

(Optional) Properties for the container or persistence provider. Vendor specific properties may be included in this set of properties. Properties that are not recognized by a vendor are ignored.

Returns:

properties

Default:

{}