com.avaje.ebean
Class TxScope

java.lang.Object
  com.avaje.ebean.TxScope

public final class TxScope
extends Object

Holds the definition of how a transactional method should run.

This information matches the features of the Transactional annotation. You can use it directly with TxRunnable or TxCallable via Ebean.execute(TxScope, TxCallable) or Ebean.execute(TxScope, TxRunnable).

This object is used internally with the enhancement of a method with Transactional annotation.

See Also:

TxCallable, TxRunnable, Ebean.execute(TxScope, TxCallable), Ebean.execute(TxScope, TxRunnable)

Constructor Summary

TxScope()
Create a REQUIRED transaction scope.

TxScope(TxType type)
Create with a given transaction scope type.

Method Summary

TxIsolation	getIsolation() Return the Isolation level this transaction should run with.
ArrayList<Class<? extends Throwable>>	getNoRollbackFor() Return the throwable's that should NOT cause a rollback.
ArrayList<Class<? extends Throwable>>	getRollbackFor() Return the throwable's that should cause a rollback.
String	getServerName() Return the serverName for this transaction.
TxType	getType() Return the transaction type.
boolean	isReadonly() Return if the transaction should be treated as read only.
static TxScope	mandatory() Helper method to create a TxScope with MANDATORY.
static TxScope	never() Helper method to create a TxScope with NEVER.
static TxScope	notSupported() Helper method to create a TxScope with NOT_SUPPORTED.
static TxScope	required() Helper method to create a TxScope with REQUIRES.
static TxScope	requiresNew() Helper method to create a TxScope with REQUIRES_NEW.
TxScope	setIsolation(TxIsolation isolation) Set the transaction isolation level this transaction should run with.
TxScope	setNoRollbackFor(Class<?>[] noRollbacks) Set multiple throwable's that will NOT cause a rollback.
TxScope	setNoRollbackFor(Class<? extends Throwable> noRollback) Add a Throwable to a list that will NOT cause a rollback.
TxScope	setReadOnly(boolean readOnly) Set if the transaction should be treated as read only.
TxScope	setRollbackFor(Class<?>[] rollbackThrowables) Set multiple throwable's that will cause a rollback.
TxScope	setRollbackFor(Class<? extends Throwable> rollbackThrowable) Set a Throwable that should explicitly cause a rollback.
TxScope	setServerName(String serverName) Set the serverName (DataSource name) for which this transaction will be.
TxScope	setType(TxType type) Set the transaction type.
static TxScope	supports() Helper method to create a TxScope with SUPPORTS.
String	toString() Describes this TxScope instance.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TxScope

public TxScope()

Create a REQUIRED transaction scope.

TxScope

public TxScope(TxType type)

Create with a given transaction scope type.

Method Detail

required

public static TxScope required()

Helper method to create a TxScope with REQUIRES.

requiresNew

public static TxScope requiresNew()

Helper method to create a TxScope with REQUIRES_NEW.

mandatory

public static TxScope mandatory()

Helper method to create a TxScope with MANDATORY.

supports

public static TxScope supports()

Helper method to create a TxScope with SUPPORTS.

notSupported

public static TxScope notSupported()

Helper method to create a TxScope with NOT_SUPPORTED.

never

public static TxScope never()

Helper method to create a TxScope with NEVER.

toString

public String toString()

Describes this TxScope instance.

Overrides:

toString in class Object

getType

public TxType getType()

Return the transaction type.

setType

public TxScope setType(TxType type)

Set the transaction type.

isReadonly

public boolean isReadonly()

Return if the transaction should be treated as read only.

setReadOnly

public TxScope setReadOnly(boolean readOnly)

Set if the transaction should be treated as read only.

getIsolation

public TxIsolation getIsolation()

Return the Isolation level this transaction should run with.

setIsolation

public TxScope setIsolation(TxIsolation isolation)

Set the transaction isolation level this transaction should run with.

getServerName

public String getServerName()

Return the serverName for this transaction. If this is null then the default server (default DataSource) will be used.

setServerName

public TxScope setServerName(String serverName)

Set the serverName (DataSource name) for which this transaction will be. If the serverName is not specified (left null) then the default server will be used.

getRollbackFor

public ArrayList<Class<? extends Throwable>> getRollbackFor()

Return the throwable's that should cause a rollback.

setRollbackFor

public TxScope setRollbackFor(Class<? extends Throwable> rollbackThrowable)

Set a Throwable that should explicitly cause a rollback.

setRollbackFor

public TxScope setRollbackFor(Class<?>[] rollbackThrowables)

Set multiple throwable's that will cause a rollback.

getNoRollbackFor

public ArrayList<Class<? extends Throwable>> getNoRollbackFor()

Return the throwable's that should NOT cause a rollback.

setNoRollbackFor

public TxScope setNoRollbackFor(Class<? extends Throwable> noRollback)

Add a Throwable to a list that will NOT cause a rollback. You are able to call this method multiple times with different throwable's and they will added to a list.

setNoRollbackFor

public TxScope setNoRollbackFor(Class<?>[] noRollbacks)

Set multiple throwable's that will NOT cause a rollback.