org.eclipse.jetty.util.thread

Class QueuedThreadPool

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.thread.QueuedThreadPool

All Implemented Interfaces:

Executor, Dumpable, LifeCycle, ThreadPool, ThreadPool.SizedThreadPool

@ManagedObject(value="A thread pool")
public class QueuedThreadPool
extends AbstractLifeCycle
implements ThreadPool.SizedThreadPool, Dumpable

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

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

ThreadPool.SizedThreadPool

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Field Summary

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
QueuedThreadPool()
QueuedThreadPool(int maxThreads)
QueuedThreadPool(int maxThreads, int minThreads)
QueuedThreadPool(int maxThreads, int minThreads, int idleTimeout)
QueuedThreadPool(int maxThreads, int minThreads, int idleTimeout, BlockingQueue<Runnable> queue)
QueuedThreadPool(int maxThreads, int minThreads, int idleTimeout, BlockingQueue<Runnable> queue, ThreadGroup threadGroup)

Method Summary

Modifier and Type	Method and Description
protected void	doStart()
protected void	doStop()
String	dump()
void	dump(Appendable out, String indent)
String	dumpThread(long id)
void	execute(Runnable job)
int	getBusyThreads()
int	getIdleThreads()
int	getIdleTimeout() Get the maximum thread idle time.
int	getLowThreadsThreshold()
int	getMaxThreads() Get the maximum number of threads.
int	getMinThreads() Get the minimum number of threads.
String	getName()
protected BlockingQueue<Runnable>	getQueue()
int	getQueueSize() Get the size of the job queue.
int	getThreads()
int	getThreadsPriority() Get the priority of the pool threads.
boolean	interruptThread(long id)
boolean	isDaemon()
boolean	isDetailedDump()
boolean	isLowOnThreads() Returns whether this thread pool is low on threads.
void	join() Blocks until the thread pool is stopped.
protected Thread	newThread(Runnable runnable)
protected void	runJob(Runnable job) Runs the given job in the current thread.
void	setDaemon(boolean daemon) Thread Pool should use Daemon Threading.
void	setDetailedDump(boolean detailedDump)
void	setIdleTimeout(int idleTimeout) Set the maximum thread idle time.
void	setLowThreadsThreshold(int lowThreadsThreshold)
void	setMaxThreads(int maxThreads) Set the maximum number of threads.
void	setMinThreads(int minThreads) Set the minimum number of threads.
void	setName(String name)
void	setQueue(BlockingQueue<Runnable> queue) Deprecated. pass the queue to the constructor instead
void	setThreadsPriority(int priority) Set the priority of the pool threads.
String	toString()

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, setStopTimeout, start, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

QueuedThreadPool

public QueuedThreadPool()

QueuedThreadPool

public QueuedThreadPool(@Name(value="maxThreads")
                        int maxThreads)

QueuedThreadPool

public QueuedThreadPool(@Name(value="maxThreads")
                        int maxThreads,
                        @Name(value="minThreads")
                        int minThreads)

QueuedThreadPool

public QueuedThreadPool(@Name(value="maxThreads")
                        int maxThreads,
                        @Name(value="minThreads")
                        int minThreads,
                        @Name(value="idleTimeout")
                        int idleTimeout)

QueuedThreadPool

public QueuedThreadPool(@Name(value="maxThreads")
                        int maxThreads,
                        @Name(value="minThreads")
                        int minThreads,
                        @Name(value="idleTimeout")
                        int idleTimeout,
                        @Name(value="queue")
                        BlockingQueue<Runnable> queue)

QueuedThreadPool

public QueuedThreadPool(@Name(value="maxThreads")
                        int maxThreads,
                        @Name(value="minThreads")
                        int minThreads,
                        @Name(value="idleTimeout")
                        int idleTimeout,
                        @Name(value="queue")
                        BlockingQueue<Runnable> queue,
                        @Name(value="threadGroup")
                        ThreadGroup threadGroup)

Method Detail

doStart

protected void doStart()
                throws Exception

Overrides:

doStart in class AbstractLifeCycle

Throws:

Exception

doStop

protected void doStop()
               throws Exception

Overrides:

doStop in class AbstractLifeCycle

Throws:

Exception

setDaemon

public void setDaemon(boolean daemon)

Thread Pool should use Daemon Threading.

Parameters:

daemon - true to enable delegation

See Also:

Thread.setDaemon(boolean)

setIdleTimeout

public void setIdleTimeout(int idleTimeout)

Set the maximum thread idle time. Threads that are idle for longer than this period may be stopped. Delegated to the named or anonymous Pool.

Parameters:

idleTimeout - Max idle time in ms.

See Also:

getIdleTimeout()

setMaxThreads

public void setMaxThreads(int maxThreads)

Set the maximum number of threads. Delegated to the named or anonymous Pool.

Specified by:

setMaxThreads in interface ThreadPool.SizedThreadPool

Parameters:

maxThreads - maximum number of threads.

See Also:

getMaxThreads()

setMinThreads

