io.micronaut.spring.tx.annotation

Annotation Type Transactional

Deprecated.

Use Spring's Transactional directly or switch to Micronaut Data's TransactionalAdvice

@Target(value={METHOD,TYPE})
 @Retention(value=RUNTIME)
 @Inherited
 @Documented
 @Around
 @Type(value=TransactionInterceptor.class)
 @Deprecated
public @interface Transactional

Describes transaction attributes on a method or class. This is a variation of Spring's Transactional that uses Micronaut AOP

This annotation type is generally directly comparable to Spring's RuleBasedTransactionAttribute class, and in fact AnnotationTransactionAttributeSource will directly convert the data to the latter class, so that Spring's transaction support code does not have to know about annotations. If no rules are relevant to the exception, it will be treated like DefaultTransactionAttribute (rolling back on RuntimeException and Error but not on checked exceptions).

For specific information about the semantics of this annotation's attributes, consult the TransactionDefinition and TransactionAttribute javadocs.

Since:

1.2

Author:

Colin Sampaleanu, Juergen Hoeller, Sam Brannen

See Also:

TransactionAttribute, DefaultTransactionAttribute, RuleBasedTransactionAttribute

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
org.springframework.transaction.annotation.Isolation	isolation Deprecated. The transaction isolation level.
Class<? extends Throwable>[]	noRollbackFor Deprecated. Defines zero (0) or more exception Classes, which must be subclasses of Throwable, indicating which exception types must not cause a transaction rollback.
String[]	noRollbackForClassName Deprecated. Defines zero (0) or more exception names (for exceptions which must be a subclass of Throwable) indicating which exception types must not cause a transaction rollback.
org.springframework.transaction.annotation.Propagation	propagation Deprecated. The transaction propagation type.
boolean	readOnly Deprecated. true if the transaction is read-only.
Class<? extends Throwable>[]	rollbackFor Deprecated. Defines zero (0) or more exception classes, which must be subclasses of Throwable, indicating which exception types must cause a transaction rollback.
String[]	rollbackForClassName Deprecated. Defines zero (0) or more exception names (for exceptions which must be a subclass of Throwable), indicating which exception types must cause a transaction rollback.
int	timeout Deprecated. The timeout for this transaction.
String	transactionManager Deprecated. A qualifier value for the specified transaction.
String	value Deprecated. Alias for transactionManager().

Element Detail

value

@AliasFor(annotation=org.springframework.transaction.annotation.Transactional.class,
          member="transactionManager")
public abstract String value

Deprecated.

Alias for transactionManager().

Returns:

The transaction manager

See Also:

transactionManager()

Default:

""

transactionManager

@AliasFor(annotation=org.springframework.transaction.annotation.Transactional.class,
          member="value")
public abstract String transactionManager

Deprecated.

A qualifier value for the specified transaction.

May be used to determine the target transaction manager, matching the qualifier value (or the bean name) of a specific PlatformTransactionManager bean definition.

Returns:

The transaction manager

Since:

4.2

See Also:

value()

Default:

""

propagation

@AliasFor(annotation=org.springframework.transaction.annotation.Transactional.class,
          member="propagation")
public abstract org.springframework.transaction.annotation.Propagation propagation

Deprecated.

The transaction propagation type.

Defaults to Propagation.REQUIRED.

Returns:

The propatation

See Also:

TransactionDefinition.getPropagationBehavior()

Default:

org.springframework.transaction.annotation.Propagation.REQUIRED

isolation

@AliasFor(annotation=org.springframework.transaction.annotation.Transactional.class,
          member="isolation")
public abstract org.springframework.transaction.annotation.Isolation isolation

Deprecated.

The transaction isolation level.

Defaults to Isolation.DEFAULT.

Returns:

The isolation level

See Also:

TransactionDefinition.getIsolationLevel()

Default:

org.springframework.transaction.annotation.Isolation.DEFAULT

timeout

@AliasFor(annotation=org.springframework.transaction.annotation.Transactional.class,
          member="timeout")
public abstract int timeout

