CompletableCallback (Mule API 1.4.0-20250116 API)

Type Parameters:

T - the generic type of the values that complete the callback
```
public interface CompletableCallback<T>
```
A generic callback for asynchronous processing. The callback is completed normally when the complete(Object) method is invoked, or completed exceptionally when error(Throwable) is used instead. Per each instance, only one of those methods should be called, and they should be called only once.
This interface also provides some utility methods for functional composition of several callbacks.
Support for void processes can be achieved using Void as the generic param <T> and using null when invoking complete(Object)

Since:

1.3.0

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`static <T> CompletableCallback<T>`	`always(Runnable runnable)` Returns a new callback which always executes the given `runnable` upon completion, regardless of said completion being normal or exceptional.
`default CompletableCallback<T>`	`andThen(CompletableCallback<T> afterCallback)` Returns a new composed callback which propagates the completion signal to the given `afterCallback` AFTER `this` callback has finished executing its `complete(Object)` or `error(Throwable)` methods.
`default CompletableCallback<T>`	`andThen(Consumer<T> consumer)` Returns a new composed callback which propagates the normal completion signal to the given `consumer` AFTER `this` callback has finished executing its `complete(Object)` method.
`default CompletableCallback<T>`	`before(CompletableCallback<T> beforeCallback)` Returns a new composed callback which propagates the completion signal to the given `beforeCallback` BEFORE the `complete(Object)` or `error(Throwable)` methods are executed on `this` callback.
`default CompletableCallback<T>`	`before(Consumer<T> consumer)` Returns a new composed callback which propagates the normal completion signal to the given `beforeCallback` BEFORE the `complete(Object)` method is executed on `this` callback.
`void`	`complete(T value)` Invoked when processing completed successfully.
`static <T> CompletableCallback<T>`	`empty()` Returns an empty callback which does nothing
`void`	`error(Throwable e)` This method is invoked when the process fails to execute.
`default CompletableCallback<T>`	`finallyAfter(Runnable runnable)` Returns a new composed callback which always invokes the given `runnable` AFTER `this` callback is completed either normally or exceptionally.
`default CompletableCallback<T>`	`finallyBefore(Runnable runnable)` Returns a new composed callback which always invokes the given `runnable` BEFORE `this` callback is completed either normally or exceptionally.

- Method Detail
  - empty
```
static <T> CompletableCallback<T> empty()
```
    Returns an empty callback which does nothing
    
    Type Parameters:
    
    T - the generic type of the callback
    
    Returns:
    
    an empty callback which does nothing.
  - always
```
static <T> CompletableCallback<T> always(Runnable runnable)
```
    Returns a new callback which always executes the given runnable upon completion, regardless of said completion being normal or exceptional.
    
    Type Parameters:
    
    T - the callback's generic type
    
    Parameters:
    
    runnable - the task to run
    
    Returns:
    
    a new callback
  - complete
```
void complete(T value)
```
    Invoked when processing completed successfully. null is allowed.
    
    Parameters:
    
    value - the processing result
  - error
```
void error(Throwable e)
```
    This method is invoked when the process fails to execute.
    
    Parameters:
    
    e - the exception found
  - andThen
```
default CompletableCallback<T> andThen(Consumer<T> consumer)
```
    Returns a new composed callback which propagates the normal completion signal to the given consumer AFTER this callback has finished executing its complete(Object) method.
    Notice that if this callback throws exceptions, then the consumer will never be invoked
    
    Parameters:
    
    consumer - the consumer to compose
    
    Returns:
    
    a new composed callback
  - andThen
```
default CompletableCallback<T> andThen(CompletableCallback<T> afterCallback)
```
    Returns a new composed callback which propagates the completion signal to the given afterCallback AFTER this callback has finished executing its complete(Object) or error(Throwable) methods.
    Notice that if this callback throws exceptions, then the completion signal will never reach the afterCallback
    
    Parameters:
    
    afterCallback - the callback to compose
    
    Returns:
    
    a new composed callback
  - before
```
default CompletableCallback<T> before(Consumer<T> consumer)
```
    Returns a new composed callback which propagates the normal completion signal to the given beforeCallback BEFORE the complete(Object) method is executed on this callback.
    Notice that if the consumer throws exception, the completion signal will never reach this callback.
    
    Parameters:
    
    consumer - the consumer to compose
    
    Returns:
    
    a new composed callback
  - before
```
default CompletableCallback<T> before(CompletableCallback<T> beforeCallback)
```
    Returns a new composed callback which propagates the completion signal to the given beforeCallback BEFORE the complete(Object) or error(Throwable) methods are executed on this callback.
    Notice that if the beforeCallback throws exception, the completion signal will never reach this callback.
    
    Parameters:
    
    beforeCallback - the callback to compose
    
    Returns:
    
    a new composed callback
  - finallyBefore
```
default CompletableCallback<T> finallyBefore(Runnable runnable)
```
    Returns a new composed callback which always invokes the given runnable BEFORE this callback is completed either normally or exceptionally.
    Notice that if the runnable throws exception, the completion signal will never reach this callback.
    
    Parameters:
    
    runnable - the task to execute upon completion.
    
    Returns:
    
    a new composed callback
  - finallyAfter
```
default CompletableCallback<T> finallyAfter(Runnable runnable)
```
    Returns a new composed callback which always invokes the given runnable AFTER this callback is completed either normally or exceptionally.
    Notice that if this callback throws exception, the runnable will never be invoked.
    
    Parameters:
    
    runnable - the task to execute upon completion.
    
    Returns:
    
    a new composed callback

Interface CompletableCallback<T>

Method Summary

Method Detail

empty

always

complete

error

andThen

andThen

before

before

finallyBefore

finallyAfter