|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Context
Field Summary | |
---|---|
static String |
APPLET
Property for the initial context constructor to use when searching for other properties. |
static String |
AUTHORITATIVE
Property with the authoritativeness of the service requested. |
static String |
BATCHSIZE
Property with the batch size to use when returning data via the service's protocol. |
static String |
DNS_URL
Property with the DNS host and domain names to use. |
static String |
INITIAL_CONTEXT_FACTORY
Property with name of the inital context factory to use |
static String |
LANGUAGE
Property for specifying the preferred language to use with the service. |
static String |
OBJECT_FACTORIES
Property with colon-separated list of object factories to use. |
static String |
PROVIDER_URL
Property with URL specifying configuration for the service provider to use. |
static String |
REFERRAL
Property defining how referrals encountered by the service provider are to be processed. |
static String |
SECURITY_AUTHENTICATION
Property specifying the security level to use. |
static String |
SECURITY_CREDENTIALS
Property specifying the credentials of the principal for authenticating the caller to the service. |
static String |
SECURITY_PRINCIPAL
Property for the identity of the principal for authenticating the caller to the service. |
static String |
SECURITY_PROTOCOL
Property specifying the security protocol to use. |
static String |
STATE_FACTORIES
Property with colon-separated list of state factories to use. |
static String |
URL_PKG_PREFIXES
Property with colon-separated list of package prefixes to use. |
Method Summary | |
---|---|
Object |
addToEnvironment(String propName,
Object propVal)
Add new environment property to the environment of this context. |
void |
bind(Name name,
Object obj)
Give the specified name for the specified object. |
void |
bind(String name,
Object obj)
Give the specified name for the specified object. |
void |
close()
Releases all resources, associated with this context. |
Name |
composeName(Name name,
Name prefix)
Composes the name of this context together with another name, related to this context. |
String |
composeName(String name,
String prefix)
Composes the name of this context together with another name, related to this context. |
Context |
createSubcontext(Name name)
Creates the new naming subcontext and binds it to the current (this) context. |
Context |
createSubcontext(String name)
Creates the new naming subcontext and binds it to the current (this) context. |
void |
destroySubcontext(Name name)
Removes the naming subcontext from this naming context. |
void |
destroySubcontext(String name)
Removes the naming subcontext from this naming context. |
Hashtable<?,?> |
getEnvironment()
Returns the environment, associated with this naming context. |
String |
getNameInNamespace()
Returs the full name of this naming context. |
NameParser |
getNameParser(Name name)
Obtains the name parser for parsing the names of the given naming subcontext. |
NameParser |
getNameParser(String name)
Obtains the name parser for parsing the names of the given naming subcontext. |
NamingEnumeration<NameClassPair> |
list(Name name)
Creates and returns the enumeration over the name bindings that are present the given subcontext. |
NamingEnumeration<NameClassPair> |
list(String name)
Creates and returns the enumeration over the name bindings that are present the given subcontext. |
NamingEnumeration<Binding> |
listBindings(Name name)
Creates and returns the enumeration over the name - object bindings that are present the given subcontext. |
NamingEnumeration<Binding> |
listBindings(String name)
Creates and returns the enumeration over the name - object bindings that are present the given subcontext. |
Object |
lookup(Name name)
Gets the previously named object by name. |
Object |
lookup(String name)
Gets the previously named object by name. |
Object |
lookupLink(Name name)
Retrieves the named object, not following the link of the terminal atomic component of the name. |
Object |
lookupLink(String name)
Retrieves the named object, not following the link of the terminal atomic component of the name. |
void |
rebind(Name name,
Object obj)
Give the specified name for the specified object. |
void |
rebind(String name,
Object obj)
Give the specified name for the specified object. |
Object |
removeFromEnvironment(String propName)
Removes the property with the given name from the environment. |
void |
rename(Name oldName,
Name newName)
Renames the existing binding, removing the existing and giving the new name for the same object. |
void |
rename(String oldName,
String newName)
Renames the existing binding, removing the existing and giving the new name for the same object. |
void |
unbind(Name name)
Removes the name - object mapping from the current context. |
void |
unbind(String name)
Removes the name - object mapping from the current context. |
Field Detail |
---|
static final String INITIAL_CONTEXT_FACTORY
static final String OBJECT_FACTORIES
static final String STATE_FACTORIES
static final String URL_PKG_PREFIXES
static final String PROVIDER_URL
static final String DNS_URL
static final String AUTHORITATIVE
static final String BATCHSIZE
static final String REFERRAL
static final String SECURITY_PROTOCOL
static final String SECURITY_AUTHENTICATION
static final String SECURITY_PRINCIPAL
static final String SECURITY_CREDENTIALS
static final String LANGUAGE
static final String APPLET
Method Detail |
---|
void bind(Name name, Object obj) throws NamingException
name
- the name that will be given to the object (in the scope of this
context).obj
- the object being named.
NameAlreadyBoundException
- if this name is already used to name some
object.
InvalidAttributesException
- if the object does not supply all
required attributes.
NamingException
- if the naming operation has failed due other
reasons.void bind(String name, Object obj) throws NamingException
name
- the name that will be given to the object (in the scope of this
context).obj
- the object being named.
NameAlreadyBoundException
- if this name is already used to name some
object.
InvalidAttributesException
- if the object does not supply all
required attributes.
NamingException
- if the naming operation has failed due other
reasons.Object lookup(Name name) throws NamingException
name
- the name of the object being searched in this context
NamingException
- if the naming fails.Object lookup(String name) throws NamingException
name
- the name of the object being searched in this context
NamingException
- if the naming fails.void rebind(Name name, Object obj) throws NamingException
name
- the name that will be given to the object (in the scope of this
context).obj
- the object being named.
InvalidAttributesException
- if the object does not supply all
required attributes.
NamingException
- if the naming operation has failed due other
reasons.void rebind(String name, Object obj) throws NamingException
name
- the name that will be given to the object (in the scope of this
context).obj
- the object being named.
InvalidAttributesException
- if the object does not supply all
required attributes.
NamingException
- if the naming operation has failed due other
reasons.void unbind(Name name) throws NamingException
NameNotFoundException
if one of the
intermadiate contexts does not exist.
name
- the name to be removed
NameNotFoundException
- if one of the intermediate naming contexts
does not exist. Will not be thrown if just the terminal binding
is missing.
NamingException
- if the naming operation has failed due other
reasons.void unbind(String name) throws NamingException
NameNotFoundException
if one of the
intermadiate contexts does not exist.
name
- the name to be removed
NameNotFoundException
- if one of the intermediate naming contexts
does not exist. Will not be thrown if just the terminal binding
is missing.
NamingException
- if the naming operation has failed due other
reasons.void rename(Name oldName, Name newName) throws NamingException
oldName
- the existing name of the known objectnewName
- the new name of the same object
NameNotFoundException
- if the oldName is unknown for this context
NamingException
- if the naming operation has failed due other
reasons.void rename(String oldName, String newName) throws NamingException
oldName
- the existing name of the known objectnewName
- the new name of the same object
NameNotFoundException
- if the oldName is unknown for this context
NamingException
- if the naming operation has failed due other
reasons.NamingEnumeration<NameClassPair> list(Name name) throws NamingException
NameClassPair
, providing also information about the class of the
bound object. The behaviour in the case if the bindings are added or
removed later is not defined. The contents of the subcontexts are not
included.
name
- the name of the subcontext
NamingException
NamingEnumeration<NameClassPair> list(String name) throws NamingException
NameClassPair
, providing also information about the class of the
bound object. The behaviour in the case if the bindings are added or
removed later is not defined. The contents of the subcontexts are not
included.
name
- the name of the subcontext
NamingException
NamingEnumeration<Binding> listBindings(Name name) throws NamingException
Binding
, providing also information about the class of the bound
object. The behaviour in the case if the bindings are added or removed
later is not defined. The contents of the subcontexts are not included.
name
- the name of the subcontext
NamingException
NamingEnumeration<Binding> listBindings(String name) throws NamingException
Binding
, providing also information about the class of the bound
object. The behaviour in the case if the bindings are added or removed
later is not defined. The contents of the subcontexts are not included.
name
- the name of the subcontext
NamingException
Context createSubcontext(Name name) throws NamingException
name
- the name of the new context being created
NameAlreadyBoundException
- if this name is already bound
InvalidAttributesException
- if the creation of the new context
requires the missing mandatory attributes
NamingException
Context createSubcontext(String name) throws NamingException
name
- the name of the new context being created
NameAlreadyBoundException
- if this name is already bound
InvalidAttributesException
- if the creation of the new context
requires the missing mandatory attributes
NamingException
void destroySubcontext(Name name) throws NamingException
name
- the name of the subcontext beig removed.
ContextNotEmptyException
- if the named context is not empty.
NamingException
void destroySubcontext(String name) throws NamingException
name
- the name of the subcontext beig removed.
ContextNotEmptyException
- if the named context is not empty.
NamingException
Object lookupLink(Name name) throws NamingException
name
- the name of the object that may be a link, leading to another
object.
NamingException
Object lookupLink(String name) throws NamingException
name
- the name of the object that may be a link, leading to another
object.
NamingException
NameParser getNameParser(Name name) throws NamingException
name
- the name of the subcontext for that the parser must be obtained
NamingException
NameParser getNameParser(String name) throws NamingException
name
- the name of the subcontext for that the parser must be obtained
NamingException
Name composeName(Name name, Name prefix) throws NamingException
name
- a name, defined in the scope of this contextprefix
- a name of this context itself, defined in the scope of some
ancestor
NamingException
String composeName(String name, String prefix) throws NamingException
name
- a name, defined in the scope of this contextprefix
- a name of this context itself, defined in the scope of some
ancestor
NamingException
Object addToEnvironment(String propName, Object propVal) throws NamingException
propName
- the name of the new propertypropVal
- the value of the new property
NamingException
Object removeFromEnvironment(String propName) throws NamingException
propName
- the name of the property being removed.
NamingException
Hashtable<?,?> getEnvironment() throws NamingException
addToEnvironment(java.lang.String, java.lang.Object)
and removeFromEnvironment(java.lang.String)
to modify the environement, if needed.
NamingException
void close() throws NamingException
NamingException
String getNameInNamespace() throws NamingException
OperationNotSupportedException
- if the naming system, represented by
this context, does not support the notation of the full name.
NamingException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |