cn.hippo4j.core.executor

类 ExtensibleThreadPoolExecutor

java.lang.Object

java.util.concurrent.AbstractExecutorService

java.util.concurrent.ThreadPoolExecutor

cn.hippo4j.core.executor.ExtensibleThreadPoolExecutor

所有已实现的接口:

ThreadPoolPluginManager, ThreadPoolPluginSupport, Executor, ExecutorService

直接已知子类:

DynamicThreadPoolExecutor

public class ExtensibleThreadPoolExecutor
extends ThreadPoolExecutor
implements ThreadPoolPluginSupport

Extensible thread-pool executor.
Support the callback extension points provided on the basis of ThreadPoolExecutor. Each extension point corresponds to a different ThreadPoolPlugin interface, users can customize plug-ins and implement one or more ThreadPoolPlugin interface to enable plugins to sense thread pool behavior and provide extended functions.

另请参阅:

ThreadPoolPluginManager, ThreadPoolPlugin

嵌套类概要

从类继承的嵌套类/接口 java.util.concurrent.ThreadPoolExecutor

ThreadPoolExecutor.AbortPolicy, ThreadPoolExecutor.CallerRunsPolicy, ThreadPoolExecutor.DiscardOldestPolicy, ThreadPoolExecutor.DiscardPolicy

构造器概要

构造器

构造器和说明
ExtensibleThreadPoolExecutor(@NonNull String threadPoolId, @NonNull ThreadPoolPluginManager threadPoolPluginManager, int corePoolSize, int maximumPoolSize, long keepAliveTime, TimeUnit unit, @NonNull BlockingQueue<Runnable> workQueue, @NonNull ThreadFactory threadFactory, @NonNull RejectedExecutionHandler handler) Creates a new ExtensibleThreadPoolExecutor with the given initial parameters.

方法概要

限定符和类型	方法和说明
protected void	afterExecute(Runnable runnable, Throwable throwable) After calling the superclass method, ExecuteAwarePlugin.afterExecute(java.lang.Runnable, java.lang.Throwable) will be called last.
protected void	beforeExecute(Thread thread, Runnable runnable) Before calling the parent class method, ExecuteAwarePlugin.beforeExecute(java.lang.Thread, java.lang.Runnable) will be called first.
void	execute(@NonNull Runnable runnable) Before calling the superclass method, TaskAwarePlugin.beforeTaskExecute(java.lang.Runnable) will be called first.
RejectedExecutionHandler	getRejectedExecutionHandler() Returns the current handler for unexecutable tasks.
ThreadPoolExecutor	getThreadPoolExecutor() Get thread-pool executor.
protected <T> RunnableFuture<T>	newTaskFor(Callable<T> callable) Before calling the superclass method, TaskAwarePlugin.beforeTaskCreate(java.util.concurrent.ThreadPoolExecutor, java.lang.Runnable, V) will be called first.
protected <T> RunnableFuture<T>	newTaskFor(Runnable runnable, T value) Before calling the superclass method, TaskAwarePlugin.beforeTaskCreate(java.util.concurrent.ThreadPoolExecutor, java.lang.Runnable, V) will be called first.
void	setRejectedExecutionHandler(@NonNull RejectedExecutionHandler handler) Sets a new handler for unexecutable tasks.
void	shutdown() Before calling the superclass method, ShutdownAwarePlugin.beforeShutdown(java.util.concurrent.ThreadPoolExecutor) will be called first.
List<Runnable>	shutdownNow() Before calling the superclass method, ShutdownAwarePlugin.beforeShutdown(java.util.concurrent.ThreadPoolExecutor) will be called first.
protected void	terminated() Before calling the superclass method, ShutdownAwarePlugin.afterTerminated(cn.hippo4j.core.executor.ExtensibleThreadPoolExecutor) will be called first.

从类继承的方法 java.util.concurrent.ThreadPoolExecutor

allowCoreThreadTimeOut, allowsCoreThreadTimeOut, awaitTermination, finalize, getActiveCount, getCompletedTaskCount, getCorePoolSize, getKeepAliveTime, getLargestPoolSize, getMaximumPoolSize, getPoolSize, getQueue, getTaskCount, getThreadFactory, isShutdown, isTerminated, isTerminating, prestartAllCoreThreads, prestartCoreThread, purge, remove, setCorePoolSize, setKeepAliveTime, setMaximumPoolSize, setThreadFactory, toString

从类继承的方法 java.util.concurrent.AbstractExecutorService

invokeAll, invokeAll, invokeAny, invokeAny, submit, submit, submit

从类继承的方法 java.lang.Object

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

从接口继承的方法 cn.hippo4j.core.plugin.manager.ThreadPoolPluginSupport

clear, getAllPlugins, getExecuteAwarePluginList, getPlugin, getRejectedAwarePluginList, getShutdownAwarePluginList, getTaskAwarePluginList, getThreadPoolId, getThreadPoolPluginManager, isRegistered, register, tryRegister, unregister

从接口继承的方法 cn.hippo4j.core.plugin.manager.ThreadPoolPluginManager

empty, getAllPluginRuntimes, getAllPluginsOfType, getPluginOfType, getRuntime

构造器详细资料

ExtensibleThreadPoolExecutor

public ExtensibleThreadPoolExecutor(@NonNull
                                    @NonNull String threadPoolId,
                                    @NonNull
                                    @NonNull ThreadPoolPluginManager threadPoolPluginManager,
                                    int corePoolSize,
                                    int maximumPoolSize,
                                    long keepAliveTime,
                                    TimeUnit unit,
                                    @NonNull
                                    @NonNull BlockingQueue<Runnable> workQueue,
                                    @NonNull
                                    @NonNull ThreadFactory threadFactory,
                                    @NonNull
                                    @NonNull RejectedExecutionHandler handler)

