Skip navigation links

com.tangosol.net
Interface NameService

All Superinterfaces:

ClassLoaderAware, Controllable, Service

public interface NameService

extends Service

A NameService is a service that accepts connections from external clients (e.g. Coherence*Extend) and provides a name lookup service.

Since:

Coherence 12.1.2

Author:

phf 2012.03.05

Nested Class Summary

static interface

NameService.Resolvable On lookup(String), if the object retrieved implements NameService.Resolvable, then the NameService will return object.

Field Summary

static java.lang.String	NAME_DEFAULT Default service name for the NameService.
static java.lang.String	TYPE_REMOTE Remote name service type constant.

Method Summary

void	bind(java.lang.String sName, java.lang.Object o) Binds a name to an object.
java.lang.Object	lookup(java.lang.String sName) Retrieves the named object.
void	unbind(java.lang.String sName) Unbinds the named object.

Methods inherited from interface com.tangosol.net.Service

addMemberListener, getCluster, getInfo, getSerializer, getUserContext, removeMemberListener, setUserContext

Methods inherited from interface com.tangosol.util.Service

addServiceListener, removeServiceListener

Methods inherited from interface com.tangosol.util.Controllable

configure, isRunning, shutdown, start, stop

Methods inherited from interface com.tangosol.io.ClassLoaderAware

getContextClassLoader, setContextClassLoader

Field Detail

NAME_DEFAULT

static final java.lang.String NAME_DEFAULT

Default service name for the NameService.

See Also:

Constant Field Values

TYPE_REMOTE

static final java.lang.String TYPE_REMOTE

Remote name service type constant.

See Also:

Constant Field Values

Method Detail

bind

void bind(java.lang.String sName,
          java.lang.Object o)
          throws javax.naming.NameAlreadyBoundException,
                 javax.naming.NamingException

Binds a name to an object.

Parameters:

sName - the name to bind; may not be empty

o - the object to bind; possibly null

Throws:

javax.naming.NameAlreadyBoundException - if name is already bound

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

lookup

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

Retrieves the named object.

Parameters:

sName - the name of the object to look up

Returns:

the object bound to sName

Throws:

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

unbind

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

Unbinds the named object.

Parameters:

sName - the name to bind; may not be empty

Throws:

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

Skip navigation links