| Klasse java.rmi.Naming | 1.1 |
java.lang.Object
|
+--java.rmi.Naming
Deklaration
public final class Naming
extends java.lang.Object
Beschreibung
Diese Klasse repräsentiert eine Schnittstelle zum Zugriff auf
die RMI-Registrierung. Sie stellt einen
Namensdienst zur Verfügung, der RMI-Objekte in einem Namensraum verwaltet.
Die Methoden der Klasse ermöglicht es, Objekte zu registrieren,
abzurufen und zu löschen. Es können nur Objekte registriert werden, die
RMI-Objekte sind. Bei der Registrierung wird ein Objekt mit folgender Syntax spezifiziert:
[rmi:]//[[<host>]]:<port>]/<]name>
Unter host und port wird versucht, den Rechner zu kontaktieren, auf
dem die RMI-Registrierung ausgeführt wird. name
stellt den Namen des
RMI-Objektes dar. Wenn man Rechnername und Portnummer nicht angibt, werden die
Default-Einstellungen localhost und Portnummer 1099 verwendet.
Die RMI-Registrierung wird mit dem
Programm rmiregistry gestartet, das beim Java SDK mitgeliefert wird.
Alternativ dazu kann man in einer eigenen Anwendung die Methode
createRegistry() der Klasse java.rmi.registry.LocateRegistry
zum Erzeugen einer RMI-Registrierung benutzen.
Methoden im Detail
-
public static void bind(String name, Remote obj)
-
Registiert das Objekt obj unter dem Namen name. Im Gegensatz zu rebind() löst diese Methode eine Exception aus, wenn bereits ein Objekt unter dem Namen name registiert ist.
- Exception: AlreadyBoundException
- Wird ausgelöst, wenn unter dem angegeben Name bereits ein Objekt bei der
RMI-Registrierung registriert ist..
- Exception: MalformedURLException
- Wird ausgelöst, wenn der angegebene Name keine gültige URL für RMI-Objekte
darstellt..
- Exception: RemoteException
- Wird ausgelöst, wenn keine Verbindung zur RMI-Registrierung aufgebaut werden kann..
-
public static String[] list(String name)
-
Liefert die URLs aller Objekte zurück, die bei der durch name bezeichneten Registry registriert sind. Falls keine Objekte registriert sind, wird ein leeres Array geliefert.
- Exception: RemoteException
- Wird ausgelöst, wenn keine Verbindung zur RMI-Registrierung aufgebaut werden kann..
- Exception: MalformedURLException
- Wird ausgelöst, wenn der angegebene Name keine gültige URL für RMI-Objekte
darstellt..
-
public static Remote lookup(String name)
-
Liefert eine Referenz auf das Objekt,das unter dem Namen name bei
der RMI-Registrierung registriert ist. Wenn kein Objekt unter diesem Namen registriert ist, wird eine Exception ausgelöst.
- Exception: NotBoundException
- Wird ausgelöst, wenn unter dem angegeben Namen gerade kein Objekt bei der
RMI-Registrierung registriert ist..
- Exception: MalformedURLException
- Wird ausgelöst, wenn der angegebene Name keine gültige URL für RMI-Objekte
darstellt..
- Exception: RemoteException
- Wird ausgelöst, wenn keine Verbindung zur RMI-Registrierung aufgebaut werden kann..
-
public static void rebind(String name, Remote obj)
-
Registriert das Objekt obj unter dem Namen name bei der
RMI-Registrierung. Wenn der Name bereits für ein anderes Objekt benutzt wird,
wird es durch obj ersetzt.
- Exception: RemoteException
- Wird ausgelöst, wenn keine Verbindung zur RMI-Registrierung aufgebaut werden kann..
- Exception: MalformedURLException
- Wird ausgelöst, wenn der angegebene Name keine gültige URL für RMI-Objekte
darstellt..
-
public static void unbind(String name)
-
Löscht das Objekt, das zuvor unter dem Name name bei der RMI-Registrierung
angemeldet wurde.
- Exception: RemoteException
- Wird ausgelöst, wenn keine Verbindung zur RMI-Registrierung aufgebaut werden kann..
- Exception: NotBoundException
- Wird ausgelöst, wenn unter dem angegeben Namen gerade kein Objekt bei der
RMI-Registrierung registriert ist..
- Exception: MalformedURLException
- Wird ausgelöst, wenn der angegebene Name keine gültige URL für RMI-Objekte
darstellt..
Copyright © 2002 dpunkt.Verlag, Heidelberg. Alle Rechte vorbehalten.
