org.glassfish.api.naming
Interface GlassfishNamingManager

@Contract
public interface GlassfishNamingManager

The NamingManager provides an interface for various components to use naming functionality. It provides methods for binding and unbinding environment properties, resource and ejb references.

Field Summary

static java.lang.String

LOGICAL_NAME

Method Summary

void	bindToAppNamespace(java.lang.String appName, java.util.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(java.lang.String appName, java.lang.String moduleName, java.lang.String componentId, boolean treatComponentAsModule, java.util.Collection<? extends JNDIBinding> bindings) This method enumerates the env properties, ejb and resource references etc for a J2EE component and binds them in the applicable java: namespace.
void	bindToModuleNamespace(java.lang.String appName, java.lang.String moduleName, java.util.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
javax.naming.Context	getInitialContext() Get the initial context.
java.rmi.Remote	initializeRemoteNamingSupport(org.omg.CORBA.ORB orb) Initialize RMI-IIOP naming services
java.lang.Object	lookup(java.lang.String componentId, java.lang.String name) Lookup a naming entry for a particular componentId
java.lang.Object	lookupFromAppNamespace(java.lang.String appName, java.lang.String name, java.util.Hashtable env) Lookup a naming entry in a particular application's namespace
java.lang.Object	lookupFromModuleNamespace(java.lang.String appName, java.lang.String moduleName, java.lang.String name, java.util.Hashtable env) Lookup a naming entry in a particular application's module's namespace
void	publishCosNamingObject(java.lang.String name, java.lang.Object obj, boolean rebind) Publish a CosNaming object.
void	publishObject(javax.naming.Name name, java.lang.Object obj, boolean rebind) Publish an object in the naming service.
void	publishObject(java.lang.String name, java.lang.Object obj, boolean rebind) Publish an object in the naming service.
javax.naming.Context	restoreJavaCompEnvContext(java.lang.String contextName) Recreate a context for java:comp/env or one of its sub-contexts given the context name.
void	unbindAppObject(java.lang.String appName, java.lang.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(java.lang.String appName) Unbind app and module level bindings for the given app name.
void	unbindComponentObjects(java.lang.String componentId) Unbind component-level bindings
void	unbindModuleObject(java.lang.String appName, java.lang.String moduleName, java.lang.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(java.lang.String name) Remove an object from the CosNaming service and global naming service.
void	unpublishObject(javax.naming.Name name) Remove an object from the naming service.
void	unpublishObject(java.lang.String name) Remove an object from the naming service.

Field Detail

LOGICAL_NAME

static final java.lang.String LOGICAL_NAME

See Also:

Constant Field Values

Method Detail

getInitialContext

javax.naming.Context getInitialContext()

Get the initial context.

lookup

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

Lookup a naming entry for a particular componentId

Throws:

javax.naming.NamingException

lookupFromAppNamespace

java.lang.Object lookupFromAppNamespace(java.lang.String appName,
                                        java.lang.String name,
                                        java.util.Hashtable env)
                                        throws javax.naming.NamingException

Lookup a naming entry in a particular application's namespace

Parameters:

appName - application-name

name - name of the object

env - Environment

Returns:

Object found by the name

Throws:

javax.naming.NamingException - when unable to find the object

lookupFromModuleNamespace

java.lang.Object lookupFromModuleNamespace(java.lang.String appName,
                                           java.lang.String moduleName,
                                           java.lang.String name,
                                           java.util.Hashtable env)
                                           throws javax.naming.NamingException

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

Parameters:

appName - application-name

moduleName - module-name

name - name of the object

env - Environment

Returns:

Object found by the name

Throws:

javax.naming.NamingException - when unable to find the object

publishObject

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

Publish an object in the naming service.

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:

java.lang.Exception

javax.naming.NamingException

publishObject

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

Publish an object in the naming service.

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:

java.lang.Exception

javax.naming.NamingException

publishCosNamingObject

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

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.

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:

java.lang.Exception

javax.naming.NamingException

bindToComponentNamespace

void bindToComponentNamespace(java.lang.String appName,
                              java.lang.String moduleName,
                              java.lang.String componentId,
                              boolean treatComponentAsModule,
                              java.util.Collection<? extends JNDIBinding> bindings)
                              throws javax.naming.NamingException

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

Parameters:

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

Throws:

javax.naming.NamingException

bindToAppNamespace

void bindToAppNamespace(java.lang.String appName,
                        java.util.Collection<? extends JNDIBinding> bindings)
                        throws javax.naming.NamingException

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

Parameters:

appName - application-name

bindings - list of bindings

Throws:

javax.naming.NamingException - when unable to bind the bindings

bindToModuleNamespace

void bindToModuleNamespace(java.lang.String appName,
                           java.lang.String moduleName,
                           java.util.Collection<? extends JNDIBinding> bindings)
                           throws javax.naming.NamingException

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

Parameters:

appName - application-name

moduleName - module-name

bindings - list of bindings

Throws:

javax.naming.NamingException - when unable to bind the bindings

unpublishObject

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

Remove an object from the naming service.

Parameters:

name - Name that the object is bound as.

Throws:

java.lang.Exception

javax.naming.NamingException

unpublishCosNamingObject

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

Remove an object from the CosNaming service and global naming service.

Parameters:

name - Name that the object is bound as.

Throws:

java.lang.Exception

javax.naming.NamingException

unbindAppObject

void unbindAppObject(java.lang.String appName,
                     java.lang.String name)
                     throws javax.naming.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

Parameters:

name - Name that the object is bound as.

appName - application-name

Throws:

javax.naming.NamingException - when unable to unbind the object

unbindModuleObject

void unbindModuleObject(java.lang.String appName,
                        java.lang.String moduleName,
                        java.lang.String name)
                        throws javax.naming.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

Parameters:

name - Name that the object is bound as.

appName - application-name

moduleName - module-name

Throws:

javax.naming.NamingException - when unable to unbind the object

unpublishObject

void unpublishObject(javax.naming.Name name)
                     throws javax.naming.NamingException

Remove an object from the naming service.

Parameters:

name - Name that the object is bound as.

Throws:

java.lang.Exception

javax.naming.NamingException

unbindComponentObjects

void unbindComponentObjects(java.lang.String componentId)
                            throws javax.naming.NamingException

Unbind component-level bindings

Throws:

javax.naming.NamingException

unbindAppObjects

void unbindAppObjects(java.lang.String appName)
                      throws javax.naming.NamingException

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

Throws:

javax.naming.NamingException

restoreJavaCompEnvContext

javax.naming.Context restoreJavaCompEnvContext(java.lang.String contextName)
                                               throws javax.naming.NamingException

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

Throws:

javax.naming.NamingException

initializeRemoteNamingSupport

java.rmi.Remote initializeRemoteNamingSupport(org.omg.CORBA.ORB orb)
                                              throws javax.naming.NamingException

Initialize RMI-IIOP naming services

Parameters:

orb -

Returns:

RemoteSerialProvider object instance

Throws:

javax.naming.NamingException