play.db.jpa

Class DefaultJPAApi

java.lang.Object

play.db.jpa.DefaultJPAApi

All Implemented Interfaces:

JPAApi

public class DefaultJPAApi
extends java.lang.Object
implements JPAApi

Default implementation of the JPA API.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DefaultJPAApi.JPAApiProvider

Constructor Summary

Constructors

Constructor and Description
DefaultJPAApi(JPAConfig jpaConfig)

Method Summary

Modifier and Type	Method and Description
javax.persistence.EntityManager	em(java.lang.String name) Get the EntityManager for the specified persistence unit name.
void	shutdown() Close all entity manager factories.
JPAApi	start() Initialise JPA entity manager factories.
void	withTransaction(java.lang.Runnable block) Run a block of code in a JPA transaction.
<T> T	withTransaction(java.lang.String name, boolean readOnly, java.util.function.Supplier<T> block) Run a block of code in a JPA transaction.
<T> T	withTransaction(java.util.function.Supplier<T> block) Run a block of code in a JPA transaction.
<T> F.Promise<T>	withTransactionAsync(java.lang.String name, boolean readOnly, java.util.function.Supplier<F.Promise<T>> block) Deprecated. This may cause deadlocks
<T> F.Promise<T>	withTransactionAsync(java.util.function.Supplier<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

DefaultJPAApi

public DefaultJPAApi(JPAConfig jpaConfig)

Method Detail

start

public JPAApi start()

Initialise JPA entity manager factories.

Specified by:

start in interface JPAApi

Returns:

JPAApi instance

em

public javax.persistence.EntityManager em(java.lang.String name)

Get the EntityManager for the specified persistence unit name.

Specified by:

em in interface JPAApi

Parameters:

name - The persistence unit name

Returns:

EntityManager for the specified persistence unit name

withTransaction

public <T> T withTransaction(java.util.function.Supplier<T> block)

Run a block of code in a JPA transaction.

Specified by:

withTransaction in interface JPAApi

Type Parameters:

T - type of result

Parameters:

block - Block of code to execute

Returns:

code execution result

withTransactionAsync

@Deprecated
public <T> F.Promise<T> withTransactionAsync(java.util.function.Supplier<F.Promise<T>> block)

Deprecated. This may cause deadlocks

Run a block of asynchronous code in a JPA transaction.

Specified by:

withTransactionAsync in interface JPAApi

Type Parameters:

T - type of result

Parameters:

block - Block of code to execute

Returns:

code execution result

withTransaction

public void withTransaction(java.lang.Runnable block)

Run a block of code in a JPA transaction.

Specified by:

withTransaction in interface JPAApi

Parameters:

block - Block of code to execute

withTransaction

public <T> T withTransaction(java.lang.String name,
                             boolean readOnly,
                             java.util.function.Supplier<T> block)

Run a block of code in a JPA transaction.

Specified by:

withTransaction in interface JPAApi

Type Parameters:

T - type of result

Parameters:

name - The persistence unit name

readOnly - Is the transaction read-only?

block - Block of code to execute

Returns:

code execution result

withTransactionAsync

@Deprecated
public <T> F.Promise<T> withTransactionAsync(java.lang.String name,
                                                         boolean readOnly,
                                                         java.util.function.Supplier<F.Promise<T>> block)

Deprecated. This may cause deadlocks

Run a block of asynchronous code in a JPA transaction.

Specified by:

withTransactionAsync in interface JPAApi

Type Parameters:

T - type of result

Parameters:

name - The persistence unit name

readOnly - Is the transaction read-only?

block - Block of code to execute.

Returns:

code execution result

shutdown

public void shutdown()

Close all entity manager factories.

Specified by:

shutdown in interface JPAApi