- java.lang.Object
-
- java.rmi.Naming
-
public final class Naming extends Object
TheNaming
class provides methods for storing and obtaining references to remote objects in a remote object registry. Each method of theNaming
class takes as one of its arguments a name that is ajava.lang.String
in URL format (without the scheme component) of the form://host:port/name
where
host
is the host (remote or local) where the registry is located,port
is the port number on which the registry accepts calls, and wherename
is a simple string uninterpreted by the registry. Bothhost
andport
are optional. Ifhost
is omitted, the host defaults to the local host. Ifport
is omitted, then the port defaults to 1099, the "well-known" port that RMI's registry,rmiregistry
, uses.Binding a name for a remote object is associating or registering a name for a remote object that can be used at a later time to look up that remote object. A remote object can be associated with a name using the
Naming
class'sbind
orrebind
methods.Once a remote object is registered (bound) with the RMI registry on the local host, callers on a remote (or local) host can lookup the remote object by name, obtain its reference, and then invoke remote methods on the object. A registry may be shared by all servers running on a host or an individual server process may create and use its own registry if desired (see
java.rmi.registry.LocateRegistry.createRegistry
method for details).- Since:
- JDK1.1
- See Also:
Registry
,LocateRegistry
,LocateRegistry.createRegistry(int)
-
-
Method Summary
Methods Modifier and Type Method and Description static void
bind(String name, Remote obj)
Binds the specifiedname
to a remote object.static String[]
list(String name)
Returns an array of the names bound in the registry.static Remote
lookup(String name)
Returns a reference, a stub, for the remote object associated with the specifiedname
.static void
rebind(String name, Remote obj)
Rebinds the specified name to a new remote object.static void
unbind(String name)
Destroys the binding for the specified name that is associated with a remote object.
-
-
-
Method Detail
-
lookup
public static Remote lookup(String name) throws NotBoundException, MalformedURLException, RemoteException
Returns a reference, a stub, for the remote object associated with the specifiedname
.- Parameters:
name
- a name in URL format (without the scheme component)- Returns:
- a reference for a remote object
- Throws:
NotBoundException
- if name is not currently boundRemoteException
- if registry could not be contactedAccessException
- if this operation is not permittedMalformedURLException
- if the name is not an appropriately formatted URL- Since:
- JDK1.1
-
bind
public static void bind(String name, Remote obj) throws AlreadyBoundException, MalformedURLException, RemoteException
Binds the specifiedname
to a remote object.- Parameters:
name
- a name in URL format (without the scheme component)obj
- a reference for the remote object (usually a stub)- Throws:
AlreadyBoundException
- if name is already boundMalformedURLException
- if the name is not an appropriately formatted URLRemoteException
- if registry could not be contactedAccessException
- if this operation is not permitted (if originating from a non-local host, for example)- Since:
- JDK1.1
-
unbind
public static void unbind(String name) throws RemoteException, NotBoundException, MalformedURLException
Destroys the binding for the specified name that is associated with a remote object.- Parameters:
name
- a name in URL format (without the scheme component)- Throws:
NotBoundException
- if name is not currently boundMalformedURLException
- if the name is not an appropriately formatted URLRemoteException
- if registry could not be contactedAccessException
- if this operation is not permitted (if originating from a non-local host, for example)- Since:
- JDK1.1
-
rebind
public static void rebind(String name, Remote obj) throws RemoteException, MalformedURLException
Rebinds the specified name to a new remote object. Any existing binding for the name is replaced.- Parameters:
name
- a name in URL format (without the scheme component)obj
- new remote object to associate with the name- Throws:
MalformedURLException
- if the name is not an appropriately formatted URLRemoteException
- if registry could not be contactedAccessException
- if this operation is not permitted (if originating from a non-local host, for example)- Since:
- JDK1.1
-
list
public static String[] list(String name) throws RemoteException, MalformedURLException
Returns an array of the names bound in the registry. The names are URL-formatted (without the scheme component) strings. The array contains a snapshot of the names present in the registry at the time of the call.- Parameters:
name
- a registry name in URL format (without the scheme component)- Returns:
- an array of names (in the appropriate format) bound in the registry
- Throws:
MalformedURLException
- if the name is not an appropriately formatted URLRemoteException
- if registry could not be contacted.- Since:
- JDK1.1
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-java/rmi/Naming.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.