Package org.eclipse.jetty.util.thread.strategy

Class ExecuteProduceConsume

java.lang.Object

org.eclipse.jetty.util.thread.strategy.ExecutingExecutionStrategy

org.eclipse.jetty.util.thread.strategy.ExecuteProduceConsume

All Implemented Interfaces:

java.lang.Runnable, ExecutionStrategy

public class ExecuteProduceConsume
extends ExecutingExecutionStrategy
implements ExecutionStrategy, java.lang.Runnable

A strategy where the thread that produces will always run the resulting task.

The strategy may then dispatch another thread to continue production.

The strategy is also known by the nickname 'eat what you kill', which comes from the hunting ethic that says a person should not kill anything he or she does not plan on eating. In this case, the phrase is used to mean that a thread should not produce a task that it does not intend to run. By making producers run the task that they have just produced avoids execution delays and avoids parallel slow down by running the task in the same core, with good chances of having a hot CPU cache. It also avoids the creation of a queue of produced tasks that the system does not yet have capacity to consume, which can save memory and exert back pressure on producers.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ExecuteProduceConsume.Factory

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.thread.ExecutionStrategy

ExecutionStrategy.DefaultExecutionStrategyFactory, ExecutionStrategy.Producer, ExecutionStrategy.Rejectable

Constructor Summary

Constructors

Constructor	Description
ExecuteProduceConsume(ExecutionStrategy.Producer producer, java.util.concurrent.Executor executor)
ExecuteProduceConsume(ExecutionStrategy.Producer producer, java.util.concurrent.Executor executor, ExecutionStrategy lowResourceStrategy)	Deprecated.

Method Summary

Modifier and Type	Method	Description
void	dispatch()	Initiates (or resumes) the task production and execution.
void	execute()	Initiates (or resumes) the task production and execution.
protected void	executeProduct(java.lang.Runnable task)	Only called when in low threads mode to execute the task produced by the producer.
java.lang.Boolean	isIdle()
boolean	isLowOnThreads()
void	run()
java.lang.String	toString()

Methods inherited from class org.eclipse.jetty.util.thread.strategy.ExecutingExecutionStrategy

execute

Methods inherited from class java.lang.Object

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

Constructor Detail

ExecuteProduceConsume

public ExecuteProduceConsume(ExecutionStrategy.Producer producer,
                             java.util.concurrent.Executor executor)

ExecuteProduceConsume

@Deprecated
public ExecuteProduceConsume(ExecutionStrategy.Producer producer,
                             java.util.concurrent.Executor executor,
                             ExecutionStrategy lowResourceStrategy)

Deprecated.

Method Detail

execute

public void execute()

Description copied from interface: ExecutionStrategy

Initiates (or resumes) the task production and execution.

The produced task may be run by the same thread that called this method.

Specified by:

execute in interface ExecutionStrategy

See Also:

ExecutionStrategy.dispatch()

dispatch

public void dispatch()

Description copied from interface: ExecutionStrategy

Initiates (or resumes) the task production and execution.

This method guarantees that the task is never run by the thread that called this method.

Specified by:

dispatch in interface ExecutionStrategy

See Also:

ExecutionStrategy.execute()

run

public void run()

Specified by:

run in interface java.lang.Runnable

isLowOnThreads

public boolean isLowOnThreads()

executeProduct

protected void executeProduct(java.lang.Runnable task)

Only called when in low threads mode to execute the task produced by the producer.

Because

If the task implements ExecutionStrategy.Rejectable, then ExecutionStrategy.Rejectable.reject() is immediately called on the task object. If the task also implements Closeable, then Closeable.close() is called on the task object.

If the task does not implement ExecutionStrategy.Rejectable, then it is executed.

Parameters:

task - the produced task to execute

isIdle

public java.lang.Boolean isIdle()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object