Package com.sun.enterprise.naming.impl

Class GlassfishNamingManagerImpl

java.lang.Object

com.sun.enterprise.naming.impl.GlassfishNamingManagerImpl

All Implemented Interfaces:

GlassfishNamingManager

@Service
@Singleton
public final class GlassfishNamingManagerImpl
extends Object
implements GlassfishNamingManager

This is the manager that handles all naming operations including publishObject as well as binding environment props, resource and ejb references in the namespace.

Field Summary

Fields

Modifier and Type	Field	Description
static String	ERROR_COSNAMING_UNBIND
static String	IIOPOBJECT_FACTORY
static String	NAMING_ALREADY_EXISTS

Fields inherited from interface org.glassfish.api.naming.GlassfishNamingManager

LOGICAL_NAME, NAMESPACE_METADATA_KEY

Constructor Summary

Constructors

Constructor	Description
GlassfishNamingManagerImpl()
GlassfishNamingManagerImpl(InitialContext ic)	Create the naming manager.

Method Summary

Modifier and Type	Method	Description
void	bindToAppNamespace(String appName, Collection<? extends JNDIBinding> bindings)	Binds the bindings to module namespace of an application Typically, to get access to application's namespace, invocation context must be set to appropriate application's context. This API is useful in cases where containers within GlassFish need to bind the objects in application's name-space and do not have application's invocation context
void	bindToComponentNamespace(String appName, String moduleName, String componentId, boolean treatComponentAsModule, Collection<? extends JNDIBinding> bindings)	This method enumerates the env properties, ejb and resource references etc for a J2EE component and binds them in the component's java:comp namespace.
void	bindToModuleNamespace(String appName, String moduleName, Collection<? extends JNDIBinding> bindings)	Binds the bindings to module namespace of an application Typically, to get access to application's module namespace, invocation context must be set to appropriate application's context. This API is useful in cases where containers within GlassFish need to bind the objects in application's module name-space and do not have application's invocation context
Context	getInitialContext()	Get the initial naming context.
NameParser	getNameParser()
Remote	initializeRemoteNamingSupport(org.omg.CORBA.ORB orb)	Initialize RMI-IIOP naming services
NamingEnumeration<NameClassPair>	list(String name)
NamingEnumeration<Binding>	listBindings(String name)
Object	lookup(String name)
Object	lookup(String name, SerialContext serialContext)	This method is called from SerialContext class.
Object	lookup(String componentId, String name)	Lookup object for a particular componentId and name.
Object	lookupFromAppNamespace(String appName, String name, Hashtable env)	Lookup a naming entry in a particular application's namespace
Object	lookupFromModuleNamespace(String appName, String moduleName, String name, Hashtable env)	Lookup a naming entry in a particular application's module's namespace
void	publishCosNamingObject(String name, Object obj, boolean rebind)	Publish a CosNaming object.
void	publishObject(String name, Object obj, boolean rebind)	Publish a name in the naming service.
void	publishObject(Name name, Object obj, boolean rebind)	Publish a name in the naming service.
Context	restoreJavaCompEnvContext(String contextName)	Recreate a context for java:comp/env or one of its sub-contexts given the context name.
void	unbindAppObject(String appName, String name)	Remove an object from the application's namespace. Typically, to get access to application's namespace, invocation context must be set to appropriate application's context. This API is useful in cases where containers within GlassFish need to unbind the objects in application's name-space and do not have application's invocation context
void	unbindAppObjects(String appName)	Unbind app and module level bindings for the given app name.
void	unbindComponentObjects(String componentId)	This method enumerates the env properties, ejb and resource references and unbinds them from the java:comp namespace.
void	unbindModuleObject(String appName, String moduleName, String name)	Remove an object from the module name-space of an application Typically, to get access to application's module namespace, invocation context must be set to appropriate application's context. This API is useful in cases where containers within GlassFish need to unbind the objects in application's module name-space and do not have application's invocation context
void	unpublishCosNamingObject(String name)	Remove an object from the naming service.
void	unpublishObject(String name)	Remove an object from the naming service.
void	unpublishObject(Name name)	Remove an object from the naming service.

Methods inherited from class java.lang.Object

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

Field Detail

ERROR_COSNAMING_UNBIND

public static final String ERROR_COSNAMING_UNBIND

See Also:

Constant Field Values

NAMING_ALREADY_EXISTS

