jvanzyl 02/01/14 21:02:54
Added: src/java/org/apache/stratum/factory
DefaultFactoryManager.java Factory.java
FactoryManager.java
ObjectInputStreamForContext.java
Log:
- factory package taken from illka's original code
Revision Changes Path
1.1
jakarta-turbine-stratum/src/java/org/apache/stratum/factory/DefaultFactoryManager.java
Index: DefaultFactoryManager.java
===================================================================
package org.apache.stratum.factory;
/* ====================================================================
* The Apache Software License, Version 1.1
*
* Copyright (c) 2001 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The end-user documentation included with the redistribution,
* if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
*
* 4. The names "Apache" and "Apache Software Foundation" and
* "Apache Turbine" must not be used to endorse or promote products
* derived from this software without prior written permission. For
* written permission, please contact [EMAIL PROTECTED]
*
* 5. Products derived from this software may not be called "Apache",
* "Apache Turbine", nor may "Apache" appear in their name, without
* prior written permission of the Apache Software Foundation.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation. For more
* information on the Apache Software Foundation, please see
* <http://www.apache.org/>.
*/
import java.util.Map;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Vector;
import java.util.ArrayList;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.ObjectOutputStream;
import org.apache.stratum.exception.NestableException;
import org.apache.stratum.component.AbstractComponent;
import org.apache.stratum.factory.Factory;
import org.apache.stratum.factory.FactoryManager;
/**
* The Factory Service instantiates objects using specified
* class loaders. If none is specified, the default one
* will be used.
*
* @author <a href="mailto:[EMAIL PROTECTED]";>Ilkka Priha</a>
* @author <a href="mailto:[EMAIL PROTECTED]";>Jason van Zyl</a>
* @version $Id: DefaultFactoryManager.java,v 1.1 2002/01/15 05:02:54 jvanzyl Exp $
*/
public class DefaultFactoryManager
extends AbstractComponent
implements FactoryManager
{
/**
* The property specifying a set of additional class loaders.
*/
public static final String CLASS_LOADERS = "class.loaders";
/**
* The property prefix specifying additional object factories.
*/
public static final String OBJECT_FACTORY = "factory.";
/**
* Primitive classes for reflection of constructors.
*/
private static HashMap primitiveClasses;
{
primitiveClasses = new HashMap(8);
primitiveClasses.put(Boolean.TYPE.toString(),Boolean.TYPE);
primitiveClasses.put(Character.TYPE.toString(),Character.TYPE);
primitiveClasses.put(Byte.TYPE.toString(),Byte.TYPE);
primitiveClasses.put(Short.TYPE.toString(),Short.TYPE);
primitiveClasses.put(Integer.TYPE.toString(),Integer.TYPE);
primitiveClasses.put(Long.TYPE.toString(),Long.TYPE);
primitiveClasses.put(Float.TYPE.toString(),Float.TYPE);
primitiveClasses.put(Double.TYPE.toString(),Double.TYPE);
}
/**
* Additional class loaders.
*/
private ArrayList classLoaders = new ArrayList();
/**
* Customized object factories.
*/
private HashMap objectFactories = new HashMap();
/**
* Gets the class of a primitive type.
*
* @param type a primitive type.
* @return the corresponding class, or null.
*/
protected static Class getPrimitiveClass(String type)
{
return (Class) primitiveClasses.get(type);
}
/**
* Constructs a Factory Service.
*/
public DefaultFactoryManager()
{
}
/**
* Initializes the service by loading default class loaders
* and customized object factories.
*
* @throws NestableException if initialization fails.
*/
public void initialize()
throws NestableException
{
// The only things that are configurable are classloaders
// that may be used. Need to figure out the in container use
// versus out of container use.
if (isConfigured())
{
Vector loaders = getConfiguration().getVector(CLASS_LOADERS);
if (loaders != null)
{
for (int i = 0; i < loaders.size(); i++)
{
try
{
classLoaders.add(
loadClass((String) loaders.get(i)).newInstance());
}
catch (Exception x)
{
throw new NestableException(
"No such class loader '" +
(String) loaders.get(i) +
"' for TurbinbeFactoryService",x);
}
}
}
String key,factory;
for (Iterator i = getConfiguration().getKeys(OBJECT_FACTORY);
i.hasNext();)
{
key = (String) i.next();
factory = getConfiguration().getString(key);
// Store the factory to the table as a string and
// instantiate it by using the service when needed.
objectFactories.put(
key.substring(OBJECT_FACTORY.length()),factory);
}
}
}
/**
* Gets an instance of a named class.
*
* @param className the name of the class.
* @return the instance.
* @throws NestableException if instantiation fails.
*/
public Object getInstance(String className)
throws NestableException
{
if (className == null)
{
throw new NestableException(
new NullPointerException("String className"));
}
Factory factory = getFactory(className);
if (factory == null)
{
Class clazz;
try
{
clazz = loadClass(className);
}
catch (ClassNotFoundException x)
{
throw new NestableException(
"Instantiation failed for class " + className,x);
}
return getInstance(clazz);
}
else
{
return factory.getInstance();
}
}
/**
* Gets an instance of a named class using a specified class loader.
*
* <p>Class loaders are supported only if the isLoaderSupported
* method returns true. Otherwise the loader parameter is ignored.
*
* @param className the name of the class.
* @param loader the class loader.
* @return the instance.
* @throws NestableException if instantiation fails.
*/
public Object getInstance(String className,
ClassLoader loader)
throws NestableException
{
if (className == null)
{
throw new NestableException(
new NullPointerException("String className"));
}
Factory factory = getFactory(className);
if (factory == null)
{
if (loader != null)
{
Class clazz;
try
{
clazz = loadClass(className,loader);
}
catch (ClassNotFoundException x)
{
throw new NestableException(
"Instantiation failed for class " + className,x);
}
return getInstance(clazz);
}
else
{
return getInstance(className);
}
}
else
{
return factory.getInstance(loader);
}
}
/**
* Gets an instance of a named class.
* Parameters for its constructor are given as an array of objects,
* primitive types must be wrapped with a corresponding class.
*
* @param className the name of the class.
* @param params an array containing the parameters of the constructor.
* @param signature an array containing the signature of the constructor.
* @return the instance.
* @throws NestableException if instantiation fails.
*/
public Object getInstance(String className,
Object[] params,
String[] signature)
throws NestableException
{
if (className == null)
{
throw new NestableException(
new NullPointerException("String className"));
}
Factory factory = getFactory(className);
if (factory == null)
{
Class clazz;
try
{
clazz = loadClass(className);
}
catch (ClassNotFoundException x)
{
throw new NestableException(
"Instantiation failed for class " + className,x);
}
return getInstance(clazz,params,signature);
}
else
{
return factory.getInstance(params,signature);
}
}
/**
* Gets an instance of a named class using a specified class loader.
* Parameters for its constructor are given as an array of objects,
* primitive types must be wrapped with a corresponding class.
*
* <p>Class loaders are supported only if the isLoaderSupported
* method returns true. Otherwise the loader parameter is ignored.
*
* @param className the name of the class.
* @param loader the class loader.
* @param params an array containing the parameters of the constructor.
* @param signature an array containing the signature of the constructor.
* @return the instance.
* @throws NestableException if instantiation fails.
*/
public Object getInstance(String className,
ClassLoader loader,
Object[] params,
String[] signature)
throws NestableException
{
if (className == null)
{
throw new NestableException(
new NullPointerException("String className"));
}
Factory factory = getFactory(className);
if (factory == null)
{
if (loader != null)
{
Class clazz;
try
{
clazz = loadClass(className,loader);
}
catch (ClassNotFoundException x)
{
throw new NestableException(
"Instantiation failed for class " + className,x);
}
return getInstance(clazz,params,signature);
}
else
{
return getInstance(className,params,signature);
}
}
else
{
return factory.getInstance(loader,params,signature);
}
}
/**
* Tests if specified class loaders are supported for a named class.
*
* @param className the name of the class.
* @return true if class loaders are supported, false otherwise.
* @throws NestableException if test fails.
*/
public boolean isLoaderSupported(String className)
throws NestableException
{
Factory factory = getFactory(className);
return factory != null ?
factory.isLoaderSupported() : true;
}
/**
* Gets an instance of a specified class.
*
* @param clazz the class.
* @return the instance.
* @throws NestableException if instantiation fails.
*/
protected Object getInstance(Class clazz)
throws NestableException
{
try
{
return clazz.newInstance();
}
catch (Exception x)
{
throw new NestableException(
"Instantiation failed for " + clazz.getName(),x);
}
}
/**
* Gets an instance of a specified class.
* Parameters for its constructor are given as an array of objects,
* primitive types must be wrapped with a corresponding class.
*
* @param clazz the class.
* @param params an array containing the parameters of the constructor.
* @param signature an array containing the signature of the constructor.
* @return the instance.
* @throws NestableException if instantiation fails.
*/
protected Object getInstance(Class clazz,
Object params[],
String signature[])
throws NestableException
{
/* Try to construct. */
try
{
Class[] sign = getSignature(clazz,params,signature);
return clazz.getConstructor(sign).newInstance(params);
}
catch (Exception x)
{
throw new NestableException(
"Instantiation failed for " + clazz.getName(),x);
}
}
/**
* Gets the signature classes for parameters of a method of a class.
*
* @param clazz the class.
* @param params an array containing the parameters of the method.
* @param signature an array containing the signature of the method.
* @return an array of signature classes. Note that in some cases
* objects in the parameter array can be switched to the context
* of a different class loader.
* @throws ClassNotFoundException if any of the classes is not found.
*/
protected Class[] getSignature(Class clazz,
Object params[],
String signature[])
throws ClassNotFoundException
{
if (signature != null)
{
// We have parameters.
ClassLoader tempLoader;
ClassLoader loader = clazz.getClassLoader();
Class[] sign = new Class[signature.length];
for (int i= 0; i < signature.length; i++)
{
// Check primitive types.
sign[i] = getPrimitiveClass(signature[i]);
if (sign[i] == null)
{
// Not a primitive one, continue building.
if (loader != null)
{
// Use the class loader of the target object.
sign[i] = loader.loadClass(signature[i]);
tempLoader = sign[i].getClassLoader();
if ((params[i] != null) &&
(tempLoader != null) &&
!tempLoader.equals(params[i].getClass().getClassLoader()))
{
// The class uses a different class loader,
// switch the parameter.
params[i] = switchObjectContext(params[i],loader);
}
}
else
{
// Use the default class loader.
sign[i] = loadClass(signature[i]);
}
}
}
return sign;
}
else
{
return null;
}
}
/**
* Switches an object into the context of a different class loader.
*
* @param object an object to switch.
* @param loader the loader of the new context.
*/
protected Object switchObjectContext(Object object,
ClassLoader loader)
{
ByteArrayOutputStream bout =
new ByteArrayOutputStream();
try
{
ObjectOutputStream out =
new ObjectOutputStream(bout);
out.writeObject(object);
out.flush();
}
catch (Exception x)
{
return object;
}
try
{
ByteArrayInputStream bin =
new ByteArrayInputStream(bout.toByteArray());
ObjectInputStreamForContext in =
new ObjectInputStreamForContext(bin,loader);
return in.readObject();
}
catch (Exception x)
{
return object;
}
}
/**
* Loads the named class using the default class loader.
*
* @param className the name of the class to load.
* @return the loaded class.
* @throws ClassNotFoundException if the class was not found.
*/
protected Class loadClass(String className)
throws ClassNotFoundException
{
ClassLoader loader = this.getClass().getClassLoader();
try
{
return loader != null ?
loader.loadClass(className) : Class.forName(className);
}
catch (ClassNotFoundException x)
{
// Go through additional loaders.
for (Iterator i = classLoaders.iterator(); i.hasNext();)
{
try
{
return ((ClassLoader) i.next()).loadClass(className);
}
catch (ClassNotFoundException xx) { }
}
// Give up.
throw x;
}
}
/**
* Loads the named class using a specified class loader.
*
* @param className the name of the class to load.
* @param loader the loader to use.
* @return the loaded class.
* @throws ClassNotFoundException if the class was not found.
*/
protected Class loadClass(String className,
ClassLoader loader)
throws ClassNotFoundException
{
return loader != null ?
loader.loadClass(className) : loadClass(className);
}
/**
* Gets a customized factory for a named class.
*
* @param className the name of the class to load.
* @return the factory or null if not specified.
* @throws NestableException if instantiation of the factory fails.
*/
protected Factory getFactory(String className)
throws NestableException
{
HashMap factories = objectFactories;
Object factory = factories.get(className);
if (factory != null)
{
if (factory instanceof String)
{
// Not yet instantiated...
try
{
factory = (Factory) getInstance((String) factory);
((Factory) factory).initialize(className);
}
catch (ClassCastException x)
{
throw new NestableException(
"Incorrect factory " + (String) factory +
" for class " + className,x);
}
catch (Exception x)
{
throw new NestableException(x);
}
// was here had to move up
//catch (ClassCastException x)
//{
// throw new NestableException(
// "Incorrect factory " + (String) factory +
// " for class " + className,x);
//}
factories = (HashMap) factories.clone();
factories.put(className,factory);
objectFactories = factories;
}
return (Factory) factory;
}
else
{
return null;
}
}
}
1.1
jakarta-turbine-stratum/src/java/org/apache/stratum/factory/Factory.java
Index: Factory.java
===================================================================
package org.apache.stratum.factory;
/* ====================================================================
* The Apache Software License, Version 1.1
*
* Copyright (c) 2001 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The end-user documentation included with the redistribution,
* if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
*
* 4. The names "Apache" and "Apache Software Foundation" and
* "Apache Turbine" must not be used to endorse or promote products
* derived from this software without prior written permission. For
* written permission, please contact [EMAIL PROTECTED]
*
* 5. Products derived from this software may not be called "Apache",
* "Apache Turbine", nor may "Apache" appear in their name, without
* prior written permission of the Apache Software Foundation.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation. For more
* information on the Apache Software Foundation, please see
* <http://www.apache.org/>.
*/
import org.apache.stratum.exception.NestableException;
/**
* Factory is an interface for object factories. Object factories
* can be registered with the Factory Service to support customized
* functionality during instantiation of specific classes that
* the service itself cannot provide. Examples include
* instantiation of XML parsers and secure sockets requiring
* provider specific initializations before instantiation.
*
* @author <a href="mailto:[EMAIL PROTECTED]";>Ilkka Priha</a>
* @author <a href="[EMAIL PROTECTED]">Jason van Zyl</a>
* @version $Id: Factory.java,v 1.1 2002/01/15 05:02:54 jvanzyl Exp $
*/
public interface Factory
{
/**
* Initializes the factory. This method is called by
* the Factory Service before the factory is used.
*
* @param className the name of the production class
* @throws Exception if initialization fails.
*/
void initialize(String className)
throws NestableException;
/**
* Gets an instance of a class.
*
* @return the instance.
* @throwsNestableException if instantiation fails.
*/
Object getInstance()
throws NestableException;
/**
* Gets an instance of a class using a specified class loader.
*
* <p>Class loaders are supported only if the isLoaderSupported
* method returns true. Otherwise the loader parameter is ignored.
*
* @param loader the class loader.
* @return the instance.
* @throwsNestableException if instantiation fails.
*/
Object getInstance(ClassLoader loader)
throws NestableException;
/**
* Gets an instance of a named class.
* Parameters for its constructor are given as an array of objects,
* primitive types must be wrapped with a corresponding class.
*
* @param params an array containing the parameters of the constructor.
* @param signature an array containing the signature of the constructor.
* @return the instance.
* @throwsNestableException if instantiation fails.
*/
Object getInstance(Object[] params, String[] signature)
throws NestableException;
/**
* Gets an instance of a named class using a specified class loader.
* Parameters for its constructor are given as an array of objects,
* primitive types must be wrapped with a corresponding class.
*
* <p>Class loaders are supported only if the isLoaderSupported
* method returns true. Otherwise the loader parameter is ignored.
*
* @param loader the class loader.
* @param params an array containing the parameters of the constructor.
* @param signature an array containing the signature of the constructor.
* @return the instance.
* @throwsNestableException if instantiation fails.
*/
Object getInstance(ClassLoader loader,
Object[] params,
String[] signature)
throws NestableException;
/**
* Tests if this object factory supports specified class loaders.
*
* @return true if class loaders are supported, false otherwise.
*/
boolean isLoaderSupported();
}
1.1
jakarta-turbine-stratum/src/java/org/apache/stratum/factory/FactoryManager.java
Index: FactoryManager.java
===================================================================
package org.apache.stratum.factory;
/* ====================================================================
* The Apache Software License, Version 1.1
*
* Copyright (c) 2001 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The end-user documentation included with the redistribution,
* if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
*
* 4. The names "Apache" and "Apache Software Foundation" and
* "Apache Turbine" must not be used to endorse or promote products
* derived from this software without prior written permission. For
* written permission, please contact [EMAIL PROTECTED]
*
* 5. Products derived from this software may not be called "Apache",
* "Apache Turbine", nor may "Apache" appear in their name, without
* prior written permission of the Apache Software Foundation.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation. For more
* information on the Apache Software Foundation, please see
* <http://www.apache.org/>.
*/
import org.apache.stratum.exception.NestableException;
/**
* The Factory Service instantiates objects using either default
* class loaders or a specified one. Whether specified class
* loaders are supported for a class depends on implementation
* and can be tested with the isLoaderSupported method.
*
* @author <a href="mailto:[EMAIL PROTECTED]";>Ilkka Priha</a>
* @author <a href="mailto:[EMAIL PROTECTED]";>Jason van Zyl</a>
* @version $Id: FactoryManager.java,v 1.1 2002/01/15 05:02:54 jvanzyl Exp $
*/
public interface FactoryManager
{
/**
* Gets an instance of a named class.
*
* @param className the name of the class.
* @return the instance.
* @throws NestableException if instantiation fails.
*/
Object getInstance(String className)
throws NestableException;
/**
* Gets an instance of a named class using a specified class loader.
*
* <p>Class loaders are supported only if the isLoaderSupported
* method returns true. Otherwise the loader parameter is ignored.
*
* @param className the name of the class.
* @param loader the class loader.
* @return the instance.
* @throws NestableException if instantiation fails.
*/
Object getInstance(String className, ClassLoader loader)
throws NestableException;
/**
* Gets an instance of a named class.
* Parameters for its constructor are given as an array of objects,
* primitive types must be wrapped with a corresponding class.
*
* @param className the name of the class.
* @param params an array containing the parameters of the constructor.
* @param signature an array containing the signature of the constructor.
* @return the instance.
* @throws NestableException if instantiation fails.
*/
Object getInstance(String className,
Object[] params,
String[] signature)
throws NestableException;
/**
* Gets an instance of a named class using a specified class loader.
* Parameters for its constructor are given as an array of objects,
* primitive types must be wrapped with a corresponding class.
*
* <p>Class loaders are supported only if the isLoaderSupported
* method returns true. Otherwise the loader parameter is ignored.
*
* @param className the name of the class.
* @param loader the class loader.
* @param params an array containing the parameters of the constructor.
* @param signature an array containing the signature of the constructor.
* @return the instance.
* @throws NestableException if instantiation fails.
*/
Object getInstance(String className,
ClassLoader loader,
Object[] params,
String[] signature)
throws NestableException;
/**
* Tests if specified class loaders are supported for a named class.
*
* @param className the name of the class.
* @return true if class loaders are supported, false otherwise.
* @throws NestableException if test fails.
*/
boolean isLoaderSupported(String className)
throws NestableException;
}
1.1
jakarta-turbine-stratum/src/java/org/apache/stratum/factory/ObjectInputStreamForContext.java
Index: ObjectInputStreamForContext.java
===================================================================
package org.apache.stratum.factory;
/* ====================================================================
* The Apache Software License, Version 1.1
*
* Copyright (c) 2001 The Apache Software Foundation. All rights
* reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* 3. The end-user documentation included with the redistribution,
* if any, must include the following acknowledgment:
* "This product includes software developed by the
* Apache Software Foundation (http://www.apache.org/)."
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
*
* 4. The names "Apache" and "Apache Software Foundation" and
* "Apache Turbine" must not be used to endorse or promote products
* derived from this software without prior written permission. For
* written permission, please contact [EMAIL PROTECTED]
*
* 5. Products derived from this software may not be called "Apache",
* "Apache Turbine", nor may "Apache" appear in their name, without
* prior written permission of the Apache Software Foundation.
*
* THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
* ====================================================================
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the Apache Software Foundation. For more
* information on the Apache Software Foundation, please see
* <http://www.apache.org/>.
*/
import java.io.InputStream;
import java.io.ObjectInputStream;
import java.io.ObjectStreamClass;
import java.io.IOException;
/**
* A deserialization stream for a specific class loader context.
*
* @author <a href="mailto:[EMAIL PROTECTED]";>Ilkka Priha</a>
* @version $Id: ObjectInputStreamForContext.java,v 1.1 2002/01/15 05:02:54 jvanzyl
Exp $
*/
public class ObjectInputStreamForContext
extends ObjectInputStream
{
/**
* The class loader of the context.
*/
private ClassLoader classLoader;
// this is to make the proxy happy.
public ObjectInputStreamForContext()
throws IOException
{
}
/**
* Contructs a new object stream for a context.
*
* @param in the serialized input stream.
* @param loader the class loader of the context.
* @throws IOException on errors.
*/
public ObjectInputStreamForContext(InputStream in,
ClassLoader loader)
throws IOException
{
super(in);
classLoader = loader;
}
protected Class resolveClass(ObjectStreamClass v)
throws IOException,
ClassNotFoundException
{
return classLoader == null ?
super.resolveClass(v) : classLoader.loadClass(v.getName());
}
}
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
