79

In the persistence.xml JPA configuration file, you can have a line like:

<persistence-unit name="com.nz_war_1.0-SNAPSHOTPU" transaction-type="JTA">

or sometimes:

<persistence-unit name="com.nz_war_1.0-SNAPSHOTPU" transaction-type=”RESOURCE_LOCAL”>

My question is:

What is the difference between transaction-type="JTA" and transaction-type=”RESOURCE_LOCAL” ?

I also noticed some persistence.xml files with the transaction-type missing. Is it correct?

1 Answer 1

129

Defaults

Default to JTA in a JavaEE environment and to RESOURCE_LOCAL in a JavaSE environment.

RESOURCE_LOCAL

With <persistence-unit transaction-type="RESOURCE_LOCAL"> you are responsible for EntityManager (PersistenceContext/Cache) creating and tracking

  • You must use the EntityManagerFactory to get an EntityManager
  • The resulting EntityManager instance is a PersistenceContext/Cache An EntityManagerFactory can be injected via the @PersistenceUnit annotation only (not @PersistenceContext)
  • You are not allowed to use @PersistenceContext to refer to a unit of type RESOURCE_LOCAL
  • You must use the EntityTransaction API to begin/commit around every call to your EntityManger
  • Calling entityManagerFactory.createEntityManager() twice results in two separate EntityManager instances and therefor two separate PersistenceContexts/Caches.
  • It is almost never a good idea to have more than one instance of an EntityManager in use (don't create a second one unless you've destroyed the first)

JTA

With <persistence-unit transaction-type="JTA"> the container will do EntityManager (PersistenceContext/Cache) creating and tracking.

  • You cannot use the EntityManagerFactory to get an EntityManager
  • You can only get an EntityManager supplied by the container
  • An EntityManager can be injected via the @PersistenceContext annotation only (not @PersistenceUnit)
  • You are not allowed to use @PersistenceUnit to refer to a unit of type JTA
  • The EntityManager given by the container is a reference to the PersistenceContext/Cache associated with a JTA Transaction.
  • If no JTA transaction is in progress, the EntityManager cannot be used because there is no PersistenceContext/Cache.
  • Everyone with an EntityManager reference to the same unit in the same transaction will automatically have a reference to the same PersistenceContext/Cache
  • The PersistenceContext/Cache is flushed and cleared at JTA commit time
10
  • 1
    and clearly you can use JTA in a JavaSE environment too, and get the EM yourself from the EMF ... such as when using a stand-alone JTA provider. Perhaps your lists refer to JavaSE and JavaEE as opposed to JTA and RESOURCE_LOCAL Commented Jun 27, 2013 at 8:17
  • 5
    "It is almost never a good idea to have more than one instance of an EntityManager in use" -- Is this your opinion? It's often necessary to have multiple open EntityManagers open in a concurrent application. In general, a very good answer.
    – Samuel
    Commented Aug 1, 2014 at 15:29
  • 1
    I used RESOURCE_LOCAL without having the need to begin and end transactions myself. I think RESOURCE_LOCAL is more like "I wan to test this database using local test memory" which is very helpful for JUnit testing.
    – ha9u63a7
    Commented Jan 22, 2015 at 1:16
  • 2
    I don't agree with statement that "You are not allowed to use @PersistenceUnit to refer to a unit of type JTA". I think that you can easily do so and you can use method emf.createEntityManager() to get entity manager. And you can use the argument of type SynchronizationType to define if current transaction should be joined immediately or you will join it yourself when calling em.joinTransaction() method
    – chalda
    Commented Mar 5, 2015 at 16:24
  • 4
    You may take a look at the source of the answer with addtional informations and short example: tomee.apache.org/jpa-concepts.html
    – Radium
    Commented Apr 27, 2016 at 13:26

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.