mirror of git://gcc.gnu.org/git/gcc.git
				
				
				
			
		
			
				
	
	
		
			672 lines
		
	
	
		
			25 KiB
		
	
	
	
		
			Java
		
	
	
	
			
		
		
	
	
			672 lines
		
	
	
		
			25 KiB
		
	
	
	
		
			Java
		
	
	
	
/* NamingManager.java -- Creates contexts and objects
 | 
						|
   Copyright (C) 2000, 2001, 2002, 2003, 2004,
 | 
						|
   2006 Free Software Foundation, Inc.
 | 
						|
 | 
						|
This file is part of GNU Classpath.
 | 
						|
 | 
						|
GNU Classpath is free software; you can redistribute it and/or modify
 | 
						|
it under the terms of the GNU General Public License as published by
 | 
						|
the Free Software Foundation; either version 2, or (at your option)
 | 
						|
any later version.
 | 
						|
 | 
						|
GNU Classpath is distributed in the hope that it will be useful, but
 | 
						|
WITHOUT ANY WARRANTY; without even the implied warranty of
 | 
						|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 | 
						|
General Public License for more details.
 | 
						|
 | 
						|
You should have received a copy of the GNU General Public License
 | 
						|
along with GNU Classpath; see the file COPYING.  If not, write to the
 | 
						|
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 | 
						|
02110-1301 USA.
 | 
						|
 | 
						|
Linking this library statically or dynamically with other modules is
 | 
						|
making a combined work based on this library.  Thus, the terms and
 | 
						|
conditions of the GNU General Public License cover the whole
 | 
						|
combination.
 | 
						|
 | 
						|
As a special exception, the copyright holders of this library give you
 | 
						|
permission to link this library with independent modules to produce an
 | 
						|
executable, regardless of the license terms of these independent
 | 
						|
modules, and to copy and distribute the resulting executable under
 | 
						|
terms of your choice, provided that you also meet, for each linked
 | 
						|
independent module, the terms and conditions of the license of that
 | 
						|
module.  An independent module is a module which is not derived from
 | 
						|
or based on this library.  If you modify this library, you may extend
 | 
						|
this exception to your version of the library, but you are not
 | 
						|
obligated to do so.  If you do not wish to do so, delete this
 | 
						|
exception statement from your version. */
 | 
						|
 | 
						|
 | 
						|
package javax.naming.spi;
 | 
						|
 | 
						|
import gnu.classpath.VMStackWalker;
 | 
						|
 | 
						|
import gnu.java.lang.CPStringBuilder;
 | 
						|
 | 
						|
import java.util.Enumeration;
 | 
						|
import java.util.Hashtable;
 | 
						|
import java.util.StringTokenizer;
 | 
						|
 | 
						|
import javax.naming.CannotProceedException;
 | 
						|
import javax.naming.Context;
 | 
						|
import javax.naming.Name;
 | 
						|
import javax.naming.NamingException;
 | 
						|
import javax.naming.NoInitialContextException;
 | 
						|
import javax.naming.RefAddr;
 | 
						|
import javax.naming.Reference;
 | 
						|
import javax.naming.Referenceable;
 | 
						|
import javax.naming.StringRefAddr;
 | 
						|
 | 
						|
/**
 | 
						|
 * Contains methods for creating contexts and objects referred to by
 | 
						|
 * location information. The location is specified in the scope of the
 | 
						|
 * certain naming or directory service. This class only contais static
 | 
						|
 * methods and cannot be instantiated.
 | 
						|
 */
 | 
						|
