|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.ow2.jonas.lib.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 ComponentContext
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(Hashtable env)
Constructor |
Method Summary | |
---|---|
Object |
addToEnvironment(String propName,
Object propVal)
Adds a new environment property to the environment of this context. |
void |
bind(Name name,
Object obj)
Binds a name to an object. |
void |
bind(String name,
Object obj)
Binds a name to an object. |
void |
close()
Closes this context. |
Name |
composeName(Name name,
Name prefix)
Composes the name of this context with a name relative to this context. |
String |
composeName(String name,
String prefix)
Composes the name of this context with a name relative to this context. |
Context |
createSubcontext(Name name)
Creates and binds a new context. |
Context |
createSubcontext(String name)
Creates and binds a new context. |
void |
destroySubcontext(Name name)
Destroys the named context and removes it from the namespace. |
void |
destroySubcontext(String name)
Destroys the named context and removes it from the namespace. |
Hashtable |
getEnvironment()
Retrieves the environment in effect for this context. |
String |
getNameInNamespace()
Retrieves the full name of this context within its own namespace. |
NameParser |
getNameParser(Name name)
Retrieves the parser associated with the named context. |
NameParser |
getNameParser(String name)
Retrieves the parser associated with the named context. |
NamingEnumeration |
list(Name name)
Enumerates the names bound in the named context, along with the class names of objects bound to them. |
NamingEnumeration |
list(String name)
Enumerates the names bound in the named context, along with the class names of objects bound to them. |
NamingEnumeration |
listBindings(Name name)
Enumerates the names bound in the named context, along with the objects bound to them. |
NamingEnumeration |
listBindings(String name)
Enumerates the names bound in the named context, along with the objects bound to them. |
Object |
lookup(Name name)
Retrieves the named object. |
Object |
lookup(String name)
Retrieves the named object. |
Object |
lookupLink(Name name)
Retrieves the named object, following links except for the terminal atomic component of the name. |
Object |
lookupLink(String name)
Retrieves the named object, following links except for the terminal atomic component of the name. |
void |
rebind(Name name,
Object obj)
Binds a name to an object, overwriting any existing binding. |
void |
rebind(String name,
Object obj)
Binds a name to an object, overwriting any existing binding. |
Object |
removeFromEnvironment(String propName)
Removes an environment property from the environment of this context. |
void |
rename(Name oldName,
Name newName)
Binds a new name to the object bound to an old name, and unbinds the old name. |
void |
rename(String oldName,
String newName)
Binds a new name to the object bound to an old name, and unbinds the old name. |
void |
unbind(Name name)
Unbinds the named object. |
void |
unbind(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(Hashtable env) throws NamingException
env
- the environment (not used)
NamingException
- Never thrown.Method Detail |
---|
public Object lookup(Name name) throws NamingException
lookup
in interface Context
name
- the name of the object to look up
NamingException
- if a naming exception is encounteredpublic Object lookup(String name) throws NamingException
lookup
in interface Context
name
- the name of the object to look up
NamingException
- if a naming exception is encounteredpublic void bind(Name name, Object obj) throws NamingException
bind
in interface Context
name
- the name to bind; may not be emptyobj
- the object to bind; possibly null
NameAlreadyBoundException
- if name is already bound
InvalidAttributesException
- if object did not supply all mandatory attributes
NamingException
- if a naming exception is encounteredbind(String, Object)
,
rebind(Name, Object)
,
DirContext.bind(Name, Object,
javax.naming.directory.Attributes)
public void bind(String name, Object obj) throws NamingException
bind
in interface Context
name
- the name to bind; may not be emptyobj
- the object to bind; possibly null
NameAlreadyBoundException
- if name is already bound
InvalidAttributesException
- if object did not supply all mandatory attributes
NamingException
- if a naming exception is encounteredpublic void rebind(Name name, Object obj) throws NamingException
rebind
in interface Context
name
- the name to bind; may not be emptyobj
- the object to bind; possibly null
InvalidAttributesException
- if object did not supply all mandatory attributes
NamingException
- if a naming exception is encounteredpublic void rebind(String name, Object obj) throws NamingException
rebind(Name, Object)
for details.
rebind
in interface Context
name
- the name to bind; may not be emptyobj
- the object to bind; possibly null
InvalidAttributesException
- if object did not supply all mandatory attributes
NamingException
- if a naming exception is encounteredpublic void unbind(Name name) throws NamingException
unbind
in interface Context
name
- the name to unbind; may not be empty
NameNotFoundException
- if an intermediate context does not exist
NamingException
- if a naming exception is encounteredunbind(String)
public void unbind(String name) throws NamingException
unbind(Name)
for details.
unbind
in interface Context
name
- the name to unbind; may not be empty
NameNotFoundException
- if an intermediate context does not exist
NamingException
- if a naming exception is encounteredpublic void rename(Name oldName, Name newName) throws NamingException
rename
in interface Context
oldName
- the name of the existing binding; may not be emptynewName
- the name of the new binding; may not be empty
NamingException
- if a naming exception is encounteredpublic void rename(String oldName, String newName) throws NamingException
rename
in interface Context
oldName
- the name of the existing binding; may not be emptynewName
- the name of the new binding; may not be empty
NamingException
- if a naming exception is encounteredpublic NamingEnumeration list(Name name) throws NamingException
list
in interface Context
name
- the name of the context to list
NamingException
- if a naming exception is encounteredlist(String)
,
listBindings(Name)
,
NameClassPair
public NamingEnumeration list(String name) throws NamingException
list(Name)
for details.
list
in interface Context
name
- the name of the context to list
NamingException
- if a naming exception is encounteredpublic NamingEnumeration listBindings(Name name) throws NamingException
listBindings
in interface Context
name
- the name of the context to list
NamingException
- if a naming exception is encounteredlistBindings(String)
,
list(Name)
,
Binding
public NamingEnumeration listBindings(String name) throws NamingException
listBindings(Name)
for details.
listBindings
in interface Context
name
- the name of the context to list
NamingException
- if a naming exception is encounteredpublic void destroySubcontext(Name name) throws NamingException
destroySubcontext
in interface Context
name
- the name of the context to be destroyed; may not be empty
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
NamingException
- if a naming exception is encountereddestroySubcontext(String)
public void destroySubcontext(String name) throws NamingException
destroySubcontext(Name)
for details.
destroySubcontext
in interface Context
name
- the name of the context to be destroyed; may not be empty
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
NamingException
- if a naming exception is encounteredpublic Context createSubcontext(Name name) throws NamingException
createSubcontext
in interface Context
name
- the name of the context to create; may not be empty
NameAlreadyBoundException
- if name is already bound
InvalidAttributesException
- if creation of the subcontext requires specification of
mandatory attributes
NamingException
- if a naming exception is encounteredcreateSubcontext(String)
,
DirContext.createSubcontext(javax.naming.Name, javax.naming.directory.Attributes)
public Context createSubcontext(String name) throws NamingException
createSubcontext(Name)
for details.
createSubcontext
in interface Context
name
- the name of the context to create; may not be empty
NameAlreadyBoundException
- if name is already bound
InvalidAttributesException
- if creation of the subcontext requires specification of
mandatory attributes
NamingException
- if a naming exception is encounteredpublic Object lookupLink(Name name) throws NamingException
lookupLink
in interface Context
name
- the name of the object to look up
NamingException
- if a naming exception is encounteredlookupLink(String)
public Object lookupLink(String name) throws NamingException
lookupLink(Name)
for details.
lookupLink
in interface Context
name
- the name of the object to look up
NamingException
- if a naming exception is encounteredpublic NameParser getNameParser(Name name) throws NamingException
getNameParser
in interface Context
name
- the name of the context from which to get the parser
NamingException
- if a naming exception is encounteredgetNameParser(String)
,
CompoundName
public NameParser getNameParser(String name) throws NamingException
getNameParser(Name)
for details.
getNameParser
in interface Context
name
- the name of the context from which to get the parser
NamingException
- if a naming exception is encounteredpublic Name composeName(Name name, Name prefix) throws NamingException
composeName
in interface Context
name
- a name relative to this contextprefix
- the name of this context relative to one of its ancestors
NamingException
- if a naming exception is encounteredcomposeName(String, String)
public String composeName(String name, String prefix) throws NamingException
composeName
in interface Context
name
- a name relative to this contextprefix
- the name of this context relative to one of its ancestors
NamingException
- if a naming exception is encounteredpublic Object addToEnvironment(String propName, Object propVal) throws NamingException
addToEnvironment
in interface 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
NamingException
- if a naming exception is encounteredgetEnvironment()
,
removeFromEnvironment(String)
public Object removeFromEnvironment(String propName) throws NamingException
removeFromEnvironment
in interface Context
propName
- the name of the environment property to remove; may not be null
NamingException
- if a naming exception is encounteredgetEnvironment()
,
addToEnvironment(String, Object)
public Hashtable getEnvironment() throws NamingException
getEnvironment
in interface Context
NamingException
- if a naming exception is encounteredaddToEnvironment(String, Object)
,
removeFromEnvironment(String)
public void close() throws NamingException
close
in interface Context
NamingException
- if a naming exception is encounteredpublic String getNameInNamespace() throws NamingException
getNameInNamespace
in interface Context
OperationNotSupportedException
- if the naming system does
not have the notion of a full name
NamingException
- if a naming exception is encountered
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |