|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.objectweb.jonas.naming.java.javaURLContext
public class javaURLContext
Context implementation for the "java:" namespace. Package must be named .../java (See Initial Context) Most operations consist of retrieving the actual CompNamingContext and sending it the operation for processing.
Field Summary |
---|
Fields inherited from interface javax.naming.Context |
---|
APPLET, AUTHORITATIVE, BATCHSIZE, DNS_URL, INITIAL_CONTEXT_FACTORY, LANGUAGE, OBJECT_FACTORIES, PROVIDER_URL, REFERRAL, SECURITY_AUTHENTICATION, SECURITY_CREDENTIALS, SECURITY_PRINCIPAL, SECURITY_PROTOCOL, STATE_FACTORIES, URL_PKG_PREFIXES |
Constructor Summary | |
---|---|
javaURLContext(java.util.Hashtable env)
Constructor |
Method Summary | |
---|---|
java.lang.Object |
addToEnvironment(java.lang.String propName,
java.lang.Object propVal)
Adds a new environment property to the environment of this context. |
void |
bind(javax.naming.Name name,
java.lang.Object obj)
Binds a name to an object. |
void |
bind(java.lang.String name,
java.lang.Object obj)
Binds a name to an object. |
void |
close()
Closes this context. |
javax.naming.Name |
composeName(javax.naming.Name name,
javax.naming.Name prefix)
Composes the name of this context with a name relative to this context. |
java.lang.String |
composeName(java.lang.String name,
java.lang.String prefix)
Composes the name of this context with a name relative to this context. |
javax.naming.Context |
createSubcontext(javax.naming.Name name)
Creates and binds a new context. |
javax.naming.Context |
createSubcontext(java.lang.String name)
Creates and binds a new context. |
void |
destroySubcontext(javax.naming.Name name)
Destroys the named context and removes it from the namespace. |
void |
destroySubcontext(java.lang.String name)
Destroys the named context and removes it from the namespace. |
java.util.Hashtable |
getEnvironment()
Retrieves the environment in effect for this context. |
java.lang.String |
getNameInNamespace()
Retrieves the full name of this context within its own namespace. |
javax.naming.NameParser |
getNameParser(javax.naming.Name name)
Retrieves the parser associated with the named context. |
javax.naming.NameParser |
getNameParser(java.lang.String name)
Retrieves the parser associated with the named context. |
javax.naming.NamingEnumeration |
list(javax.naming.Name name)
Enumerates the names bound in the named context, along with the class names of objects bound to them. |
javax.naming.NamingEnumeration |
list(java.lang.String name)
Enumerates the names bound in the named context, along with the class names of objects bound to them. |
javax.naming.NamingEnumeration |
listBindings(javax.naming.Name name)
Enumerates the names bound in the named context, along with the objects bound to them. |
javax.naming.NamingEnumeration |
listBindings(java.lang.String name)
Enumerates the names bound in the named context, along with the objects bound to them. |
java.lang.Object |
lookup(javax.naming.Name name)
Retrieves the named object. |
java.lang.Object |
lookup(java.lang.String name)
Retrieves the named object. |
java.lang.Object |
lookupLink(javax.naming.Name name)
Retrieves the named object, following links except for the terminal atomic component of the name. |
java.lang.Object |
lookupLink(java.lang.String name)
Retrieves the named object, following links except for the terminal atomic component of the name. |
void |
rebind(javax.naming.Name name,
java.lang.Object obj)
Binds a name to an object, overwriting any existing binding. |
void |
rebind(java.lang.String name,
java.lang.Object obj)
Binds a name to an object, overwriting any existing binding. |
java.lang.Object |
removeFromEnvironment(java.lang.String propName)
Removes an environment property from the environment of this context. |
void |
rename(javax.naming.Name oldName,
javax.naming.Name newName)
Binds a new name to the object bound to an old name, and unbinds the old name. |
void |
rename(java.lang.String oldName,
java.lang.String newName)
Binds a new name to the object bound to an old name, and unbinds the old name. |
void |
unbind(javax.naming.Name name)
Unbinds the named object. |
void |
unbind(java.lang.String name)
Unbinds the named object. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public javaURLContext(java.util.Hashtable env) throws javax.naming.NamingException
env
- the environment
javax.naming.NamingException
- if it can be built.Method Detail |
---|
public java.lang.Object lookup(javax.naming.Name name) throws javax.naming.NamingException
lookup
in interface javax.naming.Context
name
- the name of the object to look up
javax.naming.NamingException
- if a naming exception is encounteredpublic java.lang.Object lookup(java.lang.String name) throws javax.naming.NamingException
lookup
in interface javax.naming.Context
name
- the name of the object to look up
javax.naming.NamingException
- if a naming exception is encounteredpublic void bind(javax.naming.Name name, java.lang.Object obj) throws javax.naming.NamingException
bind
in interface javax.naming.Context
name
- the name to bind; may not be emptyobj
- the object to bind; possibly null
NameAlreadyBoundException
- if name is already bound
javax.naming.directory.InvalidAttributesException
- if object did not supply all mandatory attributes
javax.naming.NamingException
- if a naming exception is encounteredbind(String, Object)
,
rebind(Name, Object)
,
DirContext.bind(Name, Object,
javax.naming.directory.Attributes)
public void bind(java.lang.String name, java.lang.Object obj) throws javax.naming.NamingException
bind
in interface javax.naming.Context
name
- the name to bind; may not be emptyobj
- the object to bind; possibly null
NameAlreadyBoundException
- if name is already bound
javax.naming.directory.InvalidAttributesException
- if object did not supply all mandatory attributes
javax.naming.NamingException
- if a naming exception is encounteredpublic void rebind(javax.naming.Name name, java.lang.Object obj) throws javax.naming.NamingException
rebind
in interface javax.naming.Context
name
- the name to bind; may not be emptyobj
- the object to bind; possibly null
javax.naming.directory.InvalidAttributesException
- if object did not supply all mandatory attributes
javax.naming.NamingException
- if a naming exception is encounteredpublic void rebind(java.lang.String name, java.lang.Object obj) throws javax.naming.NamingException
rebind(Name, Object)
for details.
rebind
in interface javax.naming.Context
name
- the name to bind; may not be emptyobj
- the object to bind; possibly null
javax.naming.directory.InvalidAttributesException
- if object did not supply all mandatory attributes
javax.naming.NamingException
- if a naming exception is encounteredpublic void unbind(javax.naming.Name name) throws javax.naming.NamingException
unbind
in interface javax.naming.Context
name
- the name to unbind; may not be empty
javax.naming.NameNotFoundException
- if an intermediate context does not exist
javax.naming.NamingException
- if a naming exception is encounteredunbind(String)
public void unbind(java.lang.String name) throws javax.naming.NamingException
unbind(Name)
for details.
unbind
in interface javax.naming.Context
name
- the name to unbind; may not be empty
javax.naming.NameNotFoundException
- if an intermediate context does not exist
javax.naming.NamingException
- if a naming exception is encounteredpublic void rename(javax.naming.Name oldName, javax.naming.Name newName) throws javax.naming.NamingException
rename
in interface javax.naming.Context
oldName
- the name of the existing binding; may not be emptynewName
- the name of the new binding; may not be empty
javax.naming.NamingException
- if a naming exception is encounteredpublic void rename(java.lang.String oldName, java.lang.String newName) throws javax.naming.NamingException
rename
in interface javax.naming.Context
oldName
- the name of the existing binding; may not be emptynewName
- the name of the new binding; may not be empty
javax.naming.NamingException
- if a naming exception is encounteredpublic javax.naming.NamingEnumeration list(javax.naming.Name name) throws javax.naming.NamingException
list
in interface javax.naming.Context
name
- the name of the context to list
javax.naming.NamingException
- if a naming exception is encounteredlist(String)
,
listBindings(Name)
,
NameClassPair
public javax.naming.NamingEnumeration list(java.lang.String name) throws javax.naming.NamingException
list(Name)
for details.
list
in interface javax.naming.Context
name
- the name of the context to list
javax.naming.NamingException
- if a naming exception is encounteredpublic javax.naming.NamingEnumeration listBindings(javax.naming.Name name) throws javax.naming.NamingException
listBindings
in interface javax.naming.Context
name
- the name of the context to list
javax.naming.NamingException
- if a naming exception is encounteredlistBindings(String)
,
list(Name)
,
Binding
public javax.naming.NamingEnumeration listBindings(java.lang.String name) throws javax.naming.NamingException
listBindings(Name)
for details.
listBindings
in interface javax.naming.Context
name
- the name of the context to list
javax.naming.NamingException
- if a naming exception is encounteredpublic void destroySubcontext(javax.naming.Name name) throws javax.naming.NamingException
destroySubcontext
in interface javax.naming.Context
name
- the name of the context to be destroyed; may not be empty
javax.naming.NameNotFoundException
- if an intermediate context does not exist
NotContextException
- if the name is bound but does not name a
context, or does not name a context of the appropriate type
ContextNotEmptyException
- if the named context is not empty
javax.naming.NamingException
- if a naming exception is encountereddestroySubcontext(String)
public void destroySubcontext(java.lang.String name) throws javax.naming.NamingException
destroySubcontext(Name)
for details.
destroySubcontext
in interface javax.naming.Context
name
- the name of the context to be destroyed; may not be empty
javax.naming.NameNotFoundException
- if an intermediate context does not exist
NotContextException
- if the name is bound but does not name a
context, or does not name a context of the appropriate type
ContextNotEmptyException
- if the named context is not empty
javax.naming.NamingException
- if a naming exception is encounteredpublic javax.naming.Context createSubcontext(javax.naming.Name name) throws javax.naming.NamingException
createSubcontext
in interface javax.naming.Context
name
- the name of the context to create; may not be empty
NameAlreadyBoundException
- if name is already bound
javax.naming.directory.InvalidAttributesException
- if creation of the subcontext requires specification of
mandatory attributes
javax.naming.NamingException
- if a naming exception is encounteredcreateSubcontext(String)
,
DirContext.createSubcontext(javax.naming.Name, javax.naming.directory.Attributes)
public javax.naming.Context createSubcontext(java.lang.String name) throws javax.naming.NamingException
createSubcontext(Name)
for details.
createSubcontext
in interface javax.naming.Context
name
- the name of the context to create; may not be empty
NameAlreadyBoundException
- if name is already bound
javax.naming.directory.InvalidAttributesException
- if creation of the subcontext requires specification of
mandatory attributes
javax.naming.NamingException
- if a naming exception is encounteredpublic java.lang.Object lookupLink(javax.naming.Name name) throws javax.naming.NamingException
lookupLink
in interface javax.naming.Context
name
- the name of the object to look up
javax.naming.NamingException
- if a naming exception is encounteredlookupLink(String)
public java.lang.Object lookupLink(java.lang.String name) throws javax.naming.NamingException
lookupLink(Name)
for details.
lookupLink
in interface javax.naming.Context
name
- the name of the object to look up
javax.naming.NamingException
- if a naming exception is encounteredpublic javax.naming.NameParser getNameParser(javax.naming.Name name) throws javax.naming.NamingException
getNameParser
in interface javax.naming.Context
name
- the name of the context from which to get the parser
javax.naming.NamingException
- if a naming exception is encounteredgetNameParser(String)
,
CompoundName
public javax.naming.NameParser getNameParser(java.lang.String name) throws javax.naming.NamingException
getNameParser(Name)
for details.
getNameParser
in interface javax.naming.Context
name
- the name of the context from which to get the parser
javax.naming.NamingException
- if a naming exception is encounteredpublic javax.naming.Name composeName(javax.naming.Name name, javax.naming.Name prefix) throws javax.naming.NamingException
composeName
in interface javax.naming.Context
name
- a name relative to this contextprefix
- the name of this context relative to one of its ancestors
javax.naming.NamingException
- if a naming exception is encounteredcomposeName(String, String)
public java.lang.String composeName(java.lang.String name, java.lang.String prefix) throws javax.naming.NamingException
composeName
in interface javax.naming.Context
name
- a name relative to this contextprefix
- the name of this context relative to one of its ancestors
javax.naming.NamingException
- if a naming exception is encounteredpublic java.lang.Object addToEnvironment(java.lang.String propName, java.lang.Object propVal) throws javax.naming.NamingException
addToEnvironment
in interface javax.naming.Context
propName
- the name of the environment property to add; may not be nullpropVal
- the value of the property to add; may not be null
javax.naming.NamingException
- if a naming exception is encounteredgetEnvironment()
,
removeFromEnvironment(String)
public java.lang.Object removeFromEnvironment(java.lang.String propName) throws javax.naming.NamingException
removeFromEnvironment
in interface javax.naming.Context
propName
- the name of the environment property to remove; may not be null
javax.naming.NamingException
- if a naming exception is encounteredgetEnvironment()
,
addToEnvironment(String, Object)
public java.util.Hashtable getEnvironment() throws javax.naming.NamingException
getEnvironment
in interface javax.naming.Context
javax.naming.NamingException
- if a naming exception is encounteredaddToEnvironment(String, Object)
,
removeFromEnvironment(String)
public void close() throws javax.naming.NamingException
close
in interface javax.naming.Context
javax.naming.NamingException
- if a naming exception is encounteredpublic java.lang.String getNameInNamespace() throws javax.naming.NamingException
getNameInNamespace
in interface javax.naming.Context
OperationNotSupportedException
- if the naming system does
not have the notion of a full name
javax.naming.NamingException
- if a naming exception is encountered
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |