com.liferay.portal.kernel.transaction

Annotation Type Transactional

@Documented
 @Inherited
 @Retention(value=RUNTIME)
 @Target(value={METHOD,TYPE})
public @interface Transactional

Configures the transaction advice for methods that have this annotation when they're invoked by an com.liferay.portal.spring.aop.AopInvocationHandler.

• All Liferay aspect annotations are aware of their scope.
• Interface aspect annotations can be overwritten by their implementations.
• Class level aspect annotations can be overwritten by method annotations.

Author:

Brian Wing Shun Chan

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
boolean	enabled Whether a transaction is needed.
Isolation	isolation Returns the Isolation setting.
Class<? extends Throwable>[]	noRollbackFor Returns exception classes that should not cause the transaction to be rolled back.
String[]	noRollbackForClassName Returns exception names that should not cause the transaction to be rolled back.
Propagation	propagation Returns the Propagation setting.
boolean	readOnly Whether the the transaction is effectively read-only, allowing for optimizations at run time.
Class<? extends Throwable>[]	rollbackFor Returns exception classes that cause the transaction to be rolled back.
String[]	rollbackForClassName Returns exception names that cause the transaction to be rolled back.
int	timeout Returns the transaction's timeout in seconds.

Element Detail

enabled

public abstract boolean enabled

Whether a transaction is needed. Disabling transactions for a method optimizes run time performance.

Default:

true

isolation

public abstract Isolation isolation

Returns the Isolation setting.

Default:

com.liferay.portal.kernel.transaction.Isolation.DEFAULT

noRollbackFor

public abstract Class<? extends Throwable>[] noRollbackFor

Returns exception classes that should not cause the transaction to be rolled back.

Default:

{}

noRollbackForClassName

public abstract String[] noRollbackForClassName

Returns exception names that should not cause the transaction to be rolled back.

Default:

{}

propagation

public abstract Propagation propagation

Returns the Propagation setting.

Default:

com.liferay.portal.kernel.transaction.Propagation.REQUIRED

readOnly

public abstract boolean readOnly

Whether the the transaction is effectively read-only, allowing for optimizations at run time.

Default:

false

rollbackFor

public abstract Class<? extends Throwable>[] rollbackFor

Returns exception classes that cause the transaction to be rolled back.

Default:

{}

rollbackForClassName

public abstract String[] rollbackForClassName

Returns exception names that cause the transaction to be rolled back.

Default:

{}

timeout

public abstract int timeout

Returns the transaction's timeout in seconds.

Default:

-1