Package com.alibaba.ttl.threadpool

Class TtlExecutors

java.lang.Object

com.alibaba.ttl.threadpool.TtlExecutors

public final class TtlExecutors
extends Object

Util methods for TTL wrapper of jdk executors.

1. Factory methods to get TTL wrapper from jdk executors.
2. unwrap/check methods for TTL wrapper of jdk executors.
3. wrap/unwrap/check methods to disable Inheritable for ThreadFactory.

Note:

• all method is null-safe, when input executor parameter is null, return null.
• skip wrap/decoration thread pool/executor(aka. just return input executor) when ttl agent is loaded, Or when input executor is already wrapped/decorated.

Since:

0.9.0

Author:

Jerry Lee (oldratlee at gmail dot com)

See Also:

Executor, ExecutorService, ThreadPoolExecutor, ScheduledThreadPoolExecutor, Executors, CompletionService, ExecutorCompletionService, ThreadFactory, Executors.defaultThreadFactory()

Method Summary

Modifier and Type	Method	Description
static ThreadFactory	getDefaultDisableInheritableThreadFactory()	Wrapper of Executors.defaultThreadFactory(), disable inheritable.
static ThreadFactory	getDisableInheritableThreadFactory(ThreadFactory threadFactory)	Wrapper of ThreadFactory, disable inheritable.
static Executor	getTtlExecutor(Executor executor)	TransmittableThreadLocal Wrapper of Executor, transmit the TransmittableThreadLocal from the task submit time of Runnable to the execution time of Runnable.
static ExecutorService	getTtlExecutorService(ExecutorService executorService)	TransmittableThreadLocal Wrapper of ExecutorService, transmit the TransmittableThreadLocal from the task submit time of Runnable or Callable to the execution time of Runnable or Callable.
static ScheduledExecutorService	getTtlScheduledExecutorService(ScheduledExecutorService scheduledExecutorService)	TransmittableThreadLocal Wrapper of ScheduledExecutorService, transmit the TransmittableThreadLocal from the task submit time of Runnable or Callable to the execution time of Runnable or Callable.
static boolean	isDisableInheritableThreadFactory(ThreadFactory threadFactory)	check the ThreadFactory is DisableInheritableThreadFactory or not.
static <T extends Executor> boolean	isTtlWrapper(T executor)	check the executor is a TTL executor wrapper or not.
static ThreadFactory	unwrap(ThreadFactory threadFactory)	Unwrap DisableInheritableThreadFactory to the original/underneath one.
static <T extends Executor> T	unwrap(T executor)	Unwrap TTL executor wrapper to the original/underneath one.

Methods inherited from class java.lang.Object

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

Method Detail

getTtlExecutor

@Nullable
public static Executor getTtlExecutor(@Nullable
                                      Executor executor)

TransmittableThreadLocal Wrapper of Executor, transmit the TransmittableThreadLocal from the task submit time of Runnable to the execution time of Runnable.

NOTE: sine v2.12.0 the idempotency of return wrapped Executor is changed to true, so the wrapped Executor can be cooperated with the usage of "Decorate Runnable and Callable".

About idempotency: if is idempotent, it's allowed to submit the TtlRunnable/TtlCallable to the wrapped Executor; otherwise throw IllegalStateException.

Parameters:

executor - input Executor

Returns:

wrapped Executor

See Also:

TtlRunnable.get(Runnable, boolean, boolean), TtlCallable.get(Callable, boolean, boolean)

getTtlExecutorService

@Nullable
public static ExecutorService getTtlExecutorService(@Nullable
                                                    ExecutorService executorService)

TransmittableThreadLocal Wrapper of ExecutorService, transmit the TransmittableThreadLocal from the task submit time of Runnable or Callable to the execution time of Runnable or Callable.

NOTE: sine v2.12.0 the idempotency of return wrapped ExecutorService is changed to true, so the wrapped ExecutorService can be cooperated with the usage of "Decorate Runnable and Callable".

