Package com.caucho.services.name
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
-
Method Details
-
lookup
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
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
-