org.cojen.dirmi.util

Class ThrottledExecutor

java.lang.Object

org.cojen.dirmi.util.ThrottledExecutor

All Implemented Interfaces:

Executor

public class ThrottledExecutor
extends Object
implements Executor

Utility class which can throttle the activity of Asynchronous methods. Without a throttling mechanism, Asynchronous methods can cause too many threads to execute or starve other activities.

Author:

Brian S O'Neill

Constructor Summary

Constructors

Constructor and Description
ThrottledExecutor(int permits, int maxQueued)

Method Summary

Modifier and Type	Method and Description
void	execute(Runnable command) Queues the command for later execution, or executes it immediately.

Methods inherited from class java.lang.Object

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

Constructor Detail

ThrottledExecutor

public ThrottledExecutor(int permits,
                         int maxQueued)

Parameters:

permits - maximum number of threads allowed to execute commands concurrently

maxQueued - maximum number of queued commands allowed before rejecting new ones

Method Detail

execute

public void execute(Runnable command)
             throws RejectedExecutionException

Queues the command for later execution, or executes it immediately. If the queue contains more commands, this method will attempt to drain the queue before returning. If new commands are constantly being enqueued, this method might never return.

Specified by:

execute in interface Executor

Throws:

RejectedExecutionException - if too many commands are queued