com.atlassian.jira.event.operation

Interface SpanningOperationRunner

All Known Implementing Classes:

SpanningOperationRunnerImpl

@ExperimentalApi
public interface SpanningOperationRunner

Allows to execute some arbitrary code as a part of larger "spanning" operation.

Since:

7.13

Method Summary

Modifier and Type	Method and Description
void	execute(SpanningOperation spanningOperation, Runnable runnable) Allows marking events generated by passed runnable with passed surroundingOperation Current implementation allows setting spanning operation for current thread only.
<T> T	execute(SpanningOperation spanningOperation, java.util.function.Supplier<T> supplier) Allows marking events generated by passed callable with passed surroundingOperation.
<T> T	executeCallable(SpanningOperation spanningOperation, Callable<T> callable) Allows marking events generated by passed callable with passed surroundingOperation.

Method Detail

execute

<T> T execute(@Nonnull
              SpanningOperation spanningOperation,
              @Nonnull
              java.util.function.Supplier<T> supplier)

Allows marking events generated by passed callable with passed surroundingOperation. Current implementation allows setting spanning operation for current thread only. If some other thread is spawned in the passed callable then spanning operation has to be set up for the newly started thread. Currently only events that implement SpanningOperationEvent are affected by this method.

Type Parameters:

T - Type of returned object

Parameters:

spanningOperation - Operation that spans over passed supplier

supplier - Set of instructions executed in the context of spanning operation

Returns:

value returned by passed supplier

execute

void execute(@Nonnull
             SpanningOperation spanningOperation,
             @Nonnull
             Runnable runnable)

Allows marking events generated by passed runnable with passed surroundingOperation Current implementation allows setting spanning operation for current thread only. If some other thread is spawned in the passed runnable then spanning operation has to be set up for the newly started thread. Currently only events that implement SpanningOperationEvent are affected by this method.

Parameters:

spanningOperation - Operation that spans over passed runnable

runnable -

executeCallable

<T> T executeCallable(@Nonnull
                      SpanningOperation spanningOperation,
                      @Nonnull
                      Callable<T> callable)

Allows marking events generated by passed callable with passed surroundingOperation. Current implementation allows setting spanning operation for current thread only. If some other thread is spawned in the passed callable then spanning operation has to be set up for the newly started thread. Currently only events that implement SpanningOperationEvent are affected by this method. Exceptions thrown by callable are converted to RuntimeException and re-thrown.

Type Parameters:

T - Type of returned object

Parameters:

spanningOperation - Operation that spans over passed callable

callable - Set of instructions executed in the context of spanning operation

Returns:

value returned by passed callable