org.apache.dubbo.common.threadpool

Class ThreadlessExecutor

java.lang.Object

java.util.concurrent.AbstractExecutorService

org.apache.dubbo.common.threadpool.ThreadlessExecutor

All Implemented Interfaces:

Executor, ExecutorService

public class ThreadlessExecutor
extends AbstractExecutorService

The most important difference between this Executor and other normal Executor is that this one doesn't manage any thread.

Tasks submitted to this executor through execute(Runnable) will not get scheduled to a specific thread, though normal executors always do the schedule. Those tasks are stored in a blocking queue and will only be executed when a thread calls waitAndDrain(), the thread executing the task is exactly the same as the one calling waitAndDrain.

Constructor Summary

Constructors

Constructor and Description
ThreadlessExecutor(ExecutorService sharedExecutor)

Method Summary

Modifier and Type	Method and Description
boolean	awaitTermination(long timeout, TimeUnit unit)
void	execute(Runnable runnable) If the calling thread is still waiting for a callback task, add the task into the blocking queue to wait for schedule.
CompletableFuture<?>	getWaitingFuture()
boolean	isShutdown()
boolean	isTerminated()
boolean	isWaiting()
void	notifyReturn(Throwable t) tells the thread blocking on waitAndDrain() to return, despite of the current status, to avoid endless waiting.
void	setWaitingFuture(CompletableFuture<?> waitingFuture)
void	shutdown() The following methods are still not supported
List<Runnable>	shutdownNow()
void	waitAndDrain() Waits until there is a task, executes the task and all queued tasks (if there're any).
long	waitAndDrain(long timeout, TimeUnit unit)

Methods inherited from class java.util.concurrent.AbstractExecutorService

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

Methods inherited from class java.lang.Object

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

Constructor Detail

ThreadlessExecutor

public ThreadlessExecutor(ExecutorService sharedExecutor)

Method Detail

getWaitingFuture

public CompletableFuture<?> getWaitingFuture()

setWaitingFuture

public void setWaitingFuture(CompletableFuture<?> waitingFuture)

isWaiting

public boolean isWaiting()

waitAndDrain

public void waitAndDrain()
                  throws InterruptedException

Waits until there is a task, executes the task and all queued tasks (if there're any). The task is either a normal response or a timeout response.

Throws:

InterruptedException

waitAndDrain

public long waitAndDrain(long timeout,
                         TimeUnit unit)
                  throws InterruptedException,
                         TimeoutException

Throws:

InterruptedException

TimeoutException

execute

public void execute(Runnable runnable)

If the calling thread is still waiting for a callback task, add the task into the blocking queue to wait for schedule. Otherwise, submit to shared callback executor directly.

Parameters:

runnable -

notifyReturn

public void notifyReturn(Throwable t)

tells the thread blocking on waitAndDrain() to return, despite of the current status, to avoid endless waiting.

shutdown

public void shutdown()

The following methods are still not supported

shutdownNow

public List<Runnable> shutdownNow()

isShutdown

public boolean isShutdown()

isTerminated

public boolean isTerminated()

awaitTermination

public boolean awaitTermination(long timeout,
                                TimeUnit unit)
                         throws InterruptedException

Throws:

InterruptedException