UserDataHandler(3)
(Auszug aus "XML in a Nutshell" von Elliotte Rusty Harold & W. Scott Means)
Die Methode Node.setUserData( ) bietet dem Programmierer die Möglichkeit, ein Callback-Objekt zu registrieren, das benachrichtigt wird, wenn auf dem fraglichen Knoten verschiedene Operationen ausgeführt werden. Diese Callback-Objekte müssen dieses Interface implementieren, damit sie diese Benachrichtigungen empfangen können.
Attribute
Das Interface UserDataHandler hat keine Attribute.
Methode
Für dieses Interface ist die folgende Methode definiert:
handle: operation, key, data, src, dst (3)
Diese Methode wird aufgerufen, wenn das Node-Objekt, mit dem das von UserDataHandler abgeleitete Eltern-Objekt verknüpft ist, importiert oder geklont wird. Diese Methode muss von DOM-Benutzern implementiert werden, die benachrichtigt werden wollen, wenn überwachte Node-Objekte manipuliert werden.
Anmerkung: Bei der Implementierung der handle( )-Methode, ist unbedingt darauf zu achten, dass Exceptions abgefangen werden, die eventuell ausgelöst werden, damit sie nicht im aufrufenden DOM-Code ausgelöst werden. Das DOM-interne Verhalten ist nicht definiert, wenn in dieser Methode eine Exception ausgelöst wird.
Argumente
-
operation: unsigned short
Der Typ von operation, der eingetreten ist. Er basiert auf den folgenden Werten:
Konstantenname | Wert | Bedeutung |
NODE_CLONED | 1 | Der überwachte Knoten wurde mit Node.cloneNode( ) geklont. |
NODE_IMPORTED | 2 | Der überwachte Knoten wurde mit Document.importNode( ) importiert. |
NODE_DELETED | 3 | Der Knoten wurde gelöscht. In Umgebungen (wie Java), die keinen expliziten Lösch-Operator haben, ist das nicht unbedingt zuverlässig. |
NODE_RENAMED | 4 | Der Knoten wurde mit Document.renameNode( ) umbenannt. |
NODE_ADOPTED | 5 | Der überwachte Knoten wurde im Document.adoptNode( ) adoptiert. |
-
Der benutzerdefinierte Schlüssel aus der Node.setUserData( )-Methode, für die die handle( )-Methode aufgerufen wird.
-
data: DOMUserData
Die Benutzerdaten, die dem key-Argument entsprechen und ursprünglich mit der Methode Node.setUserData( ) gesetzt wurden.
-
src: Node
Der Knoten, der geklont, adoptiert, importiert oder umbenannt wird. Dieses Argument ist null, wenn der Knoten gelöscht wird.
-
dst: Node
Der neu geklonte oder importierte Knoten oder null, wenn kein neuer Knoten erzeugt wurde.
Java-Bindung
public boolean isDerivedFrom(String typeNamespaceArg,
String typeNameArg, int derivationMethod);
<< zurück | vor >> |
Tipp der data2type-Redaktion: Zum Thema XML bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an: |
Copyright © 2005 O'Reilly Verlag GmbH & Co. KG
Für Ihren privaten Gebrauch dürfen Sie die Online-Version ausdrucken.
Ansonsten unterliegt dieses Kapitel aus dem Buch "XML in a Nutshell" denselben Bestimmungen, wie die gebundene Ausgabe: Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen.
O’Reilly Verlag GmbH & Co. KG, Balthasarstraße 81, 50670 Köln, kommentar(at)oreilly.de