<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<!--NewPage-->
<html>
<head>
<!-- Generated by javadoc on Wed Jul 28 01:21:15 GMT 1999 -->
<title>
  Interface java.rmi.registry.Registry
</title>
</head>
<body>
<a name="_top_"></a>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.rmi.registry.html">This Package</a>  <a href="Package-java.rmi.registry.html">Previous</a>  <a href="java.rmi.registry.RegistryHandler.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
<hr>
<h1>
  Interface java.rmi.registry.Registry
</h1>
<dl>
  <dt> public interface <b>Registry</b>
  <dt> extends <a href="java.rmi.Remote.html#_top_">Remote</a>
</dl>
A "registry" exists on every node that allows RMI connections to
 servers on that node.  The registry on a particular node contains a
 transient database that maps names to remote objects.  When the
 node boots, the registry database is empty.  The names stored in the
 registry are pure and are not parsed.  A service storing itself in
 the registry may want to prefix its name of the service by a package
 name (although not required), to reduce name collisions in the
 registry.
 The LocateRegistry class is used to obtain the registry for different hosts.
<p>
<dl>
    <dt> <b>See Also:</b>
    <dd> <a href="java.rmi.registry.LocateRegistry.html#_top_">LocateRegistry</a>
</dl>
<hr>
<a name="index"></a>
<h2>
  <img src="images/variable-index.gif" width=207 height=38 alt="Variable Index">
</h2>
<dl>
  <dt> <img src="images/blue-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#REGISTRY_PORT"><b>REGISTRY_PORT</b></a>
  <dd> Well known port for registry
</dl>
<h2>
  <img src="images/method-index.gif" width=207 height=38 alt="Method Index">
</h2>
<dl>
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#bind(java.lang.String, java.rmi.Remote)"><b>bind</b></a>(String, Remote)
  <dd>  Binds the name to the specified remote object.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#list()"><b>list</b></a>()
  <dd>  Returns an array of the names in the registry.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#lookup(java.lang.String)"><b>lookup</b></a>(String)
  <dd>  Returns the remote object associated with the specified name in the 
 registry.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#rebind(java.lang.String, java.rmi.Remote)"><b>rebind</b></a>(String, Remote)
  <dd> 
 Rebind the name to a new object, replacing any existing binding.
  <dt> <img src="images/red-ball-small.gif" width=6 height=6 alt=" o ">
	<a href="#unbind(java.lang.String)"><b>unbind</b></a>(String)
  <dd>  Unbind the name.
</dl>
<a name="variables"></a>
<h2>
  <img src="images/variables.gif" width=153 height=38 alt="Variables">
</h2>
<a name="REGISTRY_PORT"><img src="images/blue-ball.gif" width=12 height=12 alt=" o "></a>
<b>REGISTRY_PORT</b>
<pre>
 public static final int REGISTRY_PORT
</pre>
<dl>
  <dd> Well known port for registry<p>
</dl>
<a name="methods"></a>
<h2>
  <img src="images/methods.gif" width=151 height=38 alt="Methods">
</h2>
<a name="lookup(java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="lookup"><b>lookup</b></a>
<pre>
 public abstract <a href="java.rmi.Remote.html#_top_">Remote</a> lookup(<a href="java.lang.String.html#_top_">String</a> name) throws <a href="java.rmi.RemoteException.html#_top_">RemoteException</a>, <a href="java.rmi.NotBoundException.html#_top_">NotBoundException</a>, <a href="java.rmi.AccessException.html#_top_">AccessException</a>
</pre>
<dl>
  <dd> Returns the remote object associated with the specified name in the 
 registry.
<p>
  <dd><dl>
    <dt> <b>Throws:</b> <a href="java.rmi.RemoteException.html#_top_">RemoteException</a>
    <dd> If remote operation failed.
    <dt> <b>Throws:</b> <a href="java.rmi.NotBoundException.html#_top_">NotBoundException</a>
    <dd> if there is no object with this name in the
              registry.
    <dt> <b>Throws:</b> <a href="java.rmi.AccessException.html#_top_">AccessException</a>
    <dd> If this operation is not permitted.
  </dl></dd>