About idempotency: if is idempotent, it's allowed to submit the TtlRunnable/TtlCallable to the wrapped ExecutorService; otherwise throw IllegalStateException.

Parameters:

executorService - input ExecutorService

Returns:

wrapped ExecutorService

See Also:

TtlRunnable.get(Runnable, boolean, boolean), TtlCallable.get(Callable, boolean, boolean)

getTtlScheduledExecutorService

@Nullable
public static ScheduledExecutorService getTtlScheduledExecutorService(@Nullable
                                                                      ScheduledExecutorService scheduledExecutorService)

TransmittableThreadLocal Wrapper of ScheduledExecutorService, transmit the TransmittableThreadLocal from the task submit time of Runnable or Callable to the execution time of Runnable or Callable.

NOTE: sine v2.12.0 the idempotency of return wrapped ScheduledExecutorService is changed to true, so the wrapped ScheduledExecutorService can be cooperated with the usage of "Decorate Runnable and Callable".

About idempotency: if is idempotent, it's allowed to submit the TtlRunnable/TtlCallable to the wrapped ScheduledExecutorService; otherwise throw IllegalStateException.

Parameters:

scheduledExecutorService - input scheduledExecutorService

Returns:

wrapped scheduledExecutorService

See Also:

TtlRunnable.get(Runnable, boolean, boolean), TtlCallable.get(Callable, boolean, boolean)

isTtlWrapper

public static <T extends Executor> boolean isTtlWrapper(@Nullable
                                                        T executor)

check the executor is a TTL executor wrapper or not.

if the parameter executor is TTL wrapper, return true, otherwise false.

NOTE: if input executor is null, return false.

Type Parameters:

T - Executor type

Parameters:

executor - input executor

Since:

2.8.0

See Also:

getTtlExecutor(Executor), getTtlExecutorService(ExecutorService), getTtlScheduledExecutorService(ScheduledExecutorService), unwrap(Executor)

unwrap

@Nullable
public static <T extends Executor> T unwrap(@Nullable
                                            T executor)

Unwrap TTL executor wrapper to the original/underneath one.

if the parameter executor is TTL wrapper, return the original/underneath executor; otherwise, just return the input parameter executor.

NOTE: if input executor is null, return null.

Type Parameters:

T - Executor type

Parameters:

executor - input executor

Since:

2.8.0

See Also:

getTtlExecutor(Executor), getTtlExecutorService(ExecutorService), getTtlScheduledExecutorService(ScheduledExecutorService), isTtlWrapper(Executor), TtlUnwrap.unwrap(Object)

getDisableInheritableThreadFactory

@Nullable
public static ThreadFactory getDisableInheritableThreadFactory(@Nullable
                                                               ThreadFactory threadFactory)

Wrapper of ThreadFactory, disable inheritable.

Parameters:

threadFactory - input thread factory

Since:

2.10.0

See Also:

DisableInheritableThreadFactory

getDefaultDisableInheritableThreadFactory

@Nullable
public static ThreadFactory getDefaultDisableInheritableThreadFactory()

Wrapper of Executors.defaultThreadFactory(), disable inheritable.

Since:

2.10.0

See Also:

getDisableInheritableThreadFactory(ThreadFactory)

isDisableInheritableThreadFactory

public static boolean isDisableInheritableThreadFactory(@Nullable
                                                        ThreadFactory threadFactory)

check the ThreadFactory is DisableInheritableThreadFactory or not.

Since:

2.10.0

See Also:

DisableInheritableThreadFactory

unwrap

@Nullable
public static ThreadFactory unwrap(@Nullable
                                   ThreadFactory threadFactory)

Unwrap DisableInheritableThreadFactory to the original/underneath one.

Since:

2.10.0

See Also:

TtlUnwrap.unwrap(Object), DisableInheritableThreadFactory