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

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method 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