/*
* reserved comment block
* DO NOT REMOVE OR ALTER!
*/
/*
* Copyright 1999-2004 The Apache Software Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/*
* $Id: ObjectPool.java,v 1.2.4.1 2005/09/15 08:15:50 suresh_emailid Exp $
*/
/**
* Pool of object of a given type to pick from to help memory usage
* @xsl.usage internal
*/
{
/** Type of objects in this pool.
* @serial */
/** Stack of given objects this points to.
* @serial */
/**
* Constructor ObjectPool
*
* @param type Type of objects for this pool
*/
{
objectType = type;
}
/**
* Constructor ObjectPool
*
* @param className Fully qualified name of the type of objects for this pool.
*/
{
try
{
}
catch(ClassNotFoundException cnfe)
{
throw new WrappedRuntimeException(cnfe);
}
}
/**
* Constructor ObjectPool
*
*
* @param type Type of objects for this pool
* @param size Size of vector to allocate
*/
{
objectType = type;
}
/**
* Constructor ObjectPool
*
*/
public ObjectPool()
{
objectType = null;
}
/**
* Get an instance of the given object in this pool if available
*
*
* @return an instance of the given object if available or null
*/
{
// Check if the pool is empty.
{
// Remove object from end of free pool.
return result;
}
return null;
}
/**
* Get an instance of the given object in this pool
*
*
* @return An instance of the given object
*/
{
// Check if the pool is empty.
{
// 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(XMLMessages.createXMLMessage(XMLErrorResources.ER_EXCEPTION_CREATING_POOL, null)); //"exception creating new instance for pool");
}
else
{
// Remove object from end of free pool.
return result;
}
}
/**
* Add an instance of the given object to the pool
*
*
* @param obj Object to add.
*/
{
// Make sure the object is of the correct type.
// Remove safety. -sb
// if (objectType.isInstance(obj))
// {
// }
// else
// {
// throw new IllegalArgumentException("argument type invalid for pool");
// }
}
}