public void setMinThreads(int minThreads)

Set the minimum number of threads. Delegated to the named or anonymous Pool.

Specified by:

setMinThreads in interface ThreadPool.SizedThreadPool

Parameters:

minThreads - minimum number of threads

See Also:

getMinThreads()

setName

public void setName(String name)

Parameters:

name - Name of this thread pool to use when naming threads.

setThreadsPriority

public void setThreadsPriority(int priority)

Set the priority of the pool threads.

Parameters:

priority - the new thread priority.

getIdleTimeout

@ManagedAttribute(value="maximum time a thread may be idle in ms")
public int getIdleTimeout()

Get the maximum thread idle time. Delegated to the named or anonymous Pool.

Returns:

Max idle time in ms.

See Also:

setIdleTimeout(int)

getMaxThreads

@ManagedAttribute(value="maximum number of threads in the pool")
public int getMaxThreads()

Get the maximum number of threads. Delegated to the named or anonymous Pool.

Specified by:

getMaxThreads in interface ThreadPool.SizedThreadPool

Returns:

maximum number of threads.

See Also:

setMaxThreads(int)

getMinThreads

@ManagedAttribute(value="minimum number of threads in the pool")
public int getMinThreads()

Get the minimum number of threads. Delegated to the named or anonymous Pool.

Specified by:

getMinThreads in interface ThreadPool.SizedThreadPool

Returns:

minimum number of threads.

See Also:

setMinThreads(int)

getName

@ManagedAttribute(value="name of the thread pool")
public String getName()

Returns:

The name of the this thread pool

getThreadsPriority

@ManagedAttribute(value="priority of threads in the pool")
public int getThreadsPriority()

Get the priority of the pool threads.

Returns:

the priority of the pool threads.

getQueueSize

@ManagedAttribute(value="size of the job queue")
public int getQueueSize()

Get the size of the job queue.

Returns:

Number of jobs queued waiting for a thread

isDaemon

@ManagedAttribute(value="thread pool uses daemon threads")
public boolean isDaemon()

Returns:

whether this thread pool is using daemon threads

See Also:

Thread.setDaemon(boolean)

isDetailedDump

@ManagedAttribute(value="reports additional details in the dump")
public boolean isDetailedDump()

setDetailedDump

public void setDetailedDump(boolean detailedDump)

getLowThreadsThreshold

@ManagedAttribute(value="threshold at which the pool is low on threads")
public int getLowThreadsThreshold()

setLowThreadsThreshold

public void setLowThreadsThreshold(int lowThreadsThreshold)

execute

public void execute(Runnable job)

Specified by:

execute in interface Executor

join

public void join()
          throws InterruptedException

Blocks until the thread pool is stopped.

Specified by:

join in interface ThreadPool

Throws:

InterruptedException - if thread was interrupted

getThreads

@ManagedAttribute(value="number of threads in the pool")
public int getThreads()

Specified by:

getThreads in interface ThreadPool

Returns:

the total number of threads currently in the pool

getIdleThreads

@ManagedAttribute(value="number of idle threads in the pool")
public int getIdleThreads()

Specified by:

getIdleThreads in interface ThreadPool

Returns:

the number of idle threads in the pool

getBusyThreads

@ManagedAttribute(value="number of busy threads in the pool")
public int getBusyThreads()

Returns:

the number of busy threads in the pool

isLowOnThreads

@ManagedAttribute(value="thread pool is low on threads",
                  readonly=true)
public boolean isLowOnThreads()

Returns whether this thread pool is low on threads.

The current formula is:

 maxThreads - threads + idleThreads - queueSize <= lowThreadsThreshold
 

Specified by:

isLowOnThreads in interface ThreadPool

Returns:

whether the pool is low on threads

See Also:

getLowThreadsThreshold()

newThread

protected Thread newThread(Runnable runnable)

dump

@ManagedOperation(value="dumps thread pool state")
public String dump()

Specified by:

dump in interface Dumpable

dump

public void dump(Appendable out,
                 String indent)
          throws IOException

Specified by:

dump in interface Dumpable

Throws:

IOException

toString

public String toString()

Overrides:

toString in class Object

runJob

protected void runJob(Runnable job)

Runs the given job in the current thread.

Subclasses may override to perform pre/post actions before/after the job is run.

Parameters:

job - the job to run

getQueue

protected BlockingQueue<Runnable> getQueue()

Returns:

the job queue

setQueue

@Deprecated
public void setQueue(BlockingQueue<Runnable> queue)

Deprecated. pass the queue to the constructor instead

Parameters:

queue - the job queue

interruptThread

@ManagedOperation(value="interrupts a pool thread")
public boolean interruptThread(@Name(value="id")
                                                                                   long id)

Parameters:

id - the thread ID to interrupt.

Returns:

true if the thread was found and interrupted.

dumpThread

@ManagedOperation(value="dumps a pool thread stack")
public String dumpThread(@Name(value="id")
                                                                              long id)

Parameters:

id - the thread ID to interrupt.

Returns:

the stack frames dump