DOMException

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

Strukturierte Exceptions bieten Programmiersprachen und ihren Laufzeitumgebungen einen eleganten Weg, den normalen Programmablauf von der Behandlung von außergewöhnlichen und unerwarteten Vorfällen zu trennen. Einige Programmiersprachen, zum Beispiel ECMASkript und Perl, kennen keine Exceptions. In diesem Fall werden die Exceptions durch Fehlercodes ersetzt. Die Fehlercodes werden von der Methode, die sie erkannt hat, an das Programm übergeben.

Der ExceptionCode ist ein ganzzahliger Wert, der verschiedene Arten von Exceptions unterscheidet. Zurzeit sind die folgenden ExceptionCodes definiert. Nicht benutzte Codewerte sind durch das W3C für den zukünftigen Gebrauch reserviert:

 

---

INDEX_SIZE_ERR [unsigned short, Wert: 1]

Ein ungültiger Index wurde an eine Methode übergeben. Gültige Indizes liegen meist im Bereich 0 <= index < collection.length.

Java-Bindung
public static final short INDEX_SIZE_ERR = 1;

 

---

DOMSTRING_SIZE_ERR [unsigned short, Wert: 2]

Der von der Methode zu generierende DOMString ist zu groß.

Java-Bindung
public static final short DOMSTRING_SIZE_ERR = 2;

 

---

HIERARCHY_REQUEST_ERR [unsigned short, Wert: 3]

Das angeforderte Einfügen eines neuen Knotens stellt eine Verletzung der Strukturregeln des Dokuments dar. Zum Beispiel darf die Einfügung nicht dazu führen, dass ein Knoten zu einem seiner eigenen Kinder wird.

Java-Bindung
public static final short HIERARCHY_REQUEST_ERR = 3;

 

---

WRONG_DOCUMENT_ERR [unsigned short, Wert: 4]

Es wurde versucht, den Knoten eines fremden Dokuments direkt in das aktuelle Dokument einzufügen.

Java-Bindung
public static final short WRONG_DOCUMENT_ERR = 4;

 

---

INVALID_CHARACTER_ERR [unsigned short, Wert: 5]

Ein ungültiges Zeichen wurde in einem Namen entdeckt. Zum Beispiel sind Leerzeichen in Namen verboten: "mein element" wäre also ein ungültiger Name.

Java-Bindung
public static final short INVALID_CHARACTER_ERR = 5;

 

---

NO_DATA_ALLOWED_ERR [unsigned short, Wert: 6]

Es wurde versucht, Textdaten in einen Knoten einzubauen, der diese Operation nicht unterstützt, wie zum Beispiel ein Element-Knoten.

Java-Bindung
public static final short NO_DATA_ALLOWED_ERR = 6;

 

---

NO_MODIFICATION_ALLOWED_ERR [unsigned short, Wert: 7]

Es wurde versucht, einen Knoten zu modifizieren, der nur-lesbar ist.

Java-Bindung
public static final short NO_MODIFICATION_ALLOWED_ERR = 7;

 

---

NOT_FOUND_ERR [vorzeichenloser short, Wert: 8]

Es wurde versucht, einen Knoten in einem Kontext zu modifizieren, in dem er nicht gefunden werden konnte.

Java-Bindung
public static final short NOT_FOUND_ERR = 8;

 

---

NOT_SUPPORTED_ERR [unsigned short, Wert: 9]

Wenn von der verwendeten DOM-Implementierung ein optionales Feature nicht unterstützt wird, wird diese Exception ausgelöst.

Java-Bindung
public static final short NOT_SUPPORTED_ERR = 9;

 

---

INUSE_ATTRIBUTE_ERR [unsigned short, Wert: 10]

Ein bereits benutztes Attribut soll erneut benutzt werden. Ein denkbarer Grund wäre, dass man das Ergebnis eines Aufrufs von getAttributeNode() an die setAttributeNode()-Methode eines anderen Elements übergibt. Die richtige Vorgehensweise ist, zunächst ein neues Attr-Objekt mit Hilfe der Methode cloneNode() zu erzeugen.

Java-Bindung
public static final short INUSE_ATTRIBUTE_ERR = 10;

 

---

INVALID_STATE_ERR [unsigned short, Wert: 11] ⁽²⁾

Es wurde versucht, ein Objekt zu verwenden, das nicht mehr gültig ist.

Java-Bindung
public static final short INVALID_STATE_ERR = 11;

 

---

SYNTAX_ERR [unsigned short, Wert: 12] ⁽²⁾

Ein ungültiger oder unzulässiger String wurde übergeben.

Java-Bindung
public static final short SYNTAX_ERR = 12;

 

---

INVALID_MODIFICATION_ERR [unsigned short, Wert: 13] ⁽²⁾

Es wurde versucht, den Typ des zugrunde liegenden Objekts zu ändern.

Java-Bindung
public static final short INVALID_MODIFICATION_ERR = 13;

 

---

NAMESPACE_ERR [unsigned short, Wert: 14] ⁽²⁾

Es wurde versucht, eine Methode anzuwenden, die XML-Namensräume unterstützt, deren Anwendung aber in diesem Fall eine Verletzung der Namensraum-Regeln bewirken würde. Ein Beispiel wäre die Verwendung eines Namens mit Präfix, ohne dass ein zugehöriger Namensraum-URI angegeben ist.

Java-Bindung
public static final short NAMESPACE_ERR = 14;

 

---

INVALID_ACCESS_ERR [unsigned short, Wert: 15] ⁽²⁾

Ein Parameter oder eine Aktion wird vom konkreten Typ nicht unterstützt.

Java-Bindung
public static final short INVALID_ACCESS_ERR = 15;

 

---

VALIDATION_ERR [unsigned short, value: 16] ⁽³⁾

Eine versuchte Modifikation des Dokumentbaums würde zu einem Gültigkeitsfehler führen.

Java-Bindung
public static final short VALIDITY_ERR = 16;

 

---

TYPE_MISMATCH_ERR [unsigned short, value: 17] ⁽³⁾

Wird ausgelöst, wenn der Typ eines Parameters nicht mit dem erwarteten Typ kompatibel ist.

Java-Bindung
public static final short TYPE_MISMATCH_ERR = 17;

  

<< zurück

vor >>