NamingManager JDK 1.6)

pack-privatestatic Context getContext (Object obj, Name name, Context nameCtx, Hashtable environment) throws NamingException

Retrieves a context identified by obj, using the specified environment.

Retrieves a context identified by obj, using the specified
environment.
Used by ContinuationContext.
Returns: A context identified by obj.
Parameters:
- obj - The object identifying the context.
- name - The name of the context being returned, relative to nameCtx, or null if no name is being specified. See the getObjectInstance method for details.
- ctx - The context relative to which name is specified, or null for the default initial context. See the getObjectInstance method for details.
- environment - Environment specifying characteristics of the resulting context.
See Also: NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable),

publicstatic Context getContinuationContext (CannotProceedException cpe) throws NamingException

Creates a context in which to continue a context operation.

publicstatic Context getInitialContext (Hashtable<Object, Object> env) throws NamingException

Creates an initial context using the specified environment properties.

pack-privatestaticsynchronized ObjectFactoryBuilder getObjectFactoryBuilder ()

Used for accessing object factory builder.

pack-privatestatic ObjectFactory getObjectFactoryFromReference (Reference ref, String factoryName) throws IllegalAccessException InstantiationException MalformedURLException

Retrieves the ObjectFactory for the object identified by a reference, using the reference's factory class name and factory codebase to load in the factory's class.

publicstatic Object getObjectInstance (Object refInfo, Name name, Context nameCtx, Hashtable<Object, Object> environment) throws Exception

Creates an instance of an object for the specified object and environment.

If an object factory builder has been installed, it is used to create a factory for creating the object. Otherwise, the following rules are used to create the object:

If refInfo is a Reference or Referenceable containing a factory class name, use the named factory to create the object. Return refInfo if the factory cannot be created. Under JDK 1.1, if the factory class must be loaded from a location specified in the reference, a SecurityManager must have been installed or the factory creation will fail. If an exception is encountered while creating the factory, it is passed up to the caller.
If refInfo is a Reference or Referenceable with no factory class name, and the address or addresses are StringRefAddrs with address type "URL", try the URL context factory corresponding to each URL's scheme id to create the object (see getURLContext()). If that fails, continue to the next step.
Use the object factories specified in the Context.OBJECT_FACTORIES property of the environment, and of the provider resource file associated with nameCtx, in that order. The value of this property is a colon-separated list of factory class names that are tried in order, and the first one that succeeds in creating an object is the one used. If none of the factories can be loaded, return refInfo. If an exception is encountered while creating the object, the exception is passed up to the caller.

Service providers that implement the DirContext interface should use DirectoryManager.getObjectInstance(), not this method. Service providers that implement only the Context interface should use this method.

Note that an object factory (an object that implements the ObjectFactory interface) must be public and must have a public constructor that accepts no arguments.

The name and nameCtx parameters may optionally be used to specify the name of the object being created. name is the name of the object, relative to context nameCtx. This information could be useful to the object factory or to the object implementation. If there are several possible contexts from which the object could be named -- as will often be the case -- it is up to the caller to select one. A good rule of thumb is to select the "deepest" context available. If nameCtx is null, name is relative to the default initial context. If no name is being specified, the name parameter should be null.
Returns: An object created using refInfo; or refInfo if an object cannot be created using the algorithm described above.
Parameters:
- refInfo - The possibly null object for which to create an object.
- name - The name of this object relative to nameCtx. Specifying a name is optional; if it is omitted, name should be null.
- nameCtx - The context relative to which the name parameter is specified. If null, name is relative to the default initial context.
- environment - The possibly null environment to be used in the creation of the object factory and the object.
Throws:
- NamingException - if a naming exception was encountered while attempting to get a URL context, or if one of the factories accessed throws a NamingException.
- Exception - if one of the factories accessed throws an exception, or if an error was encountered while loading and instantiating the factory and object classes. A factory should only throw an exception if it does not want other factories to be used in an attempt to create an object. See ObjectFactory.getObjectInstance().
See Also: NamingManager.getURLContext(java.lang.String, java.util.Hashtable), ObjectFactory, ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable),

pack-privatestatic Resolver getResolver (Object obj, Name name, Context nameCtx, Hashtable environment) throws NamingException

publicstatic Object getStateToBind (Object obj, Name name, Context nameCtx, Hashtable<Object, Object> environment) throws NamingException

Retrieves the state of an object for binding.

Service providers that implement the DirContext interface should use DirectoryManager.getStateToBind(), not this method. Service providers that implement only the Context interface should use this method.

