Deklaration

Beschreibung

Methoden
public Attr	createAttribute(String name)
public Attr	createAttributeNS(String namespaceURI, String qualifiedName)
public CDATASection	createCDATASection(String data)
public Comment	createComment(String data)
public DocumentFragment	createDocumentFragment()
public Element	createElement(String tagName)
public Element	createElementNS(String namespaceURI, String qualifiedName)
public EntityReference	createEntityReference(String name)
public ProcessingInstruction	createProcessingInstruction(String target, String data)
public Text	createTextNode(String data)
public DocumentType	getDoctype()
public Element	getDocumentElement()
public Element	getElementById(String elementId)
public NodeList	getElementsByTagName(String tagname)
public NodeList	getElementsByTagNameNS(String namespaceURI, String localName)
public DOMImplementation	getImplementation()
public Node	importNode(Node importedNode, boolean deep)

Methoden im Detail

public Attr createAttribute(String name)

Erzeugt ein Attribut mit dem Namen name und liefert es zurück. Der Wert des Attributs kann in dem zurückgelieferten Objekt gesetzt werden.

Exception: DOMException

• Code INVALID_CHARACTER_ERR, falls name ein ungültiges Zeichen enthält.

public Attr createAttributeNS(String namespaceURI, String qualifiedName)     

Erzeugt ein Attribut mit dem qualifzierten Namen qualifiedName, das dem durch namespaceURI bezeichneten Namensraum zugeordnet wird. Der Wert des Attributs kann in dem zurückgelieferten Objekt gesetzt werden. qualifiedName besteht aus dem lokalen Attributnamen, dem optional durch einen Doppelpunkt getrennt ein Präfix vorangestellt werden kann.

Exception: DOMException

• Code INVALID_CHARACTER_ERR, falls qualifiedName ein ungültiges Zeichen enthält.
• Code NAME_SPACE_ERR, falls qualifiedName ein ungültiges Format hat, oder falls er das Präfix xml hat und gleichzeitig für namespaceURI ein anderer Wert als null, "" oder "http://www.w3.org/XML/1998/namespace" oder aber wenn qualifiedName das Präfix xmlns hat und gleichzeitig für namespaceURI ein anderer Wert als null oder "" angegeben wurde..

public CDATASection createCDATASection(String data)

Erzeugt einen Knoten für einen CDATA-Abschnitt und liefert ihn zurück.

Exception: DOMException

• Code NOT_SUPPORTED_ERR, falls dieses Objekt ein HTML-Dokument repräsentiert.

public Comment createComment(String data)

Erzeugt einen Kommentarknoten mit dem Kommentar data und liefert ihn zurück.

public DocumentFragment createDocumentFragment()

Erzeugt ein DocumentFragment-Exemplar und liefert es zurück.

public Element createElement(String tagName)

Erzeugt einen Elementknoten mit dem Elementnamen tagName und liefert ihn zurück. Der Elementknoten wird dabei noch nicht mit Attributen versehen.

Exception: DOMException

• Code INVALID_CHARACTER_ERR, falls tagName ein ungültiges Zeichen enthält.

public Element createElementNS(String namespaceURI, String qualifiedName)     

Erzeugt einen Elementknoten mit dem qualifzierten Elementnamen qualifiedName, der dem durch namespaceURI bezeichneten Namensraum zugeordnet wird.qualifiedName besteht aus dem lokalen Elementnamen, dem optional durch einen Doppelpunkt getrennt ein Präfix vorangestellt werden kann.

Exception: DOMException

• Code INVALID_CHARACTER_ERR, falls qualifiedName ein ungültiges Zeichen enthält.
• Code NAME_SPACE_ERR, falls qualifiedName ein ungültiges Format hat, oder falls er das Präfix xml hat und gleichzeitig für namespaceURI ein anderer Wert als null, "" oder "http://www.w3.org/XML/1998/namespace".

public EntityReference createEntityReference(String name)

Erzeugt eine Entity-Referenz mit dem Namen name und liefert sie zuück.

Exception: DOMException

• Code INVALID_CHARACTER_ERR, falls name ein ungültiges Zeichen enthält.
• Code NOT_SUPPORTED_ERR, falls dieses Objekt ein HTML-Dokument repräsentiert.

public ProcessingInstruction createProcessingInstruction(String target, String data)

Erzeugt einen PI-Knoten für das Target target mit der Anweisung data und liefert ihn zurück.

Exception: DOMException

• Code INVALID_CHARACTER_ERR, falls einer der Parameter ein ungültiges Zeichen enthält.
• Code NOT_SUPPORTED_ERR, falls dieses Objekt ein HTML-Dokument repräsentiert.

public Text createTextNode(String data)

Erzeugt ein Text-Exemplar mit dem Text data und liefert es zurück.

public DocumentType getDoctype()

Liefert ein Exemplar von DocumentType zurück, das die DTD des Dokuments repräsentiert. Falls das Dokument keine DTD besitzt, ist der Rückgabewert null.

public Element getDocumentElement()

Liefert den Wurzel-Elementknoten des Dokuments zurück.

public Element getElementById(String elementId)     

Liefert denjenigen Elementknoten zurück, der ein ID-Attribut mit dem Wert elementID hat. Falls es kein solches Element gibt, ist der Rückgabewert null.

public NodeList getElementsByTagName(String tagname)

Liefert eine Liste mit allen Element-Knoten zurück, die zum Element tagname gehören. Hierbei wird der gesamte Parse-Baum durchsucht und die Knoten werden entsprechend ihrer Reihenfolge im Dokument in der Liste eingetragen. Gibt es keine Element-Knoten mit diesem Tag-Namen, ist die zurückgegebene Liste leer. Wenn "*" übergeben wird, werden alle Elementknoten zurückgeliefert.

public NodeList getElementsByTagNameNS(String namespaceURI, String localName)     

Liefert eine Liste mit allen Element-Knoten zurück, die zum Element localName in dem durch namespaceURI definierten Namensraum gehören. Hierbei wird der gesamte Parse-Baum durchsucht und die Knoten werden entsprechend ihrer Reihenfolge im Dokument in der Liste eingetragen. Gibt es keine Element-Knoten mit diesem Tag-Namen, ist die zurückgegebene Liste leer. Für beide Parameter kann der Wert "*" angegeben werden, der auf alle Namensräume bzw. alle lokalen Namen paßt.

public DOMImplementation getImplementation()

Liefert ein Exemplar von DOMImplementation, mit dem Informationen über die DOM-Implementierung abgerufen werden können.

public Node importNode(Node importedNode, boolean deep)     

Importiert den Knoten importedNode in dieses Dokument. Der Import erfolgt hierbei durch Kopieren des Knotens, der Originalknoten bleibt unverändert erhalten. Beim Kopieren werden auch Attribute und Namensräume übernommen. Mit deep kann angegeben werden, ob der Knoten tief, d. h., rekursiv kopiert und importiert werden soll (true) oder nicht (false). Nach dem Import ist der Knoten noch nicht im Dokument eingeordnet, d. h., sein Parent ist null.