FileDocCategorySizeDatePackage
FactoryFinder.javaAPI DocJava SE 6 API6399Tue Jun 10 00:27:10 BST 2008javax.xml.soap

FactoryFinder

public class FactoryFinder extends Object

Fields Summary
Constructors Summary
Methods Summary
static java.lang.Objectfind(java.lang.String factoryId)
Finds the implementation Class object for the given factory name, or null if that fails.

This method is package private so that this code can be shared.

return
the Class object of the specified message factory; or null
param
factoryId the name of the factory to find, which is a system property
exception
SOAPException if there is a SOAP error

        ClassLoader classLoader;
        try {
            classLoader = Thread.currentThread().getContextClassLoader();
        } catch (Exception x) {
            throw new SOAPException(x.toString(), x);
        }

        // Use the system property first
        try {
            String systemProp =
                System.getProperty( factoryId );
            if( systemProp!=null) {
                return newInstance(systemProp, classLoader);
            }
        } catch (SecurityException se) {
        }

        // try to read from $java.home/lib/jaxm.properties
        try {
            String javah=System.getProperty( "java.home" );
            String configFile = javah + File.separator +
                "lib" + File.separator + "jaxm.properties";
            File f=new File( configFile );
            if( f.exists()) {
                Properties props=new Properties();
                props.load( new FileInputStream(f));
                String factoryClassName = props.getProperty(factoryId);
                return newInstance(factoryClassName, classLoader);
            }
        } catch(Exception ex ) {
        }

        String serviceId = "META-INF/services/" + factoryId;
        // try to find services in CLASSPATH
        try {
            InputStream is=null;
            if (classLoader == null) {
                is=ClassLoader.getSystemResourceAsStream(serviceId);
            } else {
                is=classLoader.getResourceAsStream(serviceId);
            }
        
            if( is!=null ) {
                BufferedReader rd =
                    new BufferedReader(new InputStreamReader(is, "UTF-8"));
        
                String factoryClassName = rd.readLine();
                rd.close();

                if (factoryClassName != null &&
                    ! "".equals(factoryClassName)) {
                    return newInstance(factoryClassName, classLoader);
                }
            }
        } catch( Exception ex ) {
        }

        return null;
    
static java.lang.Objectfind(java.lang.String factoryId, java.lang.String fallbackClassName)
Finds the implementation Class object for the given factory name, or if that fails, finds the Class object for the given fallback class name. The arguments supplied must be used in order. If using the first argument is successful, the second one will not be used.

This method is package private so that this code can be shared.

return
the Class object of the specified message factory; may not be null
param
factoryId the name of the factory to find, which is a system property
param
fallbackClassName the implementation class name, which is to be used only if nothing else is found; null to indicate that there is no fallback class name
exception
SOAPException if there is a SOAP error


        Object obj = find(factoryId);
        if (obj != null)
            return obj;

        ClassLoader classLoader;
        try {
            classLoader = Thread.currentThread().getContextClassLoader();
        } catch (Exception x) {
            throw new SOAPException(x.toString(), x);
        }

        if (fallbackClassName == null) {
            throw new SOAPException(
                "Provider for " + factoryId + " cannot be found", null);
        }

        return newInstance(fallbackClassName, classLoader);
    
private static java.lang.ObjectnewInstance(java.lang.String className, java.lang.ClassLoader classLoader)
Creates an instance of the specified class using the specified ClassLoader object.

exception
SOAPException if the given class could not be found or could not be instantiated

        try {
            Class spiClass;
            if (classLoader == null) {
                spiClass = Class.forName(className);
            } else {
                spiClass = classLoader.loadClass(className);
            }
            return spiClass.newInstance();
        } catch (ClassNotFoundException x) {
            throw new SOAPException(
                "Provider " + className + " not found", x);
        } catch (Exception x) {
            throw new SOAPException(
                "Provider " + className + " could not be instantiated: " + x,
                x);
        }