ProcessingInstruction

(Auszug aus "XML in a Nutshell" von Elliotte Rusty Harold & W. Scott Means)

Dieses Interface ermöglicht den Zugang zu den Inhalten einer XML-Verarbeitungsanweisung. Verarbeitungsanweisungen sind das Mittel der Wahl zur Erteilung von Anweisungen innerhalb von XML-Dokumenten an Programme, die das Dokument verarbeiten.

Java-Beispiel

// Ergänzen einer anwendungsspezifischen Verarbeitungsanweisung
ProcessingInstruction pi = doc.createProcessingInstruction("my_app",
        "action=\"save\"");

 


Attribute

Dieses Interface kennt zwei Attribute:

 


data: DOMString

Enthält den Datenteil der Verarbeitungsanweisung. Der Datenteil beginnt beim ersten Nicht-Whitespace-Zeichen, das auf das target folgt, und endet beim abschließenden ?>.

Exception

  • NO_MODIFICATION_ALLOWED_ERR

    Wird ausgelöst, wenn der Knoten nur-lesbar ist.

Java-Äquivalente
public String getData( );
public void setData(String data) throws DOMException;

Java-Beispiel

// Prüfe das data-Attribut der Anwendung.
if (pi.getTarget(  ) == "MEINE_ANWENDUNG") {
    // Prüfe das data-Attribut auf anwendungsspezifische Informationen,
    // verarbeite die Anweisung.
    if (pi.getData(  ) == "ZÄHLE_GESCHWISTER") {
        // Zähle die Geschwister.
        ...
    }

    pi.setData("GESCHWISTER_GEZAEHLT");
}

 


target: DOMString

Enthält das target der Verarbeitungsanweisung, d.h. das erste durch Whitespace abgeschlossene Wort in der Verarbeitungsanweisung.

Verarbeitungsanweisungen geben Hinweise zur Verarbeitung der Daten an das Anwendungsprogramm weiter. Diese Anweisungen sind im XML-Dokument selbst hinterlegt. Durch das target ist es möglich, Anweisungen an verschiedene Programme zu geben. Anwendungsprogramme, die Verarbeitungsanweisungen für die Formatierung des Dokuments benutzen, sollten Anweisungen, die sie nicht kennen, ignorieren.

Java-Bindung
public String getTarget( );

// Überprüfe, ob unsere Anwendung angesprochen ist.
if (pi.getTarget( ) == "MY_APPLICATION") {
// jetzt führen wir alle anwendungsspezifischen Verarbeitungsschritte durch.
}

 


Methoden

ProcessingInstruction hat keine Methoden.

  

<< 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