public static final String NAMING_ALREADY_EXISTS

See Also:

Constant Field Values

IIOPOBJECT_FACTORY

public static final String IIOPOBJECT_FACTORY

See Also:

Constant Field Values

Constructor Detail

GlassfishNamingManagerImpl

public GlassfishNamingManagerImpl()
                           throws NamingException

Throws:

NamingException

GlassfishNamingManagerImpl

public GlassfishNamingManagerImpl(InitialContext ic)
                           throws NamingException

Create the naming manager. Creates a new initial context.

Parameters:

ic -

Throws:

NamingException

Method Detail

getInitialContext

public Context getInitialContext()

Get the initial naming context.

Specified by:

getInitialContext in interface GlassfishNamingManager

getNameParser

public NameParser getNameParser()

initializeRemoteNamingSupport

public Remote initializeRemoteNamingSupport(org.omg.CORBA.ORB orb)
                                     throws NamingException

Description copied from interface: GlassfishNamingManager

Initialize RMI-IIOP naming services

Specified by:

initializeRemoteNamingSupport in interface GlassfishNamingManager

Returns:

RemoteSerialProvider object instance

Throws:

NamingException

publishObject

public void publishObject(String name,
                          Object obj,
                          boolean rebind)
                   throws NamingException

Publish a name in the naming service.

Specified by:

publishObject in interface GlassfishNamingManager

Parameters:

name - Name that the object is bound as.

obj - Object that needs to be bound.

rebind - flag

Throws:

NamingException - if there is a naming exception.

publishObject

public void publishObject(Name name,
                          Object obj,
                          boolean rebind)
                   throws NamingException

Publish a name in the naming service.

Specified by:

publishObject in interface GlassfishNamingManager

Parameters:

name - Name that the object is bound as.

obj - Object that needs to be bound.

rebind - flag

Throws:

NamingException - if there is a naming exception.

publishCosNamingObject

public void publishCosNamingObject(String name,
                                   Object obj,
                                   boolean rebind)
                            throws NamingException

Description copied from interface: GlassfishNamingManager

Publish a CosNaming object. The object is published to both the server's CosNaming service and the global naming service. Objects published with this method must be unpublished via unpublishCosNamingObject.

Specified by:

publishCosNamingObject in interface GlassfishNamingManager

Parameters:

name - Object that needs to be bound.

obj - Name that the object is bound as.

rebind - operation is a bind or a rebind.

Throws:

NamingException

unpublishObject

public void unpublishObject(String name)
                     throws NamingException

Description copied from interface: GlassfishNamingManager

Remove an object from the naming service.

Specified by:

unpublishObject in interface GlassfishNamingManager

Parameters:

name - Name that the object is bound as.

Throws:

NamingException

unpublishCosNamingObject

public void unpublishCosNamingObject(String name)
                              throws NamingException

Remove an object from the naming service.

Specified by:

unpublishCosNamingObject in interface GlassfishNamingManager

Parameters:

name - Name that the object is bound as.

Throws:

NamingException

unpublishObject

public void unpublishObject(Name name)
                     throws NamingException

Remove an object from the naming service.

Specified by:

unpublishObject in interface GlassfishNamingManager

Parameters:

name - Name that the object is bound as.

Throws:

NamingException

lookupFromAppNamespace

public Object lookupFromAppNamespace(String appName,
                                     String name,
                                     Hashtable env)
                              throws NamingException

Lookup a naming entry in a particular application's namespace

Specified by:

lookupFromAppNamespace in interface GlassfishNamingManager

Parameters:

appName - application-name

name - name of the object

env - Environment

Returns:

Object found by the name

Throws:

NamingException - when unable to find the object

lookupFromModuleNamespace

public Object lookupFromModuleNamespace(String appName,
                                        String moduleName,
                                        String name,
                                        Hashtable env)
                                 throws NamingException

Lookup a naming entry in a particular application's module's namespace

Specified by:

lookupFromModuleNamespace in interface GlassfishNamingManager

Parameters:

appName - application-name

moduleName - module-name

name - name of the object

env - Environment

Returns:

Object found by the name

Throws:

NamingException - when unable to find the object

bindToComponentNamespace

public void bindToComponentNamespace(String appName,
                                     String moduleName,
                                     String componentId,
                                     boolean treatComponentAsModule,
                                     Collection<? extends JNDIBinding> bindings)
                              throws NamingException

