Also see:

addToEnvironment
removeFromEnvironment
getEnvironment

Also see:

getDefaultInitCtx

 public InitialContext() throws NamingException 
{
        init(null);
}

Constructs an initial context. No environment properties are supplied. Equivalent to new InitialContext(null).

Throws:

NamingException - if a naming exception is encountered

Also see:

InitialContext(Hashtable)

 protected InitialContext(boolean lazy) throws NamingException 
{
        if (!lazy) {
            init(null);
        }
}

Constructs an initial context with the option of not initializing it. This may be used by a constructor in a subclass when the value of the environment parameter is not yet known at the time the InitialContext constructor is called. The subclass's constructor will call this constructor, compute the value of the environment, and then call init() before returning.

Parameters:

lazy - true means do not initialize the initial context; false is equivalent to calling new InitialContext()

Throws:

NamingException - if a naming exception is encountered

Also see:

init(Hashtable)
since: 1.3 -

 public InitialContext(Hashtable<?, ?> environment) throws NamingException 
{
        if (environment != null) {
            environment = (Hashtable)environment.clone();
        }
        init(environment);
}

Constructs an initial context using the supplied environment. Environment properties are discussed in the class description.

This constructor will not modify environment or save a reference to it, but may save a clone. Caller should not modify mutable keys and values in environment after it has been passed to the constructor.

Parameters:

environment - environment used to create the initial context. Null indicates an empty environment.

Throws:

NamingException - if a naming exception is encountered

 public Object addToEnvironment(String propName,
    Object propVal) throws NamingException 
{
        myProps.put(propName, propVal);
        return getDefaultInitCtx().addToEnvironment(propName, propVal);
}

 public  void bind(String name,
    Object obj) throws NamingException 
{
        getURLOrDefaultInitCtx(name).bind(name, obj);
}

 public  void bind(Name name,
    Object obj) throws NamingException 
{
        getURLOrDefaultInitCtx(name).bind(name, obj);
}

 public  void close() throws NamingException 
{
        myProps = null;
        if (defaultInitCtx != null) {
            defaultInitCtx.close();
            defaultInitCtx = null;
        }
        gotDefault = false;
}

 public String composeName(String name,
    String prefix) throws NamingException 
{
        return name;
}

Composes the name of this context with a name relative to this context. Since an initial context may never be named relative to any context other than itself, the value of the prefix parameter must be an empty name ("").

 public Name composeName(Name name,
    Name prefix) throws NamingException 
{
        return (Name)name.clone();
}

Composes the name of this context with a name relative to this context. Since an initial context may never be named relative to any context other than itself, the value of the prefix parameter must be an empty name.

 public Context createSubcontext(String name) throws NamingException 
{
        return getURLOrDefaultInitCtx(name).createSubcontext(name);
}

 public Context createSubcontext(Name name) throws NamingException 
{
        return getURLOrDefaultInitCtx(name).createSubcontext(name);
}

 public  void destroySubcontext(String name) throws NamingException 
{
        getURLOrDefaultInitCtx(name).destroySubcontext(name);
}

 public  void destroySubcontext(Name name) throws NamingException 
{
        getURLOrDefaultInitCtx(name).destroySubcontext(name);
}

 public static T doLookup(Name name) throws NamingException 
{
        return (T) (new InitialContext()).lookup(name);
}

A static method to retrieve the named object. This is a shortcut method equivalent to invoking:

InitialContext ic = new InitialContext(); Object obj = ic.lookup();

If name is empty, returns a new instance of this context (which represents the same naming context as this context, but its environment may be modified independently and it may be accessed concurrently).

 public static T doLookup(String name) throws NamingException 
{
        return (T) (new InitialContext()).lookup(name);
}

A static method to retrieve the named object. See #doLookup(Name) for details.

 protected Context getDefaultInitCtx() throws NamingException 
{
        if (!gotDefault) {
            defaultInitCtx = NamingManager.getInitialContext(myProps);
            gotDefault = true;
        }
        if (defaultInitCtx == null)
            throw new NoInitialContextException();
        return defaultInitCtx;
}

Retrieves the initial context by calling NamingManager.getInitialContext() and cache it in defaultInitCtx. Set gotDefault so that we know we've tried this before.

 public Hashtable<?, ?> getEnvironment() throws NamingException 
{
        return getDefaultInitCtx().getEnvironment();
}

 public String getNameInNamespace() throws NamingException 
{
        return getDefaultInitCtx().getNameInNamespace();
}

 public NameParser getNameParser(String name) throws NamingException 
{
        return getURLOrDefaultInitCtx(name).getNameParser(name);
}

 public NameParser getNameParser(Name name) throws NamingException 
{
        return getURLOrDefaultInitCtx(name).getNameParser(name);
}

 protected Context getURLOrDefaultInitCtx(String name) throws NamingException 
{
        if (NamingManager.hasInitialContextFactoryBuilder()) {
            return getDefaultInitCtx();
        }
        String scheme = getURLScheme(name);
        if (scheme != null) {
            Context ctx = NamingManager.getURLContext(scheme, myProps);
            if (ctx != null) {
                return ctx;
            }
        }
        return getDefaultInitCtx();
}

