Deklaration

Beschreibung

Jeder Knoten hat einen Namen, der mit getNodeName() ermittelt werden kann, sowie einen Wert, der mit getValue() festgestellt werden kann. Die folgende Tabelle zeigt, wie der Name und der Wert in Abhängigkeit vom Knotentyp belegt sind.

AttrCDATASectionCommentDocumentDocumentFragmentDocumentTypeElementEntityEntityReferenceNotationProcessingInstructionText

Tabelle 69.1:

Knotentyp	Name	Wert
Attributname	Attributwert
"#cdata-section"	Inhalt des CDATA-Abschnitts
"#comment"	Text des Kommentars
"#document"	null
"#document-fragment"	null
Name des Dokumententyps	null
Elementname	null
Name der Entity	null
Name der Referenz	null
Name der Notation	null
Inhalt ohne Target	Anweisung
"#text"	Der Text selbst

Methoden
public Node	appendChild(Node newChild)
public Node	cloneNode(boolean deep)
public NamedNodeMap	getAttributes()
public NodeList	getChildNodes()
public Node	getFirstChild()
public Node	getLastChild()
public String	getLocalName()
public String	getNameSpaceURI()
public Node	getNextSibling()
public String	getNodeName()
public short	getNodeType()
public String	getNodeValue()
public Document	getOwnerDocument()
public Node	getParentNode()
public String	getPrefix()
public Node	getPreviousSibling()
public boolean	hasAttributes()
public boolean	hasChildNodes()
public Node	insertBefore(Node newChild, Node refChild)
public boolean	isSupported(String feature, String version)
public boolean	normalize()
public Node	removeChild(Node oldChild)
public Node	replaceChild(Node newChild, Node oldChild)
public void	setNodeValue(String nodeValue)
public void	setPrefix(String prefix)

Datenelemente im Detail

public static final short ATTRIBUTE_NODE

Konstante für Attributknoten.

public static final short CDATA_SECTION_NODE

Konstante für Knoten, die CDATA-Abschnitte repräsentieren.

public static final short COMMENT_NODE

Konstante für Kommentarknoten.

public static final short DOCUMENT_FRAGMENT_NODE

Konstante für DocumentFragment-Knoten.

public static final short DOCUMENT_NODE

Konstante für den Wurzelknoten des Dokuments.

public static final short DOCUMENT_TYPE_NODE

Konstante für den Knoten, der die DTD-Referenz repräsentiert.

public static final short ELEMENT_NODE

Konstante für Elementknoten.

public static final short ENTITY_NODE

Konstante für einen Entity-Knoten.

public static final short ENTITY_REFERENCE_NODE

Konstante für Knoten, die Entity-Referenzen repräsentieren.

public static final short NOTATION_NODE

Konstante für Notationsknoten.

public static final short PROCESSING_INSTRUCTION_NODE

Konstante für PI-Knoten.

public static final short TEXT_NODE

Konstante für Textknoten (CDATA innerhalb von Elementen, nicht für CDATA-Attribute).

Methoden im Detail

public Node appendChild(Node newChild)

Hängt den Knoten newChild als letzten direkten Tochterknoten an.

Exception: DOMException

• Code HIERARCHY_REQUEST_ERR, falls es für den Typ dieses Knotens nicht zulässig ist, Knoten vom Typ von newChild als Tochterknoten einzufügen oder wenn newChild ein übergeordneter Knoten dieses Knotens ist.
• Code NO_MODIFICATION_ALLOWED_ERR, wenn der Knoten unveränderbar ist.
• Code WRONG_DOCUMENT_ERR, wenn das Objekt newChild von einem anderen Document-Exemplar erzeugt wurde als dem, zu dem dieser Knoten gehört.

public Node cloneNode(boolean deep)

Erzeugt eine Kopie dieses Knotens und liefert sie zurück. Wenn für deep der Wert false übergeben wird, wird nur der Knoten selbst kopiert. In diesem Fall werden die Referenzen auf die Tochterknoten nicht übernommen (hasChildNodes() liefert false).

Bei deep wird eine rekursive (tiefe) Kopie erzeugt, d. h., auch der gesamte Unterbaum wird kopiert. In beiden Fällen wird kein Wert für den Vaterknoten gesetzt, d. h., getParentNode() liefert null.

public NamedNodeMap getAttributes()

Liefert eine Tabelle mit den Attributen zurück, falls es sich um einen Elementknoten handelt, andernfalls null. Die Attribute werden in derselben Reihenfolge in der Tabelle gespeichert, in der sie im Dokument stehen.

public NodeList getChildNodes()

Liefert eine NodeList, die alle Tochterknoten enthält. Falls der Knoten keine Tochterknoten hat, ist die Liste leer.

public Node getFirstChild()

Liefert den ersten Tochterknoten zurück oder null, falls der Knoten keine Tochterknoten hat.

public Node getLastChild()

Liefert den letzten Tochterknoten zurück oder null, falls der Knoten keine Tochterknoten hat.

public String getLocalName()     

Liefert den lokalen Namen des Knotens zurück. Sofern der Knoten mit einer Methode erzeugt wurde, bei der kein Namensraum angegeben werden kann, ist der Rückgabewert null.

public String getNameSpaceURI()     

Liefert den URI des Namensraums zurück, dem dieser Knoten zugeordnet ist oder null, falls der Knoten keinem bestimmten Namensraum zugeteil wurde

public Node getNextSibling()

Liefert den in der Dokumentenreihenfolge nächsten Geschwisterknoten zurück oder null, falls es keinen weiteren Geschwisterknoten mehr gibt.

public String getNodeName()

Liefert den Namen des Knotens zurück. Dieser Name wird unter anderem verwendet, um Knoten in NamedNodeMaps zu speichern.

public short getNodeType()

Liefert den Typ des Knotens zurück. Rückgabewert ist eine der obigen Konstanten.

public String getNodeValue()

Liefert den Wert des Knotens zurück.

Exception: DOMException

• Code DOMSTRING_SIZE_ERR, wenn der Wert des Knotens länger ist, als die maximal mögliche Länge von Strings auf der Plattform.

public Document getOwnerDocument()

Liefert das Document-Objekt zurück, zu dem dieser Knoten gehört oder null, falls der Knoten selbst ein Document-Knoten ist.

public Node getParentNode()

Liefert den Vaterknoten zurück oder null, falls es sich um den Wurzelknoten des Parse-Baums handelt.

public String getPrefix()     

Liefert den Präfix des qualifizierten Namens des Knotens zurück, oder null, falls der Knoten keinem Namensraum zugeteilt wurde.

public Node getPreviousSibling()

Liefert den in der Dokumentenreihenfolge vorhergehenden Geschwisterknoten zurück oder null, falls es keinen vorhergehenden Geschwisterknoten mehr gibt.

public boolean hasAttributes()     

Liefert true, wenn es sich um einen Elementknoten handelt, der über mindestens ein Attribut verfügt, sonst false.

public boolean hasChildNodes()

Liefert true, wenn der Knoten mindestens einen Tochterknoten hat, sonst false.

public Node insertBefore(Node newChild, Node refChild)

Fügt den Knoten newChild vor dem Knoten refChild ein. newChild wird dadurch zum vorhergehenden Geschwisterknoten von refChild.

Exception: DOMException

• Code HIERARCHY_REQUEST_ERR, falls es für den Typ dieses Knotens nicht zulässig ist, Knoten vom Typ von newChild als Tochterknoten einzufügen oder wenn newChild ein übergeordneter Knoten dieses Knotens ist.
• Code NO_MODIFICATION_ALLOWED_ERR, wenn der Knoten unveränderbar ist.
• Code NOT_FOUND_ERR, wenn refChild kein Tochterknoten dieses Knotens ist.
• Code WRONG_DOCUMENT_ERR, wenn das Objekt newChild von einem anderen Document-Exemplar erzeugt wurde als dem, zu dem dieser Knoten gehört.

public boolean isSupported(String feature, String version)     

Liefert true, wenn die Implementierung über die durch feature bezeichnete Funktion in der Version version verfügt, sonst false. Wenn für null oder ein leerer String übergeben wird, wird die Version nicht berücksichtigt. version ist in der Form a.b anzugeben, z.B. 2.0 für Level 2 Version 1.

public boolean normalize()     

Fügt alle, rekursiv unter diesem Knoten liegende Text-Knoten, die direkt benachbart sind, zu jeweils einem Text-Knoten zusammen.

public Node removeChild(Node oldChild)

Entfernt den Unterknoten oldChild. Falls oldChild kein Unterknoten dieses Knotens ist, bleibt die Methode wirkungslos.

Exception: DOMException

• Code HIERARCHY_REQUEST_ERR, falls es für den Typ dieses Knotens nicht zulässig ist, Knoten vom Typ von newChild als Tochterknoten einzufügen oder wenn newChild ein übergeordneter Knoten dieses Knotens ist.
• Code NO_MODIFICATION_ALLOWED_ERR, wenn der Knoten unveränderbar ist.
• Code NOT_FOUND_ERR, wenn oldChild kein Tochterknoten dieses Knotens ist.

public Node replaceChild(Node newChild, Node oldChild)

Ersetzt den Unterknoten oldChild durch den Knoten newChild. Falls oldChild kein Unterknoten dieses Knotens ist, bleibt die Methode wirkungslos.

Exception: DOMException

• Code HIERARCHY_REQUEST_ERR, falls es für den Typ dieses Knotens nicht zulässig ist, Knoten vom Typ von newChild als Tochterknoten einzufügen oder wenn newChild ein übergeordneter Knoten dieses Knotens ist.
• Code NO_MODIFICATION_ALLOWED_ERR, wenn der Knoten unveränderbar ist.
• Code NOT_FOUND_ERR, wenn oldChild kein Tochterknoten dieses Knotens ist.
• Code WRONG_DOCUMENT_ERR, wenn das Objekt newChild von einem anderen Document-Exemplar erzeugt wurde als dem, zu dem dieser Knoten gehört.

public void setNodeValue(String nodeValue)

Setzt den Wert des Knotens auf nodeValue.

Exception: DOMException

• Code NO_MODIFICATION_ALLOWED_ERR, wenn der Knoten unveränderbar ist.

public void setPrefix(String prefix)     

Setzt den Präfix des qualifizierten Namens des Knotens auf prefix.

Exception: DOMException

• Code INVALID_CHARACTER_ERR, falls prefix ein ungültiges Zeichen enthält.
• Code NAME_SPACE_ERR, falls prefix ein ungültiges Format hat, oder falls es den Wert xml hat und gleichzeitig der Namespace-URI einen anderen Wert als null, "" oder "http://www.w3.org/XML/1998/namespace" hat.
• Code NO_MODIFICATION_ALLOWED_ERR, wenn der Knoten unveränderbar ist.