</dl>
<a name="bind(java.lang.String, java.rmi.Remote)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="bind"><b>bind</b></a>
<pre>
 public abstract void bind(<a href="java.lang.String.html#_top_">String</a> name,
                           <a href="java.rmi.Remote.html#_top_">Remote</a> obj) throws <a href="java.rmi.RemoteException.html#_top_">RemoteException</a>, <a href="java.rmi.AlreadyBoundException.html#_top_">AlreadyBoundException</a>, <a href="java.rmi.AccessException.html#_top_">AccessException</a>
</pre>
<dl>
  <dd> Binds the name to the specified remote object.
<p>
  <dd><dl>
    <dt> <b>Throws:</b> <a href="java.rmi.RemoteException.html#_top_">RemoteException</a>
    <dd> If remote operation failed.
    <dt> <b>Throws:</b> <a href="java.rmi.AlreadyBoundException.html#_top_">AlreadyBoundException</a>
    <dd> If name is already bound.
    <dt> <b>Throws:</b> <a href="java.rmi.AccessException.html#_top_">AccessException</a>
    <dd> If this operation is not permitted.
  </dl></dd>
</dl>
<a name="unbind(java.lang.String)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="unbind"><b>unbind</b></a>
<pre>
 public abstract void unbind(<a href="java.lang.String.html#_top_">String</a> name) throws <a href="java.rmi.RemoteException.html#_top_">RemoteException</a>, <a href="java.rmi.NotBoundException.html#_top_">NotBoundException</a>, <a href="java.rmi.AccessException.html#_top_">AccessException</a>
</pre>
<dl>
  <dd> Unbind the name.
<p>
  <dd><dl>
    <dt> <b>Throws:</b> <a href="java.rmi.RemoteException.html#_top_">RemoteException</a>
    <dd> If remote operation failed.
    <dt> <b>Throws:</b> <a href="java.rmi.NotBoundException.html#_top_">NotBoundException</a>
    <dd> if there is no object with this name in the
              registry.
    <dt> <b>Throws:</b> <a href="java.rmi.AccessException.html#_top_">AccessException</a>
    <dd> If this operation is not permitted.
  </dl></dd>
</dl>
<a name="rebind(java.lang.String, java.rmi.Remote)"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="rebind"><b>rebind</b></a>
<pre>
 public abstract void rebind(<a href="java.lang.String.html#_top_">String</a> name,
                             <a href="java.rmi.Remote.html#_top_">Remote</a> obj) throws <a href="java.rmi.RemoteException.html#_top_">RemoteException</a>, <a href="java.rmi.AccessException.html#_top_">AccessException</a>
</pre>
<dl>
  <dd> Rebind the name to a new object, replacing any existing binding.
<p>
  <dd><dl>
    <dt> <b>Throws:</b> <a href="java.rmi.RemoteException.html#_top_">RemoteException</a>
    <dd> If remote operation failed.
    <dt> <b>Throws:</b> <a href="java.rmi.AccessException.html#_top_">AccessException</a>
    <dd> If this operation is not permitted.
  </dl></dd>
</dl>
<a name="list()"><img src="images/red-ball.gif" width=12 height=12 alt=" o "></a>
<a name="list"><b>list</b></a>
<pre>
 public abstract <a href="java.lang.String.html#_top_">String</a>[] list() throws <a href="java.rmi.RemoteException.html#_top_">RemoteException</a>, <a href="java.rmi.AccessException.html#_top_">AccessException</a>
</pre>
<dl>
  <dd> Returns an array of the names in the registry.
<p>
  <dd><dl>
    <dt> <b>Throws:</b> <a href="java.rmi.RemoteException.html#_top_">RemoteException</a>
    <dd> If remote operation failed.
    <dt> <b>Throws:</b> <a href="java.rmi.AccessException.html#_top_">AccessException</a>
    <dd> If this operation is not permitted.
  </dl></dd>
</dl>
<hr>
<pre>
<a href="packages.html">All Packages</a>  <a href="tree.html">Class Hierarchy</a>  <a href="Package-java.rmi.registry.html">This Package</a>  <a href="Package-java.rmi.registry.html">Previous</a>  <a href="java.rmi.registry.RegistryHandler.html#_top_">Next</a>  <a href="AllNames.html">Index</a></pre>
</body>
</html>
