|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.objectweb.carol.jndi.spi.AbsContext
public abstract class AbsContext
This abstract class define the common methods used for all existing protocol implementation of their SPI context. When integrating a new protocol, define a new SPI class extending this one. You only have to focus on specific implementation and let in major case all default implementation.
Nested Class Summary | |
---|---|
protected class |
AbsContext.WrappedEnumeration
This class is used to return a naming enumeration by decoding encoded names |
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 | |
---|---|
protected |
AbsContext(javax.naming.Context ctx)
Constructs a wrapper on the given protocol context |
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. |
protected java.lang.Object |
addToExported(javax.naming.Name name,
java.lang.Object o)
Adds a new object to the list of exported objects |
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. |
protected java.lang.String |
decode(java.lang.String name)
undo what encode() does |
protected java.lang.Object |
defaultUnwrapObject(java.lang.Object o,
javax.naming.Name name)
Default implementation of unwrapObject method If this object is a reference wrapper return the reference If this object is a resource wrapper return the resource |
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. |
protected javax.naming.Name |
encode(javax.naming.Name initialName)
Hide special characters from flat namespace registry. |
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. |
protected int |
getObjectPort()
Get the object port to use (0 by default, declare this method in a subclass if you want to change value) |
protected javax.naming.Context |
getWrappedContext()
|
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. |
protected abstract java.lang.Object |
unwrapObject(java.lang.Object o,
javax.naming.Name name)
If this object is a reference wrapper return the reference If this object is a resource wrapper return the resource |
protected abstract java.lang.Object |
wrapObject(java.lang.Object o,
javax.naming.Name name,
boolean replace)
Wrap an Object : If the object is a reference wrap it into a Reference Wrapper Object here the good way is to contact the carol configuration to get the portable remote object |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
protected AbsContext(javax.naming.Context ctx)
ctx
- the given context (could be jrmp context, jeremie context,
iiop context,...).Method Detail |
---|
protected abstract java.lang.Object unwrapObject(java.lang.Object o, javax.naming.Name name) throws javax.naming.NamingException
o
- the object to resolvename
- name of the object to unwrap
javax.naming.NamingException
- if the object cannot be unwrapedprotected abstract java.lang.Object wrapObject(java.lang.Object o, javax.naming.Name name, boolean replace) throws javax.naming.NamingException
o
- the object to encodename
- of the objectreplace
- if the object need to be replaced
Remote JNDIRemoteReference Object
if o is a
resource o if else
javax.naming.NamingException
- if object cannot be wrappedprotected java.lang.Object defaultUnwrapObject(java.lang.Object o, javax.naming.Name name) throws javax.naming.NamingException
o
- the object to resolvename
- name of the object to unwrap
javax.naming.NamingException
- if the object cannot be unwrapedprotected int getObjectPort()
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
javax.naming.NamingException
- if a naming exception is encounteredpublic 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
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.NamingException
- if a naming exception is encounteredpublic void rebind(java.lang.String 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.NamingException
- if a naming exception is encounteredpublic void unbind(javax.naming.Name name) throws javax.naming.NamingException
name
from the target context--that named by all but the
terminal atomic part of name
.
unbind
in interface javax.naming.Context
name
- the name to unbind; may not be empty
javax.naming.NamingException
- if a naming exception is encounteredpublic void unbind(java.lang.String name) throws javax.naming.NamingException
unbind
in interface javax.naming.Context
name
- the name to unbind; may not be empty
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 encounteredpublic javax.naming.NamingEnumeration list(java.lang.String 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 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 encounteredpublic javax.naming.NamingEnumeration listBindings(java.lang.String 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 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.NamingException
- if a naming exception is encounteredpublic void destroySubcontext(java.lang.String 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.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
javax.naming.NamingException
- if a naming exception is encounteredpublic javax.naming.Context createSubcontext(java.lang.String name) throws javax.naming.NamingException
createSubcontext
in interface javax.naming.Context
name
- the name of the context to create; may not be empty
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 encounteredpublic java.lang.Object lookupLink(java.lang.String 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 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 encounteredpublic javax.naming.NameParser getNameParser(java.lang.String 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 encounteredpublic 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
prefix
and name
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
prefix
and name
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 encounteredpublic 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 encounteredpublic java.util.Hashtable getEnvironment() throws javax.naming.NamingException
getEnvironment
in interface javax.naming.Context
javax.naming.NamingException
- if a naming exception is encounteredpublic 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
javax.naming.NamingException
- if a naming exception is encounteredprotected java.lang.Object addToExported(javax.naming.Name name, java.lang.Object o)
name
- JNDI name of the exported objecto
- exported object
protected javax.naming.Context getWrappedContext()
protected javax.naming.Name encode(javax.naming.Name initialName)
initialName
- the name to encode
protected java.lang.String decode(java.lang.String name)
name
- to decode
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |