|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjavax.naming.spi.NamingManager
public class NamingManager
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.
Field Summary | |
---|---|
static String |
CPE
The environment property into which getContinuationContext() stores the value of the CannotProceedException parameter. |
Method Summary | |
---|---|
static Context |
getContinuationContext(CannotProceedException cpe)
Creates a context in which the context operation must be continued. |
static Context |
getInitialContext(Hashtable<?,?> environment)
Creates the initial context. |
static Object |
getObjectInstance(Object refInfo,
Name name,
Context nameCtx,
Hashtable<?,?> environment)
Creates an object for the specified name context, environment and referencing context object. |
static Object |
getStateToBind(Object obj,
Name name,
Context nameCtx,
Hashtable<?,?> environment)
Get the object state for binding. |
static Context |
getURLContext(String scheme,
Hashtable<?,?> environment)
Creates the URL context for the given URL scheme id. |
static boolean |
hasInitialContextFactoryBuilder()
Checks if the initial context factory builder has been set. |
static void |
setInitialContextFactoryBuilder(InitialContextFactoryBuilder builder)
Sets the initial context factory builder. |
static void |
setObjectFactoryBuilder(ObjectFactoryBuilder builder)
Sets the initial object factory builder. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final String CPE
Method Detail |
---|
public static boolean hasInitialContextFactoryBuilder()
setInitialContextFactoryBuilder(InitialContextFactoryBuilder)
public static Context getInitialContext(Hashtable<?,?> environment) throws NamingException
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.
environment
- the properties, used to create the context.
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.
NamingException
- if throws by the context factorypublic static Context getURLContext(String scheme, Hashtable<?,?> environment) throws NamingException
Creates the URL context for the given URL scheme id.
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.
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.
After the factory is instantiated, its method
ObjectFactory.getObjectInstance(Object, Name, Context, Hashtable)
is called to create and return the object instance.
scheme
- the url scheme that must be supported by the given contextenvironment
- the properties for creating the factory and context
(may be null)
NamingException
- if thrown by the factory when creating the
context.public static void setObjectFactoryBuilder(ObjectFactoryBuilder builder) throws NamingException
builder
- the builder to set
SecurityException
- if the builder cannot be installed due
security restrictions.
NamingException
- if the builder cannot be installed due other
reasons
IllegalStateException
- if setting the builder repeatedlypublic static Object getObjectInstance(Object refInfo, Name name, Context nameCtx, Hashtable<?,?> environment) throws Exception
Creates an object for the specified name context, environment and referencing context object.
If the builder factory is set by
setObjectFactoryBuilder(ObjectFactoryBuilder)
, the call is
delegated to that factory. Otherwise, the object is created using the
following rules:
The object factory must be public and have the public parameterless constructor.
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 Reference
or Referenceable
.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.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.environment
- contains additional information for creating the object.
This paramter can be null if there is no need to provide any
additional information.
NamingException
- if the attempt to name the new object has failed
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 void setInitialContextFactoryBuilder(InitialContextFactoryBuilder builder) throws NamingException
builder
- the builder to set
SecurityException
- if the builder cannot be installed due
security restrictions.
NamingException
- if the builder cannot be installed due other
reasons
IllegalStateException
- if setting the builder repeatedlyhasInitialContextFactoryBuilder()
public static Context getContinuationContext(CannotProceedException cpe) throws NamingException
cpe
- the exception that triggered this continuation. This method
obtains the environment (CannotProceedException.getEnvironment()
and sets the environment property CPE
= cpe.
NamingException
- if the naming problems have occuredpublic static Object getStateToBind(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment) throws NamingException
obj
- the object, for that the binding state must be retrieved. Cannot
be null.name
- the name of this object, related to the nameCtx. Can be null if
not specified.nameCtx
- the naming context, to that the object name is related. Can
be null if the name is related to the initial default context.environment
- the properties for creating the object state. Can be
null if no properties are provided.
NamingException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |