55 * <code>createRegistry</code> methods).
56 *
57 * <p>A <code>Registry</code> implementation may choose to restrict
58 * access to some or all of its methods (for example, methods that
59 * mutate the registry's bindings may be restricted to calls
60 * originating from the local host). If a <code>Registry</code>
61 * method chooses to deny access for a given invocation, its
62 * implementation may throw {@link java.rmi.AccessException}, which
63 * (because it extends {@link java.rmi.RemoteException}) will be
64 * wrapped in a {@link java.rmi.ServerException} when caught by a
65 * remote client.
66 *
67 * <p>The names used for bindings in a <code>Registry</code> are pure
68 * strings, not parsed. A service which stores its remote reference
69 * in a <code>Registry</code> may wish to use a package name as a
70 * prefix in the name binding to reduce the likelihood of name
71 * collisions in the registry.
72 *
73 * @author Ann Wollrath
74 * @author Peter Jones
75 * @since JDK1.1
76 * @see LocateRegistry
77 */
78 public interface Registry extends Remote {
79
80 /** Well known port for registry. */
81 public static final int REGISTRY_PORT = 1099;
82
83 /**
84 * Returns the remote reference bound to the specified
85 * <code>name</code> in this registry.
86 *
87 * @param name the name for the remote reference to look up
88 *
89 * @return a reference to a remote object
90 *
91 * @throws NotBoundException if <code>name</code> is not currently bound
92 *
93 * @throws RemoteException if remote communication with the
94 * registry failed; if exception is a <code>ServerException</code>
95 * containing an <code>AccessException</code>, then the registry
|
55 * <code>createRegistry</code> methods).
56 *
57 * <p>A <code>Registry</code> implementation may choose to restrict
58 * access to some or all of its methods (for example, methods that
59 * mutate the registry's bindings may be restricted to calls
60 * originating from the local host). If a <code>Registry</code>
61 * method chooses to deny access for a given invocation, its
62 * implementation may throw {@link java.rmi.AccessException}, which
63 * (because it extends {@link java.rmi.RemoteException}) will be
64 * wrapped in a {@link java.rmi.ServerException} when caught by a
65 * remote client.
66 *
67 * <p>The names used for bindings in a <code>Registry</code> are pure
68 * strings, not parsed. A service which stores its remote reference
69 * in a <code>Registry</code> may wish to use a package name as a
70 * prefix in the name binding to reduce the likelihood of name
71 * collisions in the registry.
72 *
73 * @author Ann Wollrath
74 * @author Peter Jones
75 * @since 1.1
76 * @see LocateRegistry
77 */
78 public interface Registry extends Remote {
79
80 /** Well known port for registry. */
81 public static final int REGISTRY_PORT = 1099;
82
83 /**
84 * Returns the remote reference bound to the specified
85 * <code>name</code> in this registry.
86 *
87 * @param name the name for the remote reference to look up
88 *
89 * @return a reference to a remote object
90 *
91 * @throws NotBoundException if <code>name</code> is not currently bound
92 *
93 * @throws RemoteException if remote communication with the
94 * registry failed; if exception is a <code>ServerException</code>
95 * containing an <code>AccessException</code>, then the registry
|