Package org.jboss.as.jpa.container

Class ExtendedEntityManager

  • All Implemented Interfaces:
    jakarta.persistence.EntityManager, Serializable, AutoCloseable, SynchronizationTypeAccess
    public class ExtendedEntityManager
extends AbstractEntityManager
implements Serializable, SynchronizationTypeAccess
    Represents the Extended persistence context injected into a stateful bean. At bean invocation time, will join the active Jakarta Transactions transaction if one is present. If no active Jakarta Transactions transaction is present, created/deleted/updated/loaded entities will remain associated with the entity manager until it is joined with a transaction (commit will save the changes, rollback will lose them).

    At injection time, an instance of this class is associated with the SFSB. During a SFSB1 invocation, if a new SFSB2 is created with an XPC referencing the same persistence unit, the new SFSB2 will inherit the same persistence context from SFSB1. Both SFSB1 + SFSB2 will maintain a reference to the underlying persistence context, such that the underlying persistence context will be kept around until both SFSB1 + SFSB2 are destroyed. At cluster replication time or passivation, both SFSB1 + SFSB2 will be serialized consecutively and this instance will only be serialized once.

    Note: Unlike TransactionScopedEntityManager, ExtendedEntityManager will directly be shared instead of the underlying EntityManager.

    During serialization, A NotSerializableException will be thrown if the following conditions are not met: - The underlying persistence provider (entity manager) must be Serializable. - The entity classes in the extended persistence context must also be Serializable.

    Author:
    Scott Marlow
    See Also:
    Serialized Form

    • Constructor Detail

      • ExtendedEntityManager

        public ExtendedEntityManager​(String puScopedName,
                             jakarta.persistence.EntityManager underlyingEntityManager,
                             jakarta.persistence.SynchronizationType synchronizationType,
                             jakarta.transaction.TransactionSynchronizationRegistry transactionSynchronizationRegistry,
                             jakarta.transaction.TransactionManager transactionManager)

    • Method Detail

      • getEntityManager

        protected jakarta.persistence.EntityManager getEntityManager()
        The Jakarta Persistence SFSB interceptor will track the stack of SFSB invocations. The underlying EM will be obtained from the current SFSB being invoked (via our Jakarta Persistence SFSB interceptor). Every entity manager call (to AbstractEntityManager) will call this method to get the underlying entity manager (e.g. the Hibernate persistence provider). See org.jboss.ejb3.stateful.EJB3XPCResolver.getExtendedPersistenceContext() to see the as6 implementation of this.
        Specified by:
        getEntityManager in class AbstractEntityManager
        Returns:
        EntityManager

      • internalAssociateWithJtaTx

        public void internalAssociateWithJtaTx()
        Associate the extended persistence context with the current Jakarta Transactions transaction (if one is found) this method is private to the Jakarta Persistence subsystem

      • isExtendedPersistenceContext

        protected boolean isExtendedPersistenceContext()
        Specified by:
        isExtendedPersistenceContext in class AbstractEntityManager
        Returns:
        true if an extended persistence context is in use

        Precondition: getEntityManager() must be called previous to calling isExtendedPersistenceContext

      • isInTx

        protected boolean isInTx()
        Specified by:
        isInTx in class AbstractEntityManager
        Returns:
        true if a Jakarta Transactions transaction active

        Precondition: getEntityManager() must be called previous to calling isInTx

      • close

        public void close()
        Catch the application trying to close the container managed entity manager and throw an IllegalStateException
        Specified by:
        close in interface AutoCloseable
        Specified by:
        close in interface jakarta.persistence.EntityManager
        Overrides:
        close in class AbstractEntityManager

      • increaseReferenceCount

        public void increaseReferenceCount()
        Start of reference count handling. synchronize on *this* to protect access to the referenceCount (should be mostly uncontended locks).

      • getReferenceCount

        public int getReferenceCount()

      • refCountedClose

        public void refCountedClose()

      • toString

        public String toString()
        End of reference count handling
        Overrides:
        toString in class Object

      • getScopedPuName

        public String getScopedPuName()
        Get the fully application scoped persistence unit name Private api
        Returns:
        scoped pu name

      • equals

        public boolean equals​(Object otherObject)
        Check if this object's UUID is equal to the otherObject's UUID
        Overrides:
        equals in class Object
        Parameters:
        otherObject -
        Returns:

      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class Object