Retrieves a context for resolving the string name name. If name name is a URL string, then attempt to find a URL context for it. If none is found, or if name is not a URL string, then return getDefaultInitCtx().

See getURLOrDefaultInitCtx(Name) for description of how a subclass should use this method.

 protected Context getURLOrDefaultInitCtx(Name name) throws NamingException 
{
        if (NamingManager.hasInitialContextFactoryBuilder()) {
            return getDefaultInitCtx();
        }
        if (name.size()  > 0) {
            String first = name.get(0);
            String scheme = getURLScheme(first);
            if (scheme != null) {
                Context ctx = NamingManager.getURLContext(scheme, myProps);
                if (ctx != null) {
                    return ctx;
                }
            }
        }
        return getDefaultInitCtx();
}

Retrieves a context for resolving name. If the first component of name name is a URL string, then attempt to find a URL context for it. If none is found, or if the first component of name is not a URL string, then return getDefaultInitCtx().

When creating a subclass of InitialContext, use this method as follows. Define a new method that uses this method to get an initial context of the desired subclass.

protected XXXContext getURLOrDefaultInitXXXCtx(Name name)
throws NamingException {
 Context answer = getURLOrDefaultInitCtx(name);
 if (!(answer instanceof XXXContext)) {
   if (answer == null) {
     throw new NoInitialContextException();
   } else {
     throw new NotContextException("Not an XXXContext");
   }
 }
 return (XXXContext)answer;
}

When providing implementations for the new methods in the subclass, use this newly defined method to get the initial context.

public Object XXXMethod1(Name name, ...) {
 throws NamingException {
   return getURLOrDefaultInitXXXCtx(name).XXXMethod1(name, ...);
}

 protected  void init(Hashtable<?, ?> environment) throws NamingException 
{
        myProps = ResourceManager.getInitialEnvironment(environment);
        if (myProps.get(Context.INITIAL_CONTEXT_FACTORY) != null) {
            // user has specified initial context factory; try to get it
            getDefaultInitCtx();
        }
}

Initializes the initial context using the supplied environment. Environment properties are discussed in the class description.

This method will modify environment and save a reference to it. The caller may no longer modify it.

 public NamingEnumeration<NameClassPair> list(String name) throws NamingException 
{
        return (getURLOrDefaultInitCtx(name).list(name));
}

 public NamingEnumeration<NameClassPair> list(Name name) throws NamingException 
{
        return (getURLOrDefaultInitCtx(name).list(name));
}

 public NamingEnumeration<Binding> listBindings(String name) throws NamingException 
{
        return getURLOrDefaultInitCtx(name).listBindings(name);
}

 public NamingEnumeration<Binding> listBindings(Name name) throws NamingException 
{
        return getURLOrDefaultInitCtx(name).listBindings(name);
}

 public Object lookup(String name) throws NamingException 
{
        return getURLOrDefaultInitCtx(name).lookup(name);
}

 public Object lookup(Name name) throws NamingException 
{
        return getURLOrDefaultInitCtx(name).lookup(name);
}

 public Object lookupLink(String name) throws NamingException 
{
        return getURLOrDefaultInitCtx(name).lookupLink(name);
}

 public Object lookupLink(Name name) throws NamingException 
{
        return getURLOrDefaultInitCtx(name).lookupLink(name);
}

 public  void rebind(String name,
    Object obj) throws NamingException 
{
        getURLOrDefaultInitCtx(name).rebind(name, obj);
}

 public  void rebind(Name name,
    Object obj) throws NamingException 
{
        getURLOrDefaultInitCtx(name).rebind(name, obj);
}

 public Object removeFromEnvironment(String propName) throws NamingException 
{
        myProps.remove(propName);
        return getDefaultInitCtx().removeFromEnvironment(propName);
}

 public  void rename(String oldName,
    String newName) throws NamingException 
{
        getURLOrDefaultInitCtx(oldName).rename(oldName, newName);
}

 public  void rename(Name oldName,
    Name newName) throws NamingException 
{
        getURLOrDefaultInitCtx(oldName).rename(oldName, newName);
}

 public  void unbind(String name) throws NamingException 
{
        getURLOrDefaultInitCtx(name).unbind(name);
}

 public  void unbind(Name name) throws NamingException 
{
        getURLOrDefaultInitCtx(name).unbind(name);
}