Creates a new ExtensibleThreadPoolExecutor with the given initial parameters.

参数:

threadPoolId - thread-pool id

threadPoolPluginManager - action aware registry

corePoolSize - the number of threads to keep in the pool, even if they are idle, unless allowCoreThreadTimeOut is set

maximumPoolSize - the maximum number of threads to allow in the pool

keepAliveTime - when the number of threads is greater than the core, this is the maximum time that excess idle threads will wait for new tasks before terminating.

unit - the time unit for the keepAliveTime argument

workQueue - the queue to use for holding tasks before they are executed. This queue will hold only the Runnable tasks submitted by the execute method.

threadFactory - the factory to use when the executor creates a new thread

handler - the handler to use when execution is blocked because the thread bounds and queue capacities are reached

抛出:

IllegalArgumentException - if one of the following holds:
corePoolSize < 0
keepAliveTime < 0
maximumPoolSize <= 0
maximumPoolSize < corePoolSize

NullPointerException - if workQueue or threadFactory or handler is null

方法详细资料

beforeExecute

protected void beforeExecute(Thread thread,
                             Runnable runnable)

Before calling the parent class method, ExecuteAwarePlugin.beforeExecute(java.lang.Thread, java.lang.Runnable) will be called first.

覆盖:

beforeExecute 在类中 ThreadPoolExecutor

参数:

thread - the thread that will run task r

runnable - the task that will be executed

execute

public void execute(@NonNull
                    @NonNull Runnable runnable)

Before calling the superclass method, TaskAwarePlugin.beforeTaskExecute(java.lang.Runnable) will be called first.

指定者:

execute 在接口中 Executor

覆盖:

execute 在类中 ThreadPoolExecutor

参数:

runnable - the task to execute

afterExecute

protected void afterExecute(Runnable runnable,
                            Throwable throwable)

After calling the superclass method, ExecuteAwarePlugin.afterExecute(java.lang.Runnable, java.lang.Throwable) will be called last.

覆盖:

afterExecute 在类中 ThreadPoolExecutor

参数:

runnable - the runnable that has completed

throwable - the exception that caused termination, or null if execution completed normally

shutdown

public void shutdown()

Before calling the superclass method, ShutdownAwarePlugin.beforeShutdown(java.util.concurrent.ThreadPoolExecutor) will be called first. and then will be call ShutdownAwarePlugin.afterShutdown(java.util.concurrent.ThreadPoolExecutor, java.util.List<java.lang.Runnable>)

指定者:

shutdown 在接口中 ExecutorService

覆盖:

shutdown 在类中 ThreadPoolExecutor

抛出:

SecurityException

shutdownNow

public List<Runnable> shutdownNow()

Before calling the superclass method, ShutdownAwarePlugin.beforeShutdown(java.util.concurrent.ThreadPoolExecutor) will be called first. and then will be call ShutdownAwarePlugin.afterShutdown(java.util.concurrent.ThreadPoolExecutor, java.util.List<java.lang.Runnable>)

指定者:

shutdownNow 在接口中 ExecutorService

覆盖:

shutdownNow 在类中 ThreadPoolExecutor

抛出:

SecurityException

terminated

protected void terminated()

Before calling the superclass method, ShutdownAwarePlugin.afterTerminated(cn.hippo4j.core.executor.ExtensibleThreadPoolExecutor) will be called first.

覆盖:

terminated 在类中 ThreadPoolExecutor

newTaskFor

protected <T> RunnableFuture<T> newTaskFor(Runnable runnable,
                                           T value)

Before calling the superclass method, TaskAwarePlugin.beforeTaskCreate(java.util.concurrent.ThreadPoolExecutor, java.lang.Runnable, V) will be called first.

覆盖:

newTaskFor 在类中 AbstractExecutorService

参数:

runnable - the runnable task being wrapped

value - the default value for the returned future

返回:

a RunnableFuture which, when run, will run the underlying runnable and which, as a Future, will yield the given value as its result and provide for cancellation of the underlying task

从以下版本开始:

1.6

newTaskFor

protected <T> RunnableFuture<T> newTaskFor(Callable<T> callable)

Before calling the superclass method, TaskAwarePlugin.beforeTaskCreate(java.util.concurrent.ThreadPoolExecutor, java.lang.Runnable, V) will be called first.

覆盖:

newTaskFor 在类中 AbstractExecutorService

参数:

callable - the callable task being wrapped

返回:

a RunnableFuture which, when run, will call the underlying callable and which, as a Future, will yield the callable's result as its result and provide for cancellation of the underlying task

从以下版本开始:

1.6

setRejectedExecutionHandler

public void setRejectedExecutionHandler(@NonNull
                                        @NonNull RejectedExecutionHandler handler)

Sets a new handler for unexecutable tasks.

覆盖:

setRejectedExecutionHandler 在类中 ThreadPoolExecutor

参数:

handler - the new handler

抛出:

NullPointerException - if handler is null

另请参阅:

getRejectedExecutionHandler()

getRejectedExecutionHandler

public RejectedExecutionHandler getRejectedExecutionHandler()

Returns the current handler for unexecutable tasks.

覆盖:

getRejectedExecutionHandler 在类中 ThreadPoolExecutor

返回:

the current handler

另请参阅:

setRejectedExecutionHandler(RejectedExecutionHandler)

getThreadPoolExecutor

public ThreadPoolExecutor getThreadPoolExecutor()

Get thread-pool executor.

指定者:

getThreadPoolExecutor 在接口中 ThreadPoolPluginSupport

返回:

thread-pool executor