Package org.eclipse.jetty.util

Class Pool.Entry

java.lang.Object

org.eclipse.jetty.util.Pool.Entry

Enclosing class:

Pool<T>

public abstract class Pool.Entry
extends Object

A Pool entry that holds metadata and a pooled object.

Constructor Summary

Constructors

Constructor	Description
Entry()

Method Summary

Modifier and Type	Method	Description
boolean	enable(T pooled, boolean acquire)	Enables this, previously reserved, Entry.
T	getPooled()
abstract boolean	isClosed()
abstract boolean	isIdle()
abstract boolean	isInUse()
boolean	isOverUsed()	Deprecated. MaxUsage functionalities will be removed
abstract boolean	isReserved()
boolean	release()	Releases this Entry.
boolean	remove()	Removes this Entry from the Pool.

Methods inherited from class java.lang.Object

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

Constructor Details

Entry

public Entry()

Method Details

enable

public boolean enable(T pooled,
 boolean acquire)

Enables this, previously reserved, Entry.

An entry returned from the Pool.reserve() method must be enabled with this method, once and only once, before it is usable by the pool.

The entry may be enabled and not acquired, in which case it is immediately available to be acquired, potentially by another thread; or it can be enabled and acquired atomically so that no other thread can acquire it, although the acquire may still fail if the pool has been closed.

Parameters:

pooled - the pooled object for this Entry

acquire - whether this Entry should be atomically enabled and acquired

Returns:

whether this Entry was enabled

Throws:

IllegalStateException - if this Entry was already enabled

getPooled

public T getPooled()

Returns:

the pooled object

release

public boolean release()

Releases this Entry.

This is equivalent to calling Pool.release(Pool.Entry) passing this entry.

Returns:

whether this Entry was released

remove

public boolean remove()

Removes this Entry from the Pool.

This is equivalent to calling Pool.remove(Pool.Entry) passing this entry.

Returns:

whether this Entry was removed

isClosed

public abstract boolean isClosed()

Returns:

whether this Entry is closed

isReserved

public abstract boolean isReserved()

Returns:

whether this Entry is reserved

isIdle

public abstract boolean isIdle()

Returns:

whether this Entry is idle

isInUse

public abstract boolean isInUse()

Returns:

whether this entry is in use.

isOverUsed

@Deprecated
public boolean isOverUsed()

Deprecated.

MaxUsage functionalities will be removed

Returns:

whether this entry has been used beyond Pool.getMaxUsageCount()