play.db.jpa

Class JPA

java.lang.Object

play.db.jpa.JPA

public class JPA
extends java.lang.Object

JPA Helpers.

Constructor Summary

Constructors

Constructor and Description
JPA()

Method Summary

Modifier and Type	Method and Description
static void	bindForAsync(javax.persistence.EntityManager em) Bind an EntityManager to the current HTTP context.
static void	bindForSync(javax.persistence.EntityManager em) Bind an EntityManager to the current HTTP context.
static JPAApi	createFor(java.lang.String unitName) Create a default JPAApi with name "default" and the given unit name.
static JPAApi	createFor(java.lang.String name, java.lang.String unitName) Create a default JPAApi with the given persistence unit configuration.
static javax.persistence.EntityManager	em() Get the default EntityManager for this thread.
static javax.persistence.EntityManager	em(java.lang.String key) Get the EntityManager for specified persistence unit for this thread.
static JPAApi	jpaApi() Get the JPA api for the current play application.
static void	withTransaction(F.Callback0 block) Run a block of code in a JPA transaction.
static <T> T	withTransaction(F.Function0<T> block) Run a block of code in a JPA transaction.
static <T> T	withTransaction(java.lang.String name, boolean readOnly, F.Function0<T> block) Run a block of code in a JPA transaction.
static <T> F.Promise<T>	withTransactionAsync(F.Function0<F.Promise<T>> block) Deprecated. This may cause deadlocks
static <T> F.Promise<T>	withTransactionAsync(java.lang.String name, boolean readOnly, F.Function0<F.Promise<T>> block) Deprecated. This may cause deadlocks

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JPA

public JPA()

Method Detail

createFor

public static JPAApi createFor(java.lang.String name,
                               java.lang.String unitName)

Create a default JPAApi with the given persistence unit configuration. Automatically initialise the JPA entity manager factories.

createFor

public static JPAApi createFor(java.lang.String unitName)

Create a default JPAApi with name "default" and the given unit name. Automatically initialise the JPA entity manager factories.

jpaApi

public static JPAApi jpaApi()

Get the JPA api for the current play application.

em

public static javax.persistence.EntityManager em(java.lang.String key)

Get the EntityManager for specified persistence unit for this thread.

em

public static javax.persistence.EntityManager em()

Get the default EntityManager for this thread.

bindForSync

public static void bindForSync(javax.persistence.EntityManager em)

Bind an EntityManager to the current HTTP context. If no HTTP context is available the EntityManager gets bound to the current thread instead.

bindForAsync

public static void bindForAsync(javax.persistence.EntityManager em)

Bind an EntityManager to the current HTTP context.

Throws:

java.lang.RuntimeException - if no HTTP context is present.

withTransaction

public static <T> T withTransaction(F.Function0<T> block)
                             throws java.lang.Throwable

Run a block of code in a JPA transaction.

Parameters:

block - Block of code to execute.

Throws:

java.lang.Throwable

withTransactionAsync

@Deprecated
public static <T> F.Promise<T> withTransactionAsync(F.Function0<F.Promise<T>> block)
                                                         throws java.lang.Throwable

Deprecated. This may cause deadlocks

Run a block of asynchronous code in a JPA transaction.

Parameters:

block - Block of code to execute.

Throws:

java.lang.Throwable

withTransaction

public static void withTransaction(F.Callback0 block)

Run a block of code in a JPA transaction.

Parameters:

block - Block of code to execute.

withTransaction

public static <T> T withTransaction(java.lang.String name,
                                    boolean readOnly,
                                    F.Function0<T> block)
                             throws java.lang.Throwable

Run a block of code in a JPA transaction.

Parameters:

name - The persistence unit name

readOnly - Is the transaction read-only?

block - Block of code to execute.

Throws:

java.lang.Throwable

withTransactionAsync

@Deprecated
public static <T> F.Promise<T> withTransactionAsync(java.lang.String name,
                                                                boolean readOnly,
                                                                F.Function0<F.Promise<T>> block)
                                                         throws java.lang.Throwable

Deprecated. This may cause deadlocks

Run a block of asynchronous code in a JPA transaction.

Parameters:

name - The persistence unit name

readOnly - Is the transaction read-only?

block - Block of code to execute.

Throws:

java.lang.Throwable