io.mcarle.strix.annotation

Annotation Type Transactional

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

Marks a class or method to be transactional, so it can access an EntityManager from Strix.em().

If annotated on a class, all public methods without NoTransaction and Transactional will relate to the options defined in that annotation. If annotated on a method it will override the Transactional annotation of the class.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
Class<? extends Throwable>[]	noRollbackFor Defines expected exceptions, for which strix will not do a rollback
String	persistenceUnit Defines the persistence unit, i.e. which database connection should be used.
boolean	readOnly Prevent the method from doing updates to the database, i.e. only read allowed
boolean	requiresNew Defines, that the method will create and use its own transaction, i.e. it will create a new transaction whenever the method is called.
int	timeout Defines the time in milliseconds, after which the EntityTransaction will be rollbacked and the EntityManager will be closed.

Element Detail

persistenceUnit

public abstract String persistenceUnit

Defines the persistence unit, i.e. which database connection should be used. If not specified and there only exists one persistence unit, strix will use that unit by default.

Returns:

Name of the persistence unit

Default:

""

readOnly

public abstract boolean readOnly

Prevent the method from doing updates to the database, i.e. only read allowed

Returns:

true, if the transaction should only be readable and not writeable. Otherwise false.

Default:

false

requiresNew

public abstract boolean requiresNew

Defines, that the method will create and use its own transaction, i.e. it will create a new transaction whenever the method is called.

Returns:

true, if a new transaction is required. Otherwise false

Default:

false

timeout

public abstract int timeout

Defines the time in milliseconds, after which the EntityTransaction will be rollbacked and the EntityManager will be closed.

Returns:

Amount of time in milliseconds

Default:

0

noRollbackFor

public abstract Class<? extends Throwable>[] noRollbackFor

Defines expected exceptions, for which strix will not do a rollback

Returns:

List of throwable classes, for which no rollback shall be performed

Default:

{}