com.firefly.utils.lang.pool

类 BoundedBlockingPool<T>

java.lang.Object

com.firefly.utils.lang.AbstractLifeCycle

com.firefly.utils.lang.pool.BoundedBlockingPool<T>

所有已实现的接口:

LifeCycle, BlockingPool<T>, Pool<T>

public class BoundedBlockingPool<T>
extends AbstractLifeCycle
implements BlockingPool<T>

嵌套类概要

从接口继承的嵌套类/接口 com.firefly.utils.lang.pool.Pool

Pool.Dispose<T>, Pool.Validator<T>

字段概要

从类继承的字段 com.firefly.utils.lang.AbstractLifeCycle

start

构造器概要

构造器

构造器和说明
BoundedBlockingPool(int initSize, BlockingQueue<T> queue, ObjectFactory<T> factory, Pool.Validator<T> validator, Pool.Dispose<T> dispose)
BoundedBlockingPool(int initSize, int maxSize, ObjectFactory<T> factory, Pool.Validator<T> validator, Pool.Dispose<T> dispose)

方法概要

限定符和类型	方法和说明
void	cleanup()
protected void	destroy()
T	get() Returns an instance from the pool.
protected void	init()
void	put(T t) Inserts the specified element into this queue, waiting if necessary for space to become available.
boolean	put(T t, long timeout, TimeUnit unit) Inserts the specified element into this queue, waiting up to the specified wait time if necessary for space to become available.
void	release(T t) Releases the object and puts it back to the pool.
int	size()
T	take() Returns an instance of type T from the pool.
T	take(long time, TimeUnit unit) Returns an instance of type T from the pool, waiting up to the specified wait time if necessary for an object to become available..

从类继承的方法 com.firefly.utils.lang.AbstractLifeCycle

isStarted, isStopped, start, stop

从类继承的方法 java.lang.Object

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

从接口继承的方法 com.firefly.utils.lang.LifeCycle

isStarted, isStopped, start, stop

构造器详细资料

BoundedBlockingPool

public BoundedBlockingPool(int initSize,
                           int maxSize,
                           ObjectFactory<T> factory,
                           Pool.Validator<T> validator,
                           Pool.Dispose<T> dispose)

BoundedBlockingPool

public BoundedBlockingPool(int initSize,
                           BlockingQueue<T> queue,
                           ObjectFactory<T> factory,
                           Pool.Validator<T> validator,
                           Pool.Dispose<T> dispose)

方法详细资料

get

public T get()

从接口复制的说明: Pool

Returns an instance from the pool. The call may be a blocking one or a non-blocking one and that is determined by the internal implementation. If the call is a blocking call, the call returns immediately with a valid object if available, else the thread is made to wait until an object becomes available. In case of a blocking call, it is advised that clients react to InterruptedException which might be thrown when the thread waits for an object to become available. If the call is a non-blocking one, the call returns immediately irrespective of whether an object is available or not. If any object is available the call returns it else the call returns null. The validity of the objects are determined using the Validator interface, such that an object o is valid if Validator.isValid(o) == true

指定者:

get 在接口中 Pool<T>

返回:

T one of the pooled objects.

take

public T take()
       throws InterruptedException

从接口复制的说明: BlockingPool

Returns an instance of type T from the pool. The call is a blocking call, and client threads are made to wait indefinitely until an object is available. The call implements a fairness algorithm that ensures that a FCFS service is implemented. Clients are advised to react to InterruptedException. If the thread is interrupted while waiting for an object to become available, the current implementations sets the interrupted state of the thread to true and returns null. However this is subject to change from implementation to implementation.

指定者:

take 在接口中 BlockingPool<T>

返回:

T an instance of the Object of type T from the pool.

抛出:

InterruptedException

take

public T take(long time,
              TimeUnit unit)
       throws InterruptedException

从接口复制的说明: BlockingPool

Returns an instance of type T from the pool, waiting up to the specified wait time if necessary for an object to become available.. The call is a blocking call, and client threads are made to wait for time until an object is available or until the timeout occurs. The call implements a fairness algorithm that ensures that a FCFS service is implemented. Clients are advised to react to InterruptedException. If the thread is interrupted while waiting for an object to become available, the current implementations set the interrupted state of the thread to true and returns null. However this is subject to change from implementation to implementation.

指定者:

take 在接口中 BlockingPool<T>

参数:

time - amount of time to wait before giving up, in units of unit

unit - a TimeUnit determining how to interpret the timeout parameter

返回:

T an instance of the Object of type T from the pool.

抛出:

InterruptedException - if interrupted while waiting

release

public void release(T t)

从接口复制的说明: Pool

Releases the object and puts it back to the pool. The mechanism of putting the object back to the pool is generally asynchronous, however future implementations might differ.

指定者:

release 在接口中 Pool<T>

参数:

t - the object to return to the pool

put

public void put(T t)
         throws InterruptedException

从接口复制的说明: BlockingPool

Inserts the specified element into this queue, waiting if necessary for space to become available.

指定者:

put 在接口中 BlockingPool<T>

参数:

t - the element to add

抛出:

InterruptedException - if interrupted while waiting

put

public boolean put(T t,
                   long timeout,
                   TimeUnit unit)
            throws InterruptedException

从接口复制的说明: BlockingPool

Inserts the specified element into this queue, waiting up to the specified wait time if necessary for space to become available.

指定者:

put 在接口中 BlockingPool<T>

参数:

t - the element to add

timeout - how long to wait before giving up, in units of unit

unit - a TimeUnit determining how to interpret the timeout parameter

返回:

true if successful, or false if the specified waiting time elapses before space is available

抛出:

InterruptedException - if interrupted while waiting

init

protected void init()

指定者:

init 在类中 AbstractLifeCycle

destroy

protected void destroy()

指定者:

destroy 在类中 AbstractLifeCycle

size

public int size()

指定者:

size 在接口中 Pool<T>

cleanup

public void cleanup()

指定者:

cleanup 在接口中 Pool<T>