Deprecated.

The timeout for this transaction.

Defaults to the default timeout of the underlying transaction system.

Returns:

The timeout

See Also:

TransactionDefinition.getTimeout()

Default:

-1

readOnly

@AliasFor(annotation=org.springframework.transaction.annotation.Transactional.class,
          member="readOnly")
public abstract boolean readOnly

Deprecated.

true if the transaction is read-only.

Defaults to false.

This just serves as a hint for the actual transaction subsystem; it will not necessarily cause failure of write access attempts. A transaction manager which cannot interpret the read-only hint will not throw an exception when asked for a read-only transaction but rather silently ignore the hint.

Returns:

Whether is read-only transaction

See Also:

TransactionDefinition.isReadOnly()

Default:

false

rollbackFor

@AliasFor(annotation=org.springframework.transaction.annotation.Transactional.class,
          member="rollbackFor")
public abstract Class<? extends Throwable>[] rollbackFor

Deprecated.

Defines zero (0) or more exception classes, which must be subclasses of Throwable, indicating which exception types must cause a transaction rollback.

By default, a transaction will be rolling back on RuntimeException and Error but not on checked exceptions (business exceptions). See DefaultTransactionAttribute.rollbackOn(Throwable) for a detailed explanation.

This is the preferred way to construct a rollback rule (in contrast to rollbackForClassName()), matching the exception class and its subclasses.

Similar to RollbackRuleAttribute.RollbackRuleAttribute(Class clazz).

Returns:

Rollback for exceptions

See Also:

rollbackForClassName(), DefaultTransactionAttribute.rollbackOn(Throwable)

Default:

{}

rollbackForClassName

@AliasFor(annotation=org.springframework.transaction.annotation.Transactional.class,
          member="rollbackForClassName")
public abstract String[] rollbackForClassName

Deprecated.

Defines zero (0) or more exception names (for exceptions which must be a subclass of Throwable), indicating which exception types must cause a transaction rollback.

This can be a substring of a fully qualified class name, with no wildcard support at present. For example, a value of "ServletException" would match javax.servlet.ServletException and its subclasses.

NB: Consider carefully how specific the pattern is and whether to include package information (which isn't mandatory). For example, "Exception" will match nearly anything and will probably hide other rules. "java.lang.Exception" would be correct if "Exception" were meant to define a rule for all checked exceptions. With more unusual Exception names such as "BaseBusinessException" there is no need to use a FQN.

Similar to RollbackRuleAttribute.RollbackRuleAttribute(String exceptionName).

Returns:

Rollback for classname

See Also:

rollbackFor(), DefaultTransactionAttribute.rollbackOn(Throwable)

Default:

{}

noRollbackFor

@AliasFor(annotation=org.springframework.transaction.annotation.Transactional.class,
          member="rollbackOn")
public abstract Class<? extends Throwable>[] noRollbackFor

Deprecated.

Defines zero (0) or more exception Classes, which must be subclasses of Throwable, indicating which exception types must not cause a transaction rollback.

This is the preferred way to construct a rollback rule (in contrast to noRollbackForClassName()), matching the exception class and its subclasses.

Similar to NoRollbackRuleAttribute.NoRollbackRuleAttribute(Class clazz).

Returns:

Do not rollback for exceptions

See Also:

noRollbackForClassName(), DefaultTransactionAttribute.rollbackOn(Throwable)

Default:

{}

noRollbackForClassName

@AliasFor(annotation=org.springframework.transaction.annotation.Transactional.class,
          member="noRollbackForClassName")
public abstract String[] noRollbackForClassName

Deprecated.

Defines zero (0) or more exception names (for exceptions which must be a subclass of Throwable) indicating which exception types must not cause a transaction rollback.

See the description of rollbackForClassName() for further information on how the specified names are treated.

Similar to NoRollbackRuleAttribute.NoRollbackRuleAttribute(String exceptionName).

Returns:

Do not rollback for class name

See Also:

noRollbackFor(), DefaultTransactionAttribute.rollbackOn(Throwable)

Default:

{}