net.gdface.utils

Class ResourcePool<R>

java.lang.Object

net.gdface.utils.ResourcePool<R>

Type Parameters:

R - 资源类型

Direct Known Subclasses:

ResourcePool.IntResourcePool

public class ResourcePool<R>
extends java.lang.Object

资源池管理对象
apply(),free()用于申请/释放资源,申请的资源对象不可跨线程调用,
通过重写isNestable()方法决定是否允许嵌套调用

Author:

guyadong

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ResourcePool.IntResourcePool 以固定步长生成的一组数字为资源的资源池对象

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.concurrent.LinkedBlockingQueue<R>	queue 资源队列

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ResourcePool()
	ResourcePool(java.util.Collection<R> resources) 构造方法
	ResourcePool(R... resources)

Method Summary

Modifier and Type	Method and Description
R	apply() (阻塞式)申请当前线程使用的资源对象,不可跨线程使用 InterruptedException封装到RuntimeException抛出
R	applyChecked() (阻塞式)申请当前线程使用的资源对象,不可跨线程使用
protected R	close(R resource) 资源对象放回队列时调用,子类可重写此方法
void	free() 释放当前线程占用的资源对象，放回资源队列
protected boolean	isNestable() 是否允许嵌套
protected R	newResource() 创建一个新的资源对象
protected R	open(R resource) 资源从队形从取出时调用,子类可重写此方法

Methods inherited from class java.lang.Object

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

Field Detail

queue

protected final java.util.concurrent.LinkedBlockingQueue<R> queue

资源队列

Constructor Detail

ResourcePool

protected ResourcePool()

ResourcePool

public ResourcePool(java.util.Collection<R> resources)

构造方法

Parameters:

resources - 资源对象集合

Throws:

java.lang.IllegalArgumentException - 包含null元素

ResourcePool

@SafeVarargs
public ResourcePool(R... resources)

Method Detail

applyChecked

public final R applyChecked()
                     throws java.lang.InterruptedException

(阻塞式)申请当前线程使用的资源对象,不可跨线程使用

Returns:

Throws:

java.lang.InterruptedException

apply

public final R apply()

(阻塞式)申请当前线程使用的资源对象,不可跨线程使用
InterruptedException封装到RuntimeException抛出

Returns:

See Also:

applyChecked()

free

public final void free()

释放当前线程占用的资源对象，放回资源队列

isNestable

protected boolean isNestable()

是否允许嵌套

newResource

protected R newResource()

创建一个新的资源对象

Returns:

open

protected R open(R resource)

资源从队形从取出时调用,子类可重写此方法

Parameters:

resource -

Returns:

返回 {@code resource

close

protected R close(R resource)

资源对象放回队列时调用,子类可重写此方法

Parameters:

resource -

Returns:

返回 resource