Interface NameServer


public interface NameServer
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
    Description
    Lists all the object name components directly below the current context.
    lookup(String name)
    Lookup an object from the name server.
  • Method Details

    • lookup

      Object lookup(String name) throws NameServiceException
      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
    • list

      String[] list() throws NameServiceException
      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