/*
* @(#)ObjectPoolManager.java 1.00 2005-5-1
*
* Copyright 2005 BeanSoft Studio. All rights reserved.
* PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
*/
package beansoft.util;
import java.util.HashMap;
import beansoft.util.logging.Logger;
/**
* ObjectPoolManager, dynamic manage pooled objects' create and release.
*
* @author BeanSoft
* @version 1.00 2005-5-1
*/
public final class ObjectPoolManager {
static Logger logger = beansoft.util.logging.Logger.getLogger(ObjectPoolManager.class);
/**
* Holds instances of ObjectPool, the main key is the type of objects in this pool.
*/
private static HashMap objectPools = new HashMap();
/**
* This class is not instanceable.
*/
private ObjectPoolManager() {
}
/**
* Get a ObjectPool instance from the objectPools, if not found, then lazilly
* create a new one.
* @param clazz the object type
* @return the ObjectPool instance
*/
private static synchronized ObjectPool getPool(Class clazz) {
ObjectPool pool = (ObjectPool)objectPools.get(clazz);
if(pool == null) {
pool = new ObjectPool(clazz);
objectPools.put(clazz, pool);
}
return pool;
}
/**
* Get an instance of the given object in the corresponding object pool.
* @param clazz the object type
* @return the instance of the object type
*/
public static synchronized Object getInstance(Class clazz) {
logger.debug("getObject(" + clazz + ")");
return getPool(clazz).getInstance();
}
/**
* Free the instance to the corresponding object pool.
* @param obj the object to be freeed
*/
public static synchronized void freeInstance(Object obj) {
logger.debug("Free object to pool" + obj);
getPool(obj.getClass()).freeInstance(obj);
}
}
package beansoft.util;
import java.util.Vector;
/**
* <meta name="usage" content="internal"/>
* Pool of object of a given type to pick from to help memory usage
*/
public class ObjectPool implements java.io.Serializable
{
/** Type of objects in this pool.
* @serial */
private final Class objectType;
/** Vector of given objects this points to.
* @serial */
private final Vector freeStack;
/**
* Constructor ObjectPool
*
* @param type Type of objects for this pool
*/
public ObjectPool(Class type)
{
objectType = type;
freeStack = new Vector();
}
/**
* Constructor ObjectPool
*
* @param className Fully qualified name of the type of objects for this pool.
*/
public ObjectPool(String className)
{
try
{
objectType = Class.forName(className);
}
catch(ClassNotFoundException cnfe)
{
throw new RuntimeException(cnfe);
}
freeStack = new Vector();
}
/**
* Constructor ObjectPool
*
*
* @param type Type of objects for this pool
* @param size Size of vector to allocate
*/
public ObjectPool(Class type, int size)
{
objectType = type;
freeStack = new Vector(size);
}
/**
* Constructor ObjectPool
*
*/
public ObjectPool()
{
objectType = null;
freeStack = new Vector();
}
/**
* Get an instance of the given object in this pool if available
*
*
* @return an instance of the given object if available or null
*/
public synchronized Object getInstanceIfFree()
{
// Check if the pool is empty.
if (!freeStack.isEmpty())
{
// Remove object from end of free pool.
Object result = freeStack.lastElement();
freeStack.setSize(freeStack.size() - 1);
return result;
}
return null;
}
/**
* Get an instance of the given object in this pool
*
*
* @return An instance of the given object
*/
public synchronized Object getInstance()
{
// Check if the pool is empty.
if (freeStack.isEmpty())
{
// Create a new object if so.
try
{
return objectType.newInstance();
}
catch (InstantiationException ex){}
catch (IllegalAccessException ex){}
// Throw unchecked exception for error in pool configuration.
throw new RuntimeException("exception creating new instance for pool", null); //"exception creating new instance for pool");
}
else
{
// Remove object from end of free pool.
Object result = freeStack.lastElement();
freeStack.setSize(freeStack.size() - 1);
return result;
}
}
/**
* Add an instance of the given object to the pool
*
*
* @param obj Object to add.
*/
public synchronized void freeInstance(Object obj)
{
// Make sure the object is of the correct type.
// Remove safety. -sb
// if (objectType.isInstance(obj))
// {
freeStack.addElement(obj);
// }
// else
// {
// throw new IllegalArgumentException("argument type invalid for pool");
// }
}
}