de.bb.util

Interface Pool.Factory

Enclosing class:

Pool

public static interface Pool.Factory

Defines the requirements for an object that creates, destroys and validates objects, which are maintained by a Pool.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	create() Create a new object for the Pool.
void	destroy(java.lang.Object o) Destroy the specified object.
boolean	validate(java.lang.Object object) Validates the specified object.
boolean	validateKey(java.lang.Object key) Validates the specified key.

Method Detail

create

java.lang.Object create()
                        throws java.lang.Exception

Create a new object for the Pool.

Returns:

a new object to be maintained by the Pool.

Throws:

java.lang.Exception - an Exception if no object was creatable.

destroy

void destroy(java.lang.Object o)

Destroy the specified object. After this call, the object is no longer user by the Pool.

Parameters:

o - the object to destroy.

validate

boolean validate(java.lang.Object object)

Validates the specified object. Used from Pool.release() and Pool.obtain() to ensure that the object is still usable.

Parameters:

object - the object to validate.

Returns:

true - if object is valid/usable, false either.

validateKey

boolean validateKey(java.lang.Object key)

Validates the specified key. An invalid key will result into release of its associated object. Used from Pool.validate() which destroys objects that are no longer in use, but somehow no release method was called.

Parameters:

key - the key to validate.

Returns:

true - if key is valid/usable, false either.