jdk7u.jaxp.org.apache.xalan.external.utils

Class ObjectFactory

java.lang.Object

jdk7u.jaxp.org.apache.xalan.external.utils.ObjectFactory

public class ObjectFactory
extends Object

This class is duplicated for each JAXP subpackage so keep it in sync. It is package private and therefore is not exposed as part of the JAXP API.

This code is designed to implement the JAXP 1.1 spec pluggability feature and is designed to run on JDK version 1.1 and later, and to compile on JDK 1.2 and onward. The code also runs both as part of an unbundled jar file and when bundled as part of the JDK.

This class was moved from the javax.xml.parsers.ObjectFactory class and modified to be used as a general utility for creating objects dynamically.

Version:

$Id: ObjectFactory.java,v 1.11 2010-11-01 04:34:25 joehw Exp $

Constructor Summary

Constructors

Constructor and Description
ObjectFactory()

Method Summary

Methods

Modifier and Type	Method and Description
static Object	createObject(String factoryId, String fallbackClassName) Finds the implementation Class object in the specified order.
static ClassLoader	findClassLoader() Figure out which ClassLoader to use.
static Class	findProviderClass(String className, boolean doFallback) Find a Class using the same classloader for the ObjectFactory by default or bootclassloader when Security Manager is in place
static Class	lookUpFactoryClass(String factoryId) Finds the implementation Class object in the specified order.
static Class	lookUpFactoryClass(String factoryId, String propertiesFilename, String fallbackClassName) Finds the implementation Class object in the specified order.
static Object	newInstance(String className, boolean doFallback) Create an instance of a class using the same classloader for the ObjectFactory by default or bootclassloader when Security Manager is in place

Methods inherited from class java.lang.Object

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

Constructor Detail

ObjectFactory

public ObjectFactory()

Method Detail

createObject

public static Object createObject(String factoryId,
                  String fallbackClassName)
                           throws ConfigurationError

Finds the implementation Class object in the specified order. The specified order is the following:

1. query the system property using System.getProperty
2. read META-INF/services/factoryId file
3. use fallback classname

Parameters:

factoryId - Name of the factory to find, same as a property name

fallbackClassName - Implementation class name, if nothing else is found. Use null to mean no fallback.

Returns:

instance of factory, never null

Throws:

ObjectFactory.ConfigurationError

ConfigurationError

lookUpFactoryClass

public static Class lookUpFactoryClass(String factoryId)
                                throws ConfigurationError

Finds the implementation Class object in the specified order. The specified order is the following:

1. query the system property using System.getProperty
2. read $java.home/lib/propertiesFilename file
3. read META-INF/services/factoryId file
4. use fallback classname

Parameters:

factoryId - Name of the factory to find, same as a property name

propertiesFilename - The filename in the $java.home/lib directory of the properties file. If none specified, ${java.home}/lib/xalan.properties will be used.

fallbackClassName - Implementation class name, if nothing else is found. Use null to mean no fallback.

Returns:

Class object of factory, never null

Throws:

ObjectFactory.ConfigurationError

ConfigurationError

lookUpFactoryClass

public static Class lookUpFactoryClass(String factoryId,
                       String propertiesFilename,
                       String fallbackClassName)
                                throws ConfigurationError

Finds the implementation Class object in the specified order. The specified order is the following:

1. query the system property using System.getProperty
2. read $java.home/lib/propertiesFilename file
3. read META-INF/services/factoryId file
4. use fallback classname

Parameters:

factoryId - Name of the factory to find, same as a property name

propertiesFilename - The filename in the $java.home/lib directory of the properties file. If none specified, ${java.home}/lib/xalan.properties will be used.

fallbackClassName - Implementation class name, if nothing else is found. Use null to mean no fallback.

Returns:

Class object that provides factory service, never null

Throws:

ObjectFactory.ConfigurationError

ConfigurationError

findClassLoader

public static ClassLoader findClassLoader()
                                   throws ConfigurationError

Figure out which ClassLoader to use. For JDK 1.2 and later use the context ClassLoader.

Throws:

ConfigurationError

newInstance

public static Object newInstance(String className,
                 boolean doFallback)
                          throws ConfigurationError

Create an instance of a class using the same classloader for the ObjectFactory by default or bootclassloader when Security Manager is in place

Throws:

ConfigurationError

findProviderClass

public static Class findProviderClass(String className,
                      boolean doFallback)
                               throws ClassNotFoundException,
                                      ConfigurationError

Find a Class using the same classloader for the ObjectFactory by default or bootclassloader when Security Manager is in place

Throws:

ClassNotFoundException

ConfigurationError