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.
  • key: DOMString

    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