net.bolbat.kit.orchestrator.impl

Class ExecutionUtils

java.lang.Object

net.bolbat.kit.orchestrator.impl.ExecutionUtils

public final class ExecutionUtils
extends Object

Orchestration utilities.

Author:

Alexandr Bolbat

Method Summary

Modifier and Type	Method and Description
static ExecutorService	create(OrchestrationConfig.ExecutorConfig config, Object... nameFormatArgs) Create ExecutorService.
static Callable<Object>	createCallable(Object impl, Method method, Object[] args) Create Callable.
static <T> T	invoke(Callable<T> callable, int time, TimeUnit timeUnit, ExecutorService executor) Invoke callable on ExecutorService. RejectedExecutionException will be thrown if executor couldn't accept task for execution. TimeoutException will be thrown if maximum time to wait is reached. InterruptedException will be thrown if task execution is interrupted.
static Object	invoke(Object instance, Method method, Object[] args, ExecutionInfo info) Invoke on executor.
static <T> void	invokeAsync(Callable<T> callable, int time, TimeUnit timeUnit, ExecutorService executor) Invoke callable on ExecutorService in 'ASYNC' thread without blocking current thread. All exceptions would be logged with error log level.
static String	methodId(Object obj, Method method) Get unique Method identifier.
static String	objectId(Object obj) Get unique Object identifier.
static void	shutdown(ExecutorService service, boolean terminate, boolean wait, long timeout, TimeUnit unit) Shutdown ExecutorService. ExecutorService.shutdownNow() will be used if: - terminate is false; - wait is true; - timeout is reached.
static void	shutdown(ExecutorService service, boolean wait, long timeout, TimeUnit unit) Shutdown ExecutorService using ExecutorService.shutdown().
static void	terminate(ExecutorService service) Terminate ExecutorService using ExecutorService.shutdownNow().

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

objectId

public static String objectId(Object obj)

Get unique Object identifier.

Parameters:

obj - object instance

Returns:

String

methodId

public static String methodId(Object obj,
                              Method method)

Get unique Method identifier.

Parameters:

obj - object instance

method - object method instance

Returns:

String

createCallable

public static Callable<Object> createCallable(Object impl,
                                              Method method,
                                              Object[] args)

Create Callable.

Parameters:

impl - implementation

method - method

args - method arguments

Returns:

Callable

invoke

public static Object invoke(Object instance,
                            Method method,
                            Object[] args,
                            ExecutionInfo info)
                     throws Exception

Invoke on executor.

Parameters:

method - execution method

args - method arguments

info - ExecutionInfo

Returns:

invocation result

Throws:

Exception

invokeAsync

public static <T> void invokeAsync(Callable<T> callable,
                                   int time,
                                   TimeUnit timeUnit,
                                   ExecutorService executor)

Invoke callable on ExecutorService in 'ASYNC' thread without blocking current thread.
All exceptions would be logged with error log level.

Parameters:

callable - Callable

time - maximum execution time

timeUnit - maximum execution time unit

executor - ExecutorService

invoke

public static <T> T invoke(Callable<T> callable,
                           int time,
                           TimeUnit timeUnit,
                           ExecutorService executor)
                    throws Exception

Invoke callable on ExecutorService.
RejectedExecutionException will be thrown if executor couldn't accept task for execution.
TimeoutException will be thrown if maximum time to wait is reached.
InterruptedException will be thrown if task execution is interrupted.

Parameters:

callable - Callable

time - maximum execution time

timeUnit - maximum execution time unit

executor - ExecutorService

Returns:

Throws:

Exception

create

public static ExecutorService create(OrchestrationConfig.ExecutorConfig config,
                                     Object... nameFormatArgs)

Create ExecutorService.

Parameters:

config - OrchestrationConfig.ExecutorConfig

nameFormatArgs - thread name format arguments

Returns:

ExecutorService

terminate

public static void terminate(ExecutorService service)

Terminate ExecutorService using ExecutorService.shutdownNow().

Parameters:

service - service

shutdown

public static void shutdown(ExecutorService service,
                            boolean wait,
                            long timeout,
                            TimeUnit unit)

Shutdown ExecutorService using ExecutorService.shutdown().

Parameters:

service - service

wait - is need to wait

timeout - waiting timeout

unit - waiting timeout unit

shutdown

public static void shutdown(ExecutorService service,
                            boolean terminate,
                            boolean wait,
                            long timeout,
                            TimeUnit unit)

Shutdown ExecutorService.
ExecutorService.shutdownNow() will be used if:
- terminate is false;
- wait is true;
- timeout is reached.

Parameters:

service - service

terminate - ExecutorService.shutdownNow() will be used instead of ExecutorService.shutdown() and waiting will be skipped

wait - is need to wait

timeout - waiting timeout

unit - waiting timeout unit