This method uses the specified state factories in the Context.STATE_FACTORIES property from the environment properties, and from the provider resource file associated with nameCtx, in that order. The value of this property is a colon-separated list of factory class names that are tried in order, and the first one that succeeds in returning the object's state is the one used. If no object's state can be retrieved in this way, return the object itself. If an exception is encountered while retrieving the state, the exception is passed up to the caller.

Note that a state factory (an object that implements the StateFactory interface) must be public and must have a public constructor that accepts no arguments.

The name and nameCtx parameters may optionally be used to specify the name of the object being created. See the description of "Name and Context Parameters" in ObjectFactory.getObjectInstance() for details.

This method may return a Referenceable object. The service provider obtaining this object may choose to store it directly, or to extract its reference (using Referenceable.getReference()) and store that instead.
Returns: The non-null object representing obj's state for binding. It could be the object (obj) itself.
Parameters:
- obj - The non-null object for which to get state to bind.
- name - The name of this object relative to nameCtx, or null if no name is specified.
- nameCtx - The context relative to which the name parameter is specified, or null if name is relative to the default initial context.
- environment - The possibly null environment to be used in the creation of the state factory and the object's state.
Throws:
- NamingException - If one of the factories accessed throws an exception, or if an error was encountered while loading and instantiating the factory and object classes. A factory should only throw an exception if it does not want other factories to be used in an attempt to create an object. See StateFactory.getStateToBind().
Since: 1.3
See Also: StateFactory, StateFactory.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable), DirectoryManager.getStateToBind(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable, javax.naming.directory.Attributes),

publicstatic Context getURLContext (String scheme, Hashtable<Object, Object> environment) throws NamingException

Creates a context for the given URL scheme id.

The resulting context is for resolving URLs of the scheme scheme. The resulting context is not tied to a specific URL. It is able to handle arbitrary URLs with the specified scheme.

The class name of the factory that creates the resulting context has the naming convention scheme-idURLContextFactory (e.g. "ftpURLContextFactory" for the "ftp" scheme-id), in the package specified as follows. The Context.URL_PKG_PREFIXES environment property (which may contain values taken from applet parameters, system properties, or application resource files) contains a colon-separated list of package prefixes. Each package prefix in the property is tried in the order specified to load the factory class. The default package prefix is "com.sun.jndi.url" (if none of the specified packages work, this default is tried). The complete package name is constructed using the package prefix, concatenated with the scheme id.

For example, if the scheme id is "ldap", and the Context.URL_PKG_PREFIXES property contains "com.widget:com.wiz.jndi", the naming manager would attempt to load the following classes until one is successfully instantiated:

com.widget.ldap.ldapURLContextFactory
com.wiz.jndi.ldap.ldapURLContextFactory
com.sun.jndi.url.ldap.ldapURLContextFactory

If none of the package prefixes work, null is returned.

If a factory is instantiated, it is invoked with the following parameters to produce the resulting context.

factory.getObjectInstance(null, environment);

For example, invoking getObjectInstance() as shown above on a LDAP URL context factory would return a context that can resolve LDAP urls (e.g. "ldap://ldap.wiz.com/o=wiz,c=us", "ldap://ldap.umich.edu/o=umich,c=us", ...).

Note that an object factory (an object that implements the ObjectFactory interface) must be public and must have a public constructor that accepts no arguments.
Returns: A context for resolving URLs with the scheme id scheme; null if the factory for creating the context is not found.
Parameters:
- scheme - The non-null scheme-id of the URLs supported by the context.
- environment - The possibly null environment properties to be used in the creation of the object factory and the context.
Throws:
- NamingException - If a naming exception occurs while creating the context.
See Also: NamingManager.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable), ObjectFactory.getObjectInstance(java.lang.Object, javax.naming.Name, javax.naming.Context, java.util.Hashtable),

publicstatic boolean hasInitialContextFactoryBuilder ()

Determines whether an initial context factory builder has been set.

pack-privatestatic Object processURLAddrs (Reference ref, Name name, Context nameCtx, Hashtable environment) throws NamingException

publicstaticsynchronized void setInitialContextFactoryBuilder (InitialContextFactoryBuilder builder) throws NamingException

Sets the InitialContextFactory builder to be builder.

publicstaticsynchronized void setObjectFactoryBuilder (ObjectFactoryBuilder builder) throws NamingException

The ObjectFactoryBuilder determines the policy used when trying to load object factories.