de.skuzzle.inject.async.internal.runnables

Interface RunnableBuilder

public interface RunnableBuilder

May be used to construct different types of runnables. Those are useful for implementing trigger strategies. For simple strategy implementations it might be useful to only use createRunnableStack(InjectedMethodInvocation, ScheduledContext, ExceptionHandler) for obtaining a runnable that can be scheduled some how.

Since:

0.3.0

Author:

Simon Taddiken

Method Summary

Modifier and Type	Method and Description
LockableRunnable	createLockedRunnableStack(InjectedMethodInvocation invocation, ScheduledContext context, ExceptionHandler handler) Like createRunnableStack(InjectedMethodInvocation, ScheduledContext, ExceptionHandler) but creates a Runnable which must be released before it is able to be executed.
Runnable	createRunnableStack(InjectedMethodInvocation invocation, ScheduledContext context, ExceptionHandler handler) Creates a Runnable for running an execution in the scope of a given context and to handle errors with the given ExceptionHandler.
Runnable	handleException(Runnable wrapped, ExceptionHandler handler) Creates a Runnable that wraps around the given one and which delegates excptions thrown by the inner runnable to the given handler.
Runnable	invoke(InjectedMethodInvocation invocation) Creates a Runnable which will execute the given invocation.
Reschedulable	reschedule(ScheduledContext context, Runnable wrapped, ScheduledExecutorService scheduler, com.cronutils.model.time.ExecutionTime executionTime) Creates a runnable that reschedules itself with the provided scheduler before actually executing the given invocation.
Runnable	scope(Runnable unscoped, ScheduledContext context) Creates a runnable which wraps around another runnable and executes the wrapped instance in the scope of the given ExecutionContext.

Method Detail

createRunnableStack

Runnable createRunnableStack(InjectedMethodInvocation invocation,
                             ScheduledContext context,
                             ExceptionHandler handler)

Creates a Runnable for running an execution in the scope of a given context and to handle errors with the given ExceptionHandler. The result is a stacked Runnable made up of runnables created from the methods from this builder.

Parameters:

invocation - The invocation to execute.

context - The context of the execution.

handler - The error handler.

Returns:

The runnable.

createLockedRunnableStack

LockableRunnable createLockedRunnableStack(InjectedMethodInvocation invocation,
                                           ScheduledContext context,
                                           ExceptionHandler handler)

Like createRunnableStack(InjectedMethodInvocation, ScheduledContext, ExceptionHandler) but creates a Runnable which must be released before it is able to be executed.

Parameters:

invocation - The invocation to execute.

context - The context of the execution.

handler - The error handler.

Returns:

The runnable.

scope

Runnable scope(Runnable unscoped,
               ScheduledContext context)

Creates a runnable which wraps around another runnable and executes the wrapped instance in the scope of the given ExecutionContext. That is, ScheduledContext.beginNewExecution() is called before- and ScheduledContext.finishExecution() is called after the execution.

Parameters:

unscoped - The unscoped runnable.

context - The context in which the unscoped runnable will be executed.

Returns:

The runnable.

invoke

Runnable invoke(InjectedMethodInvocation invocation)

Creates a Runnable which will execute the given invocation.

Parameters:

invocation - The invocation.

Returns:

The runnable.

handleException

Runnable handleException(Runnable wrapped,
                         ExceptionHandler handler)

Creates a Runnable that wraps around the given one and which delegates excptions thrown by the inner runnable to the given handler.

Parameters:

wrapped - The wrapped runnable.

handler - The exception handler.

Returns:

The runnable.

reschedule

Reschedulable reschedule(ScheduledContext context,
                         Runnable wrapped,
                         ScheduledExecutorService scheduler,
                         com.cronutils.model.time.ExecutionTime executionTime)

Creates a runnable that reschedules itself with the provided scheduler before actually executing the given invocation.

Parameters:

context - The context.

wrapped - The actual invocation.

scheduler - The scheduler for rescheduling.

executionTime - For figuring out the delay until the next execution.

Returns:

The runnable.