Object ExecutionContext.parasitic

object parasitic extends ExecutionContextExecutor

WARNING: Only ever execute logic which will quickly return control to the caller.

This ExecutionContext steals execution time from other threads by having its Runnables run on the Thread which calls execute and then yielding back control to the caller after *all* its Runnables have been executed. Nested invocations of execute will be trampolined to prevent uncontrolled stack space growth.

When using parasitic with abstractions such as Future it will in many cases be non-deterministic as to which Thread will be executing the logic, as it depends on when/if that Future is completed.

Do *not* call any blocking code in the Runnables submitted to this ExecutionContext as it will prevent progress by other enqueued Runnables and the calling Thread.

Symptoms of misuse of this ExecutionContext include, but are not limited to, deadlocks and severe performance problems.

Any NonFatal or InterruptedExceptions will be reported to the defaultReporter.

Concrete methods

Source

final override def execute(runnable: Runnable): Unit

Runs a block of code on this execution context.

Source

final override def reportFailure(t: Throwable): Unit

Reports that an asynchronous computation failed. See ExecutionContext.reportFailure(throwable: Throwable)

Source

final override def submitForExecution(runnable: Runnable): Unit

MUST throw a NullPointerException when runnable is null When implementing a sync BatchingExecutor, it is RECOMMENDED to implement this method as runnable.run()

Inherited methods

Source

final protected def submitAsyncBatched(runnable: Runnable): Unit

WARNING: Never use both submitAsyncBatched and submitSyncBatched in the same implementation of BatchingExecutor

Source

final protected def submitSyncBatched(runnable: Runnable): Unit

WARNING: Never use both submitAsyncBatched and submitSyncBatched in the same implementation of BatchingExecutor