This method enumerates the env properties, ejb and resource references etc for a J2EE component and binds them in the component's java:comp namespace.

Specified by:

bindToComponentNamespace in interface GlassfishNamingManager

Parameters:

appName -

moduleName -

componentId -

bindings -

treatComponentAsModule - true if java:comp and java:module refer to the same namespace

Throws:

NamingException

bindToModuleNamespace

public void bindToModuleNamespace(String appName,
                                  String moduleName,
                                  Collection<? extends JNDIBinding> bindings)
                           throws NamingException

Description copied from interface: GlassfishNamingManager

Binds the bindings to module namespace of an application
Typically, to get access to application's module namespace, invocation context must be set to appropriate application's context.
This API is useful in cases where containers within GlassFish need to bind the objects in application's module name-space and do not have application's invocation context

Specified by:

bindToModuleNamespace in interface GlassfishNamingManager

Parameters:

appName - application-name

moduleName - module-name

bindings - list of bindings

Throws:

NamingException - when unable to bind the bindings

bindToAppNamespace

public void bindToAppNamespace(String appName,
                               Collection<? extends JNDIBinding> bindings)
                        throws NamingException

Description copied from interface: GlassfishNamingManager

Binds the bindings to module namespace of an application
Typically, to get access to application's namespace, invocation context must be set to appropriate application's context.
This API is useful in cases where containers within GlassFish need to bind the objects in application's name-space and do not have application's invocation context

Specified by:

bindToAppNamespace in interface GlassfishNamingManager

Parameters:

appName - application-name

bindings - list of bindings

Throws:

NamingException - when unable to bind the bindings

unbindComponentObjects

public void unbindComponentObjects(String componentId)
                            throws NamingException

This method enumerates the env properties, ejb and resource references and unbinds them from the java:comp namespace.

Specified by:

unbindComponentObjects in interface GlassfishNamingManager

Throws:

NamingException

unbindAppObjects

public void unbindAppObjects(String appName)
                      throws NamingException

Description copied from interface: GlassfishNamingManager

Unbind app and module level bindings for the given app name.

Specified by:

unbindAppObjects in interface GlassfishNamingManager

Throws:

NamingException

unbindAppObject

public void unbindAppObject(String appName,
                            String name)
                     throws NamingException

Remove an object from the application's namespace.
Typically, to get access to application's namespace, invocation context must be set to appropriate application's context.
This API is useful in cases where containers within GlassFish need to unbind the objects in application's name-space and do not have application's invocation context

Specified by:

unbindAppObject in interface GlassfishNamingManager

Parameters:

appName - application-name

name - Name that the object is bound as.

Throws:

NamingException - when unable to unbind the object

unbindModuleObject

public void unbindModuleObject(String appName,
                               String moduleName,
                               String name)
                        throws NamingException

Remove an object from the module name-space of an application
Typically, to get access to application's module namespace, invocation context must be set to appropriate application's context.
This API is useful in cases where containers within GlassFish need to unbind the objects in application's module name-space and do not have application's invocation context

Specified by:

unbindModuleObject in interface GlassfishNamingManager

Parameters:

appName - application-name

moduleName - module-name

name - Name that the object is bound as.

Throws:

NamingException - when unable to unbind the object

restoreJavaCompEnvContext

public Context restoreJavaCompEnvContext(String contextName)
                                  throws NamingException

Recreate a context for java:comp/env or one of its sub-contexts given the context name.

Specified by:

restoreJavaCompEnvContext in interface GlassfishNamingManager

Throws:

NamingException

lookup

public Object lookup(String name)
              throws NamingException

Throws:

NamingException

lookup

public Object lookup(String name,
                     SerialContext serialContext)
              throws NamingException

This method is called from SerialContext class. The serialContext instance that was created by the appclient's Main class is passed so that stickiness is preserved. Called from javaURLContext.lookup, for java:comp names.

Throws:

NamingException

lookup

public Object lookup(String componentId,
                     String name)
              throws NamingException

Lookup object for a particular componentId and name.

Specified by:

lookup in interface GlassfishNamingManager

Throws:

NamingException

list

public NamingEnumeration<NameClassPair> list(String name)
                                      throws NamingException

Throws:

NamingException

listBindings

public NamingEnumeration<Binding> listBindings(String name)
                                        throws NamingException

Throws:

NamingException