com.caucho.services.name
Interface NameServerRemote


public interface NameServerRemote

A read-only name service. The name service provides hierarchical object lookup. The path names are separated by '/'.

Because the name service is hierarchical, a lookup of an intermediate node will return a NameServer instance.

The following example is a simple use of the NameServer:

 /dir-1/1 - where foo contains the string "foo-1"
 /dir-1/2 - where foo contains the string "foo-2"
 /dir-2/1 - where foo contains the string "foo-1"
 /dir-2/2 - where foo contains the string "foo-2"
 

The root server might have a URL like:

 http://www.caucho.com/hessian/hessian/name?ejbid=/
 

So root.lookup("/dir-1/1") will return the string "foo-1", and root.lookup("/dir-1") will return the NameServer with the URL:

 http://www.caucho.com/hessian/hessian/name?ejbid=/dir-1
 


Method Summary
 java.lang.String[] list()
          Lists all the object name components directly below the current context.
 java.lang.Object lookup(java.lang.String name)
          Lookup an object from the name server.
 

Method Detail

lookup

java.lang.Object lookup(java.lang.String name)
                        throws NameServiceException,
                               java.rmi.RemoteException
Lookup an object from the name server.

Parameters:
name - the relative path name
Returns:
the matching object or null if no object maches
Throws:
NameServiceException - if there's an error
java.rmi.RemoteException

list

java.lang.String[] list()
                        throws NameServiceException,
                               java.rmi.RemoteException
Lists all the object name components directly below the current context. The names are the relative compent name.

For example, if the name server context is "/dir-1", the returned values will be ["1", "2"].

Throws:
NameServiceException
java.rmi.RemoteException