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

Modifier and Type	Method and Description
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