com.sun.enterprise.naming.impl
Class SerialContext

java.lang.Object
  com.sun.enterprise.naming.impl.SerialContext

All Implemented Interfaces:

javax.naming.Context

public class SerialContext
extends java.lang.Object
implements javax.naming.Context

This context provides access to the app server naming service. This is the default Context for GlassFish. Lookups of unqualified names (i.e. names not starting with "java:", "corbaname:" etc) are serviced by SerialContext. The namespace is implemented in the SerialContextProviderImpl object, which is accessed directly in the case that the client is collocated with the naming service impl or remotely via RMI-IIOP if not collocated.

NOT THREAD SAFE: mutable instance variables

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

SerialContext(java.util.Hashtable env, org.jvnet.hk2.component.Habitat habitat)
This constructor takes the component id as an argument.

SerialContext(java.lang.String name, java.util.Hashtable environment, org.jvnet.hk2.component.Habitat h)
Constructor for the context.

Method Summary

java.lang.Object	addToEnvironment(java.lang.String propName, java.lang.Object propVal) Add to the environment for the current context.
void	bind(javax.naming.Name name, java.lang.Object obj) Bind the object to the specified name.
void	bind(java.lang.String name, java.lang.Object obj) Bind the object to the specified name.
void	close() Set the environment for the current context to null when close is called.
javax.naming.Name	composeName(javax.naming.Name name, javax.naming.Name prefix)
java.lang.String	composeName(java.lang.String name, java.lang.String prefix)
javax.naming.Context	createSubcontext(javax.naming.Name name) Create the specified subcontext.
javax.naming.Context	createSubcontext(java.lang.String name) Create the specified subcontext.
void	destroySubcontext(javax.naming.Name name) Destroy the specified subcontext.
void	destroySubcontext(java.lang.String name) Destroy the specified subcontext.
java.util.Hashtable	getEnvironment() Return the environment for the current context.
java.lang.String	getNameInNamespace() The getNameInNamespace API is not supported in this context.
javax.naming.NameParser	getNameParser(javax.naming.Name name) Allow access to the name parser object.
javax.naming.NameParser	getNameParser(java.lang.String name) Allow access to the name parser object.
javax.naming.NamingEnumeration<javax.naming.NameClassPair>	list(javax.naming.Name name) List the contents of the specified context.
javax.naming.NamingEnumeration<javax.naming.NameClassPair>	list(java.lang.String name) List the contents of the specified context.
javax.naming.NamingEnumeration<javax.naming.Binding>	listBindings(javax.naming.Name name) List the bindings in the specified context.
javax.naming.NamingEnumeration<javax.naming.Binding>	listBindings(java.lang.String name) List the bindings in the specified context.
java.lang.Object	lookup(javax.naming.Name name) Lookup the specifed name in the context.
java.lang.Object	lookup(java.lang.String name) Lookup the specified name in the context.
java.lang.Object	lookupLink(javax.naming.Name name) Links are not treated specially.
java.lang.Object	lookupLink(java.lang.String name) Links are not treated specially.
void	rebind(javax.naming.Name name, java.lang.Object obj) Rebind the object to the specified name.
void	rebind(java.lang.String name, java.lang.Object obj) Rebind the object to the specified name.
java.lang.Object	removeFromEnvironment(java.lang.String propName) Remove from the environment for the current context.
void	rename(javax.naming.Name oldname, javax.naming.Name newname) Rename the bound object.
void	rename(java.lang.String oldname, java.lang.String newname) Rename the bound object.
java.lang.String	toString()
void	unbind(javax.naming.Name name) Unbind the object with the specified name.
void	unbind(java.lang.String name) Unbind the object with the specified name.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SerialContext

public SerialContext(java.lang.String name,
                     java.util.Hashtable environment,
                     org.jvnet.hk2.component.Habitat h)
              throws javax.naming.NamingException

Constructor for the context. Initializes the object reference to the remote provider object.

Throws:

javax.naming.NamingException

SerialContext

public SerialContext(java.util.Hashtable env,
                     org.jvnet.hk2.component.Habitat habitat)
              throws javax.naming.NamingException

This constructor takes the component id as an argument. All name arguments to operations are prepended by the component id.

Throws:

javax.naming.NamingException

Method Detail

getNameInNamespace

public java.lang.String getNameInNamespace()
                                    throws javax.naming.NamingException

The getNameInNamespace API is not supported in this context.

Specified by:

getNameInNamespace in interface javax.naming.Context

Throws:

javax.naming.NamingException - if there is a naming exception.

lookup

public java.lang.Object lookup(java.lang.String name)
                        throws javax.naming.NamingException

Lookup the specified name in the context. Returns the resolved object.

Specified by:

lookup in interface javax.naming.Context

Returns:

the resolved object.

Throws:

javax.naming.NamingException - if there is a naming exception.

lookup

public java.lang.Object lookup(javax.naming.Name name)
                        throws javax.naming.NamingException

Lookup the specifed name in the context. Returns the resolved object.

Specified by:

lookup in interface javax.naming.Context

Returns:

the resolved object.

Throws:

javax.naming.NamingException - if there is a naming exception.

bind

public void bind(java.lang.String name,
                 java.lang.Object obj)
          throws javax.naming.NamingException

Bind the object to the specified name.

Specified by:

bind in interface javax.naming.Context

Parameters:

name - name that the object is being bound to.

obj - object that is being bound.

Throws:

javax.naming.NamingException - if there is a naming exception.

bind

public void bind(javax.naming.Name name,
                 java.lang.Object obj)
          throws javax.naming.NamingException

Bind the object to the specified name.

Specified by:

bind in interface javax.naming.Context

Parameters:

name - name that the object is being bound to.

obj - object that is being bound.

Throws:

javax.naming.NamingException - if there is a naming exception.

rebind

public void rebind(java.lang.String name,
                   java.lang.Object obj)
            throws javax.naming.NamingException

Rebind the object to the specified name.

Specified by:

rebind in interface javax.naming.Context

Parameters:

name - name that the object is being bound to.

obj - object that is being bound.

Throws:

javax.naming.NamingException - if there is a naming exception.

rebind

public void rebind(javax.naming.Name name,
                   java.lang.Object obj)
            throws javax.naming.NamingException

Rebind the object to the specified name.

Specified by:

rebind in interface javax.naming.Context

Parameters:

name - name that the object is being bound to.

obj - object that is being bound.

Throws:

javax.naming.NamingException - if there is a naming exception.

unbind

public void unbind(java.lang.String name)
            throws javax.naming.NamingException

Unbind the object with the specified name.

Specified by:

unbind in interface javax.naming.Context

Parameters:

name - that is being unbound.

Throws:

javax.naming.NamingException - if there is a naming exception.

unbind

public void unbind(javax.naming.Name name)
            throws javax.naming.NamingException

Unbind the object with the specified name.

Specified by:

unbind in interface javax.naming.Context

Parameters:

name - name that is being unbound.

Throws:

javax.naming.NamingException - if there is a naming exception.

rename

public void rename(java.lang.String oldname,
                   java.lang.String newname)
            throws javax.naming.NamingException

Rename the bound object.

Specified by:

rename in interface javax.naming.Context

Parameters:

oldname - old name that the object is bound as.

newname - new name that the object will be bound as.

Throws:

javax.naming.NamingException - if there is a naming exception.

rename

public void rename(javax.naming.Name oldname,
                   javax.naming.Name newname)
            throws javax.naming.NamingException

Rename the bound object.

Specified by:

rename in interface javax.naming.Context

Parameters:

oldname - old name that the object is bound as.

newname - new name that the object will be bound as.

Throws:

javax.naming.NamingException - if there is a naming exception.

list

public javax.naming.NamingEnumeration<javax.naming.NameClassPair> list(java.lang.String name)
                                                                throws javax.naming.NamingException

List the contents of the specified context.

Specified by:

list in interface javax.naming.Context

Parameters:

name - context name.

Returns:

an enumeration of the contents.

Throws:

javax.naming.NamingException - if there is a naming exception.

list

public javax.naming.NamingEnumeration<javax.naming.NameClassPair> list(javax.naming.Name name)
                                                                throws javax.naming.NamingException

List the contents of the specified context.

Specified by:

list in interface javax.naming.Context

Parameters:

name - context name.

Returns:

an enumeration of the contents.

Throws:

javax.naming.NamingException - if there is a naming exception.

listBindings

public javax.naming.NamingEnumeration<javax.naming.Binding> listBindings(java.lang.String name)
                                                                  throws javax.naming.NamingException

List the bindings in the specified context.

Specified by:

listBindings in interface javax.naming.Context

Parameters:

name - context name.

Returns:

an enumeration of the bindings.

Throws:

javax.naming.NamingException - if there is a naming exception.

listBindings

public javax.naming.NamingEnumeration<javax.naming.Binding> listBindings(javax.naming.Name name)
                                                                  throws javax.naming.NamingException