public class NamingManager
 | 
						|
{
 | 
						|
  /**
 | 
						|
   * The environment property into which getContinuationContext() stores the
 | 
						|
   * value of the CannotProceedException parameter. The value of this field
 | 
						|
   * is <i>java.naming.spi.CannotProceedException<i>.
 | 
						|
   */
 | 
						|
  public static final String CPE = "java.naming.spi.CannotProceedException";
 | 
						|
 | 
						|
  private static InitialContextFactoryBuilder icfb;
 | 
						|
 | 
						|
  // Package private so DirectoryManager can access it.
 | 
						|
  static ObjectFactoryBuilder ofb;
 | 
						|
 | 
						|
  // This class cannot be instantiated.
 | 
						|
  NamingManager ()
 | 
						|
  {
 | 
						|
  }
 | 
						|
 | 
						|
  /**
 | 
						|
   * Checks if the initial context factory builder has been set.
 | 
						|
   *
 | 
						|
   * @return true if the builder has been set
 | 
						|
   *
 | 
						|
   * @see #setInitialContextFactoryBuilder(InitialContextFactoryBuilder)
 | 
						|
   */
 | 
						|
  public static boolean hasInitialContextFactoryBuilder ()
 | 
						|
  {
 | 
						|
    return icfb != null;
 | 
						|
  }
 | 
						|
 | 
						|
  /**
 | 
						|
   * Creates the initial context. If the initial object factory builder has
 | 
						|
   * been set with {@link #setObjectFactoryBuilder(ObjectFactoryBuilder)},
 | 
						|
   * the work is delegated to this builder. Otherwise, the method searches
 | 
						|
   * for the property Context.INITIAL_CONTEXT_FACTORY first in the passed
 | 
						|
   * table and then in the system properties. The value of this property is
 | 
						|
   * uses as a class name to install the context factory. The corresponding
 | 
						|
   * class must exist, be public and have the public parameterless constructor.
 | 
						|
   *
 | 
						|
   * @param environment the properties, used to create the context.
 | 
						|
   *
 | 
						|
   * @return the created context
 | 
						|
   *
 | 
						|
   * @throws NoInitialContextException if the initial builder is not set,
 | 
						|
   *           the property Context.INITIAL_CONTEXT_FACTORY is missing of the
 | 
						|
   *           class, named by this property, cannot be instantiated.
 | 
						|
   * @throws NamingException if throws by the context factory
 | 
						|
   */
 | 
						|
  public static Context getInitialContext (Hashtable<?, ?> environment)
 | 
						|
    throws NamingException
 | 
						|
  {
 | 
						|
    InitialContextFactory icf = null;
 | 
						|
 | 
						|
    if (icfb != null)
 | 
						|
      icf = icfb.createInitialContextFactory(environment);
 | 
						|
    else
 | 
						|
      {
 | 
						|
        String java_naming_factory_initial = null;
 | 
						|
        if (environment != null)
 | 
						|
          java_naming_factory_initial
 | 
						|
            = (String) environment.get (Context.INITIAL_CONTEXT_FACTORY);
 | 
						|
        if (java_naming_factory_initial == null)
 | 
						|
          java_naming_factory_initial =
 | 
						|
            System.getProperty (Context.INITIAL_CONTEXT_FACTORY);
 | 
						|
        if (java_naming_factory_initial == null)
 | 
						|
          throw new
 | 
						|
            NoInitialContextException ("Can't find property: "
 | 
						|
                                       + Context.INITIAL_CONTEXT_FACTORY);
 | 
						|
 | 
						|
        try
 | 
						|
          {
 | 
						|
            icf = (InitialContextFactory)Class.forName
 | 
						|
                (java_naming_factory_initial, true,
 | 
						|
                 Thread.currentThread().getContextClassLoader())
 | 
						|
                .newInstance ();
 | 
						|
          }
 | 
						|
        catch (Exception exception)
 | 
						|
          {
 | 
						|
            NoInitialContextException e
 | 
						|
              = new NoInitialContextException
 | 
						|
              ("Can't load InitialContextFactory class: "
 | 
						|
               + java_naming_factory_initial);
 | 
						|
            e.setRootCause(exception);
 | 
						|
            throw e;
 | 
						|
          }
 | 
						|
      }
 | 
						|
 | 
						|
    return icf.getInitialContext (environment);
 | 
						|
  }
 | 
						|
 | 
						|
  /**
 | 
						|
   * <p>
 | 
						|
   * Creates the URL context for the given URL scheme id.
 | 
						|
   * </p>
 | 
						|
   * <p>
 | 
						|
   * The class name of the factory that creates the context has the naming
 | 
						|
   * pattern scheme-idURLContextFactory. For instance, the factory for the "ftp"
 | 
						|
   * sheme should be named "ftpURLContextFactory".
 | 
						|
   * </p>
 | 
						|
   * <p>
 | 
						|
   * The Context.URL_PKG_PREFIXES environment property contains the
 | 
						|
   * colon-separated list of the possible package prefixes. The package name is
 | 
						|
   * constructed concatenating the package prefix with the scheme id. This
 | 
						|
   * property is searched in the passed <i>environment</i> parameter and later
 | 
						|
   * in the system properties.
 | 
						|
   * </p>
 | 
						|
   * <p>
 | 
						|
   * If the factory class cannot be found in the specified packages, system will
 | 
						|
   * try to use the default internal factory for the given scheme.
 | 
						|
   * </p>
 | 
						|
   * <p>
 | 
						|
   * After the factory is instantiated, its method
 | 
						|
   * {@link ObjectFactory#getObjectInstance(Object, Name, Context, Hashtable)}
 | 
						|
   * is called to create and return the object instance.
 | 
						|
   *
 | 
						|
   * @param refInfo passed to the factory
 | 
						|
   * @param name passed to the factory
 | 
						|
   * @param nameCtx passed to the factory
 | 
						|
   * @param scheme the url scheme that must be supported by the given context
 | 
						|
   * @param environment the properties for creating the factory and context (may
 | 
						|
   *          be null)
 | 
						|
   * @return the created context
 | 
						|
   * @throws NamingException if thrown by the factory when creating the context.
 | 
						|
   */
 | 
						|
  static Context getURLContext(Object refInfo, Name name, Context nameCtx,
 | 
						|
                               String scheme, Hashtable<?,?> environment)
 | 
						|
      throws NamingException
 | 
						|
  {
 | 
						|
    // Doc specifies com.sun.jndi.url as the final destination, but we cannot
 | 
						|
    // put our classes into such namespace.
 | 
						|
    String defaultPrefix = "gnu.javax.naming.jndi.url";
 | 
						|
 | 
						|
    // The final default location, as specified in the documentation.
 | 
						|
    String finalPrefix = "com.sun.jndi.url";
 | 
						|
 | 
						|
    CPStringBuilder allPrefixes = new CPStringBuilder();
 | 
						|
 | 
						|
    String prefixes;
 | 
						|
      if (environment != null)
 | 
						|
        {
 | 
						|
        prefixes = (String) environment.get(Context.URL_PKG_PREFIXES);
 | 
						|
        if (prefixes != null)
 | 
						|
          allPrefixes.append(prefixes);
 | 
						|
        }
 | 
						|
 | 
						|
    prefixes = System.getProperty(Context.URL_PKG_PREFIXES);
 | 
						|
    if (prefixes != null)
 | 
						|
      {
 | 
						|
        if (allPrefixes.length() > 0)
 | 
						|
          allPrefixes.append(':');
 | 
						|
        allPrefixes.append(prefixes);
 | 
						|
      }
 | 
						|
 | 
						|
    if (allPrefixes.length() > 0)
 | 
						|
      allPrefixes.append(':');
 | 
						|
    allPrefixes.append(defaultPrefix);
 | 
						|
    allPrefixes.append(':');
 | 
						|
    allPrefixes.append(finalPrefix);
 | 
						|
 | 
						|
      scheme = scheme + "." + scheme + "URLContextFactory";
 | 
						|
 | 
						|
    StringTokenizer tokens = new StringTokenizer(allPrefixes.toString(), ":");
 | 
						|
    while (tokens.hasMoreTokens())
 | 
						|
        {
 | 
						|
        String aTry = tokens.nextToken();
 | 
						|
        try
 | 
						|
          {
 | 
						|
            String tryClass = aTry + "." + scheme;
 | 
						|
            Class factoryClass = forName(tryClass);
 | 
						|
            if (factoryClass != null)
 | 
						|
              {
 | 
						|
                Object obj;
 | 
						|
                try
 | 
						|
                  {
 | 
						|
                    ObjectFactory factory = (ObjectFactory) factoryClass.newInstance();
 | 
						|
                    obj = factory.getObjectInstance(refInfo, name, nameCtx,
 | 
						|
                                                    environment);
 | 
						|
                    Context ctx = (Context) obj;
 | 
						|
                    if (ctx != null)
 | 
						|
                      return ctx;
 | 
						|
                  }
 | 
						|
                catch (RuntimeException e)
 | 
						|
                  {
 | 
						|
                    // TODO Auto-generated catch block
 | 
						|
                    e.printStackTrace();
 | 
						|
                  }
 | 
						|
              }
 | 
						|
          }
 | 
						|
        catch (ClassNotFoundException _1)
 | 
						|
          {
 | 
						|
            // Ignore it.
 | 
						|
          }
 | 
						|
        catch (ClassCastException _2)
 | 
						|
          {
 | 
						|
            // This means that the class we found was not an
 | 
						|
            // ObjectFactory or that the factory returned something
 | 
						|
            // which was not a Context.
 | 
						|
          }
 | 
						|
        catch (InstantiationException _3)
 | 
						|
          {
 | 
						|
            // If we couldn't instantiate the factory we might get
 | 
						|
            // this.
 | 
						|
          }
 | 
						|
        catch (IllegalAccessException _4)
 | 
						|
          {
 | 
						|
            // Another possibility when instantiating.
 | 
						|
          }
 | 
						|
        catch (NamingException _5)
 | 
						|
          {
 | 
						|
            throw _5;
 | 
						|
          }
 | 
						|
        catch (Exception _6)
 | 
						|
          {
 | 
						|
            // Anything from getObjectInstance.
 | 
						|
          }
 | 
						|
        }
 | 
						|
 | 
						|
    return null;
 | 
						|
  }
 | 
						|
 | 
						|
  /**
 | 
						|
   * Load the class with the given name. This method tries to use the context
 | 
						|
   * class loader first. If this fails, it searches for the suitable class
 | 
						|
   * loader in the caller stack trace. This method is a central point where all
 | 
						|
   * requests to find a class by name are delegated.
 | 
						|
   */
 | 
						|
  static Class forName(String className)
 | 
						|
  {
 | 
						|
    try
 | 
						|
      {
 | 
						|
        return Class.forName(className, true,
 | 
						|
                             Thread.currentThread().getContextClassLoader());
 | 
						|
      }
 | 
						|
    catch (ClassNotFoundException nex)
 | 
						|
      {
 | 
						|
        /**
 | 
						|
         * Returns the first user defined class loader on the call stack, or
 | 
						|
         * null when no non-null class loader was found.
 | 
						|
         */
 | 
						|
        Class[] ctx = VMStackWalker.getClassContext();
 | 
						|
        for (int i = 0; i < ctx.length; i++)
 | 
						|
          {
 | 
						|
            // Since we live in a class loaded by the bootstrap
 | 
						|
            // class loader, getClassLoader is safe to call without
 | 
						|
            // needing to be wrapped in a privileged action.
 | 
						|
            ClassLoader cl = ctx[i].getClassLoader();
 | 
						|
            try
 | 
						|
              {
 | 
						|
                if (cl != null)
 | 
						|
                  return Class.forName(className, true, cl);
 | 
						|
              }
 | 
						|
            catch (ClassNotFoundException nex2)
 | 
						|
              {
 | 
						|
                // Try next.
 | 
						|
              }
 | 
						|
          }
 | 
						|
      }
 | 
						|
    return null;
 | 
						|
  }
 | 
						|
 | 
						|
 | 
						|
  /**
 | 
						|
   * <p>
 | 
						|
   * Creates the URL context for the given URL scheme id.
 | 
						|
   * </p>
 | 
						|
   * <p>
 | 
						|
   * The class name of the factory that creates the context has the naming
 | 
						|
   * pattern scheme-idURLContextFactory. For instance, the factory for the
 | 
						|
   * "ftp" scheme should be named "ftpURLContextFactory".
 | 
						|
   * The Context.URL_PKG_PREFIXES environment property contains the
 | 
						|
   * colon-separated list of the possible package prefixes. The package name
 | 
						|
   * is constructed by concatenating the package prefix with the scheme id.
 | 
						|
   * </p>
 | 
						|
   * <p>
 | 
						|
   * If the factory class cannot be found in the specified packages, the
 | 
						|
   * system will try to use the default internal factory for the given scheme.
 | 
						|
   * </p>
 | 
						|
   * <p>
 | 
						|
   * After the factory is instantiated, its method
 | 
						|
   * {@link ObjectFactory#getObjectInstance(Object, Name, Context, Hashtable)}
 | 
						|
   * is called to create and return the object instance.
 | 
						|
   *
 | 
						|
   * @param scheme the url scheme that must be supported by the given context
 | 
						|
   * @param environment the properties for creating the factory and context
 | 
						|
   *                    (may be null)
 | 
						|
   * @return the created context
 | 
						|
   * @throws NamingException if thrown by the factory when creating the
 | 
						|
   *                         context.
 | 
						|
   */
 | 
						|
  public static Context getURLContext (String scheme,
 | 
						|
                                       Hashtable<?, ?> environment)
 | 
						|
       throws NamingException
 | 
						|
  {
 | 
						|
    return getURLContext (null, null, null, scheme, environment);
 | 
						|
  }
 | 
						|
 | 
						|
  /**
 | 
						|
   * Sets the initial object factory builder.
 | 
						|
   *
 | 
						|
   * @param builder the builder to set
 | 
						|
   *
 | 
						|
   * @throws SecurityException if the builder cannot be installed due
 | 
						|
   *           security restrictions.
 | 
						|
   * @throws NamingException if the builder cannot be installed due other
 | 
						|
   *           reasons
 | 
						|
   * @throws IllegalStateException if setting the builder repeatedly
 | 
						|
   */
 | 
						|
  public static void setObjectFactoryBuilder (ObjectFactoryBuilder builder)
 | 
						|
    throws NamingException
 | 
						|
  {
 | 
						|
    SecurityManager sm = System.getSecurityManager ();
 | 
						|
    if (sm != null)
 | 
						|
      sm.checkSetFactory ();
 | 
						|
    // Once the builder is installed it cannot be replaced.
 | 
						|
    if (ofb != null)
 | 
						|
      throw new IllegalStateException ("object factory builder already installed");
 | 
						|
    if (builder != null)
 | 
						|
      ofb = builder;
 | 
						|
  }
 | 
						|
 | 
						|
  static StringTokenizer getPlusPath (String property, Hashtable env,
 | 
						|
                                      Context nameCtx)
 | 
						|
    throws NamingException
 | 
						|
  {
 | 
						|
    String path = (String) env.get (property);
 | 
						|
    if (nameCtx == null)
 | 
						|
      nameCtx = getInitialContext (env);
 | 
						|
    String path2 = (String) nameCtx.getEnvironment ().get (property);
 | 
						|
    if (path == null)
 | 
						|
      path = path2;
 | 
						|
    else if (path2 != null)
 | 
						|
      path += ":" + path2;
 | 
						|
    return new StringTokenizer (path != null ? path : "", ":");
 | 
						|
  }
 | 
						|
 | 
						|
  /**
 | 
						|
   * <p>Creates an object for the specified name context, environment and
 | 
						|
   * referencing context object.</p>
 | 
						|
   * <p>
 | 
						|
   * If the builder factory is set by
 | 
						|
   * {@link #setObjectFactoryBuilder(ObjectFactoryBuilder)}, the call is
 | 
						|
   * delegated to that factory. Otherwise, the object is created using the
 | 
						|
   * following rules:
 | 
						|
   * <ul>
 | 
						|
   * <li>If the referencing object (refInfo) contains the factory class name,
 | 
						|
   *       the object is created by this factory. If the creation fails,
 | 
						|
   *       the parameter refInfo is returned as the method return value.</li>
 | 
						|
   * <li>If the referencing object has no factory class name, and the addresses
 | 
						|
   *       are StringRefAddrs having the address type "URL", the object is
 | 
						|
   *       created by the URL context factory. The used factory corresponds the
 | 
						|
   *       the naming schema of the each URL. If the attempt to create
 | 
						|
   *       the object this way is not successful, the subsequent rule is
 | 
						|
   *       tried.</li>
 | 
						|
   * <li>  If the refInfo is not an instance of Reference or Referencable
 | 
						|
   *       (for example, null), the object is created by the factories,
 | 
						|
   *       specified in the Context.OBJECT_FACTORIES property of the
 | 
						|
   *       environment and the provider resource file, associated with the
 | 
						|
   *       nameCtx. The value of this property is the colon separated list
 | 
						|
   *       of the possible factories. If none of the factories can be
 | 
						|
   *       loaded, the refInfo is returned.
 | 
						|
   * </ul>
 | 
						|
   * </p>
 | 
						|
   * <p>The object factory must be public and have the public parameterless
 | 
						|
   * constructor.</p>
 | 
						|
   *
 | 
						|
   * @param refInfo the referencing object, for which the new object must be
 | 
						|
   *          created (can be null). If not null, it is usually an instance of
 | 
						|
   *          the {@link Reference} or {@link Referenceable}.
 | 
						|
   * @param name the name of the object. The name is relative to
 | 
						|
   *          the nameCtx naming context. The value of this parameter can be
 | 
						|
   *          null if the name is not specified.
 | 
						|
   * @param nameCtx the naming context, in which scope the name of the new
 | 
						|
   *          object is specified. If this parameter is null, the name is
 | 
						|
   *          specified in the scope of the initial context.
 | 
						|
   * @param environment contains additional information for creating the object.
 | 
						|
   *          This paramter can be null if there is no need to provide any
 | 
						|
   *          additional information.
 | 
						|
   *
 | 
						|
   * @return  the created object. If the creation fails, in some cases
 | 
						|
   *          the parameter refInfo may be returned.
 | 
						|
   *
 | 
						|
   * @throws NamingException if the attempt to name the new object has failed
 | 
						|
   * @throws Exception if the object factory throws it. The object factory
 | 
						|
   *           only throws an exception if it does not want other factories
 | 
						|
   *           to be used to create the object.
 | 
						|
   */
 | 
						|
  public static Object getObjectInstance (Object refInfo,
 | 
						|
                                          Name name,
 | 
						|
                                          Context nameCtx,
 | 
						|
                                          Hashtable<?, ?> environment)
 | 
						|
    throws Exception
 | 
						|
  {
 | 
						|
    ObjectFactory factory = null;
 | 
						|
 | 
						|
    if (ofb != null)
 | 
						|
      factory = ofb.createObjectFactory (refInfo, environment);
 | 
						|
    else
 | 
						|
      {
 | 
						|
        // First see if we have a Reference or a Referenceable.  If so
 | 
						|
        // we do some special processing.
 | 
						|
        Object ref2 = refInfo;
 | 
						|
        if (refInfo instanceof Referenceable)
 | 
						|
          ref2 = ((Referenceable) refInfo).getReference ();
 | 
						|
        if (ref2 instanceof Reference)
 | 
						|
          {
 | 
						|
            Reference ref = (Reference) ref2;
 | 
						|
 | 
						|
            // If we have a factory class name then we use that.
 | 
						|
            String fClass = ref.getFactoryClassName ();
 | 
						|
            if (fClass != null)
 | 
						|
              {
 | 
						|
                // Exceptions here are passed to the caller.
 | 
						|
                Class k = Class.forName (fClass,
 | 
						|
                                         true,
 | 
						|
                                         Thread.currentThread().getContextClassLoader());
 | 
						|
                factory = (ObjectFactory) k.newInstance ();
 | 
						|
              }
 | 
						|
            else
 | 
						|
              {
 | 
						|
                // There's no factory class name.  If the address is a
 | 
						|
                // StringRefAddr with address type `URL', then we try
 | 
						|
                // the URL's context factory.
 | 
						|
                Enumeration e = ref.getAll ();
 | 
						|
                while (e.hasMoreElements ())
 | 
						|
                  {
 | 
						|
                    RefAddr ra = (RefAddr) e.nextElement ();
 | 
						|
                    if (ra instanceof StringRefAddr
 | 
						|
                        && "URL".equals (ra.getType ()))
 | 
						|
                      {
 | 
						|
                        factory
 | 
						|
                          = (ObjectFactory) getURLContext (refInfo,
 | 
						|
                                                           name,
 | 
						|
                                                           nameCtx,
 | 
						|
                                                           (String) ra.getContent (),
 | 
						|
                                                           environment);
 | 
						|
                        Object obj = factory.getObjectInstance (refInfo,
 | 
						|
                                                                name,
 | 
						|
                                                                nameCtx,
 | 
						|
                                                                environment);
 | 
						|
                        if (obj != null)
 | 
						|
                          return obj;
 | 
						|
                      }
 | 
						|
                  }
 | 
						|
 | 
						|
                // Have to try the next step.
 | 
						|
                factory = null;
 | 
						|
              }
 | 
						|
          }
 | 
						|
 | 
						|
        // Now look at OBJECT_FACTORIES to find the factory.
 | 
						|
        if (factory == null)
 | 
						|
          {
 | 
						|
            StringTokenizer tokens = getPlusPath (Context.OBJECT_FACTORIES,
 | 
						|
                                                  environment, nameCtx);
 | 
						|
 | 
						|
            while (tokens.hasMoreTokens ())
 | 
						|
              {
 | 
						|
                String klassName = tokens.nextToken ();
 | 
						|
                Class k = Class.forName (klassName,
 | 
						|
                                         true,
 | 
						|
                                         Thread.currentThread().getContextClassLoader());
 | 
						|
                factory = (ObjectFactory) k.newInstance ();
 | 
						|
                Object obj = factory.getObjectInstance (refInfo, name,
 | 
						|
                                                        nameCtx, environment);
 | 
						|
                if (obj != null)
 | 
						|
                  return obj;
 | 
						|
              }
 | 
						|
 | 
						|
            // Failure.
 | 
						|
            return refInfo;
 | 
						|
          }
 | 
						|
      }
 | 
						|
 | 
						|
    if (factory == null)
 | 
						|
      return refInfo;
 | 
						|
    Object obj = factory.getObjectInstance (refInfo, name,
 | 
						|
                                            nameCtx, environment);
 | 
						|
    return obj == null ? refInfo : obj;
 | 
						|
  }
 | 
						|
 | 
						|
  /**
 | 
						|
   * Sets the initial context factory builder.
 | 
						|
   *
 | 
						|
   * @param builder the builder to set
 | 
						|
   *
 | 
						|
   * @throws SecurityException if the builder cannot be installed due
 | 
						|
   *           security restrictions.
 | 
						|
   * @throws NamingException if the builder cannot be installed due other
 | 
						|
   *           reasons
 | 
						|
   * @throws IllegalStateException if setting the builder repeatedly
 | 
						|
   *
 | 
						|
   * @see #hasInitialContextFactoryBuilder()
 | 
						|
   */
 | 
						|
  public static void setInitialContextFactoryBuilder
 | 
						|
    (InitialContextFactoryBuilder builder)
 | 
						|
    throws NamingException
 | 
						|
  {
 | 
						|
    SecurityManager sm = System.getSecurityManager ();
 | 
						|
    if (sm != null)
 | 
						|
      sm.checkSetFactory ();
 | 
						|
    // Once the builder is installed it cannot be replaced.
 | 
						|
    if (icfb != null)
 | 
						|
      throw new IllegalStateException ("ctx factory builder already installed");
 | 
						|
    if (builder != null)
 | 
						|
      icfb = builder;
 | 
						|
  }
 | 
						|
 | 
						|
  /**
 | 
						|
   * Creates a context in which the context operation must be continued.
 | 
						|
   * This method is used by operations on names that span multiple namespaces.
 | 
						|
   *
 | 
						|
   * @param cpe the exception that triggered this continuation. This method
 | 
						|
   * obtains the environment ({@link CannotProceedException#getEnvironment()}
 | 
						|
   * and sets the environment property {@link #CPE} = cpe.
 | 
						|
   *
 | 
						|
   * @return a non null context for continuing the operation
 | 
						|
   *
 | 
						|
   * @throws NamingException if the naming problems have occured
 | 
						|
   */
 | 
						|
  public static Context getContinuationContext (CannotProceedException cpe)
 | 
						|
    throws NamingException
 | 
						|
  {
 | 
						|
    Hashtable env = cpe.getEnvironment ();
 | 
						|
    if (env != null)
 | 
						|
      env.put (CPE, cpe);
 | 
						|
 | 
						|
    // TODO: Check if this implementation matches the API specification
 | 
						|
    try
 | 
						|
      {
 | 
						|
        Object obj = getObjectInstance (cpe.getResolvedObj(),
 | 
						|
                                        cpe.getAltName (),
 | 
						|
                                        cpe.getAltNameCtx (),
 | 
						|
                                        env);
 | 
						|
        if (obj != null)
 | 
						|
          return (Context) obj;
 | 
						|
      }
 | 
						|
    catch (Exception _)
 | 
						|
      {
 | 
						|
      }
 | 
						|
 | 
						|
    // fix stack trace for re-thrown exception (message confusing otherwise)
 | 
						|
    cpe.fillInStackTrace();
 | 
						|
 | 
						|
    throw cpe;
 | 
						|
  }
 | 
						|
 | 
						|
  /**
 | 
						|
   * Get the object state for binding.
 | 
						|
   *
 | 
						|
   * @param obj the object, for that the binding state must be retrieved. Cannot
 | 
						|
   *          be null.
 | 
						|
   * @param name the name of this object, related to the nameCtx. Can be null if
 | 
						|
   *          not specified.
 | 
						|
   * @param nameCtx the naming context, to that the object name is related. Can
 | 
						|
   *          be null if the name is related to the initial default context.
 | 
						|
   * @param environment the properties for creating the object state. Can be
 | 
						|
   *          null if no properties are provided.
 | 
						|
   * @return the object state for binding, may be null if no changes are
 | 
						|
   *         returned by the factory
 | 
						|
   * @throws NamingException
 | 
						|
   */
 | 
						|
  public static Object getStateToBind (Object obj, Name name,
 | 
						|
                                       Context nameCtx, Hashtable<?, ?> environment)
 | 
						|
    throws NamingException
 | 
						|
  {
 | 
						|
    StringTokenizer tokens = getPlusPath (Context.STATE_FACTORIES,
 | 
						|
                                          environment, nameCtx);
 | 
						|
    while (tokens.hasMoreTokens ())
 | 
						|
      {
 | 
						|
        String klassName = tokens.nextToken ();
 | 
						|
        try
 | 
						|
          {
 | 
						|
            Class k = Class.forName (klassName,
 | 
						|
                                     true,
 | 
						|
                                     Thread.currentThread().getContextClassLoader());
 | 
						|
            StateFactory factory = (StateFactory) k.newInstance ();
 | 
						|
            Object o = factory.getStateToBind (obj, name, nameCtx,
 | 
						|
                                               environment);
 | 
						|
            if (o != null)
 | 
						|
              return o;
 | 
						|
          }
 | 
						|
        catch (ClassNotFoundException _1)
 | 
						|
          {
 | 
						|
            // Ignore it.
 | 
						|
          }
 | 
						|
        catch (ClassCastException _2)
 | 
						|
          {
 | 
						|
            // This means that the class we found was not an
 | 
						|
            // ObjectFactory or that the factory returned something
 | 
						|
            // which was not a Context.
 | 
						|
          }
 | 
						|
        catch (InstantiationException _3)
 | 
						|
          {
 | 
						|
            // If we couldn't instantiate the factory we might get
 | 
						|
            // this.
 | 
						|
          }
 | 
						|
        catch (IllegalAccessException _4)
 | 
						|
          {
 | 
						|
            // Another possibility when instantiating.
 | 
						|
          }
 | 
						|
      }
 | 
						|
 | 
						|
    return obj;
 | 
						|
  }
 | 
						|
}
 |