io.quarkus.narayana.jta.TransactionRunner Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of quarkus-narayana-jta Show documentation

Offer JTA transaction support (included in Hibernate ORM)

The newest version!

package io.quarkus.narayana.jta;

import java.util.concurrent.Callable;

/**
 * Runs tasks in transactions with pre-defined semantics and options.
 *
 * @see QuarkusTransaction#joiningExisting()
 * @see QuarkusTransaction#requiringNew()
 * @see QuarkusTransaction#disallowingExisting()
 * @see QuarkusTransaction#suspendingExisting()
 * @see QuarkusTransaction#runner(TransactionSemantics)
 * @see TransactionSemantics
 */
public interface TransactionRunner {

    /**
     * Runs the given runnable,
     * starting/suspending transactions as required by the selected {@link TransactionSemantics semantics}.
     *
     * @param task A task to run with the selected transaction semantics.
     */
    void run(Runnable task);

    /**
     * Calls the given callable,
     * starting/suspending transactions as required by the selected {@link TransactionSemantics semantics}.
     * 
     * If the task throws a checked exception it will be wrapped with a {@link QuarkusTransactionException}
     *
     * @param task A task to run with the selected transaction semantics.
     * @return The value returned by {@code task.call()}.
     * @throws QuarkusTransactionException If the task throws a checked exception.
     */
     T call(Callable task);

}