List the bindings in the specified context.

Specified by:

listBindings in interface javax.naming.Context

Parameters:

name - context name.

Returns:

an enumeration of the bindings.

Throws:

javax.naming.NamingException - if there is a naming exception.

destroySubcontext

public void destroySubcontext(java.lang.String name)
                       throws javax.naming.NamingException

Destroy the specified subcontext.

Specified by:

destroySubcontext in interface javax.naming.Context

Parameters:

name - name of the subcontext.

Throws:

javax.naming.NamingException - if there is a naming exception.

destroySubcontext

public void destroySubcontext(javax.naming.Name name)
                       throws javax.naming.NamingException

Destroy the specified subcontext.

Specified by:

destroySubcontext in interface javax.naming.Context

Parameters:

name - name of the subcontext.

Throws:

javax.naming.NamingException - if there is a naming exception.

createSubcontext

public javax.naming.Context createSubcontext(java.lang.String name)
                                      throws javax.naming.NamingException

Create the specified subcontext.

Specified by:

createSubcontext in interface javax.naming.Context

Parameters:

name - name of the subcontext.

Returns:

the created subcontext.

Throws:

javax.naming.NamingException - if there is a naming exception.

createSubcontext

public javax.naming.Context createSubcontext(javax.naming.Name name)
                                      throws javax.naming.NamingException

Create the specified subcontext.

Specified by:

createSubcontext in interface javax.naming.Context

Parameters:

name - name of the subcontext.

Returns:

the created subcontext.

Throws:

javax.naming.NamingException - if there is a naming exception.

lookupLink

public java.lang.Object lookupLink(java.lang.String name)
                            throws javax.naming.NamingException

Links are not treated specially.

Specified by:

lookupLink in interface javax.naming.Context

Parameters:

name - name of the link.

Returns:

the resolved object.

Throws:

javax.naming.NamingException - if there is a naming exception.

lookupLink

public java.lang.Object lookupLink(javax.naming.Name name)
                            throws javax.naming.NamingException

Links are not treated specially.

Specified by:

lookupLink in interface javax.naming.Context

Parameters:

name - name of the link.

Returns:

the resolved object.

Throws:

javax.naming.NamingException - if there is a naming exception.

getNameParser

public javax.naming.NameParser getNameParser(java.lang.String name)
                                      throws javax.naming.NamingException

Allow access to the name parser object.

Specified by:

getNameParser in interface javax.naming.Context

Parameters:

name - JNDI name, is ignored since there is only one Name Parser object.

Returns:

NameParser object

Throws:

javax.naming.NamingException

getNameParser

public javax.naming.NameParser getNameParser(javax.naming.Name name)
                                      throws javax.naming.NamingException

Allow access to the name parser object.

Specified by:

getNameParser in interface javax.naming.Context

Parameters:

name - JNDI name, is ignored since there is only one Name Parser object.

Returns:

NameParser object

Throws:

javax.naming.NamingException

composeName

public java.lang.String composeName(java.lang.String name,
                                    java.lang.String prefix)
                             throws javax.naming.NamingException

Specified by:

composeName in interface javax.naming.Context

Throws:

javax.naming.NamingException

composeName

public javax.naming.Name composeName(javax.naming.Name name,
                                     javax.naming.Name prefix)
                              throws javax.naming.NamingException

Specified by:

composeName in interface javax.naming.Context

Throws:

javax.naming.NamingException

addToEnvironment

public java.lang.Object addToEnvironment(java.lang.String propName,
                                         java.lang.Object propVal)
                                  throws javax.naming.NamingException

Add to the environment for the current context.

Specified by:

addToEnvironment in interface javax.naming.Context

Throws:

javax.naming.NamingException - if there is a naming exception.

removeFromEnvironment

public java.lang.Object removeFromEnvironment(java.lang.String propName)
                                       throws javax.naming.NamingException

Remove from the environment for the current context.

Specified by:

removeFromEnvironment in interface javax.naming.Context

Throws:

javax.naming.NamingException - if there is a naming exception.

getEnvironment

public java.util.Hashtable getEnvironment()
                                   throws javax.naming.NamingException

Return the environment for the current context.

Specified by:

getEnvironment in interface javax.naming.Context

Throws:

javax.naming.NamingException - if there is a naming exception.

close

public void close()
           throws javax.naming.NamingException

Set the environment for the current context to null when close is called.

Specified by:

close in interface javax.naming.Context

Throws:

javax.naming.NamingException - if there is a naming exception.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object