⇒ Index (Frames) |  ⇒ Index (No Frames) |  ⇒ Package |  ⇒ Package Tree |  ⇒ Full Tree 
gnu.xml.dom

Class DomElement

java.lang.Object
|
+--gnu.xml.dom.DomNode
   |
   +--gnu.xml.dom.DomNsNode
      |
      +--gnu.xml.dom.DomElement

All Implemented Interfaces:
java.lang.Cloneable, Element, DocumentEvent, EventTarget, Node, NodeList


public class DomElement
extends DomNsNode
implements Element

"Element" implementation.

Author:
David Brownell

Constructor Summary

DomElement(Document owner, java.lang.String namespaceURI, java.lang.String name)

Constructs an Element node associated with the specified document.

Method Summary

java.lang.Object

clone()

Shallow clone of the element, except that associated attributes are (deep) cloned.

java.lang.String

getAttribute(java.lang.String name)

DOM L1 Returns the value of the specified attribute, or an empty string.

Attr

getAttributeNode(java.lang.String name)

DOM L1 Returns the appropriate attribute node; the name is the nodeName property of the attribute.

Attr

getAttributeNodeNS(java.lang.String namespace, java.lang.String localPart)

DOM L2 Returns the appropriate attribute node; the name combines the namespace name and the local part.

java.lang.String

getAttributeNS(java.lang.String namespaceURI, java.lang.String local)

DOM L2 Returns the value of the specified attribute, or an empty string.

NamedNodeMap

getAttributes()

DOM L1 Returns the element's attributes

short

getNodeType()

DOM L1 Returns the constant ELEMENT_NODE.

java.lang.String

getTagName()

DOM L1 Returns the element name (same as getNodeName).

boolean

hasAttribute(java.lang.String name)

DOM L2 Returns true if the element has an attribute with the specified name (specified or DTD defaulted).

boolean

hasAttributeNS(java.lang.String namespaceURI, java.lang.String local)

DOM L2 Returns true if the element has an attribute with the specified name (specified or DTD defaulted).

boolean

hasAttributes()

DOM L2> Returns true iff this is an element node with attributes.

void

makeReadonly()

Marks this element, its children, and its associated attributes as readonly.

void

removeAttribute(java.lang.String name)

DOM L1 Removes the appropriate attribute node.

Attr

removeAttributeNode(Attr node)

DOM L1 Removes the appropriate attribute node; the name is the nodeName property of the attribute.

void

removeAttributeNS(java.lang.String namespace, java.lang.String localPart)

DOM L2 Removes the appropriate attribute node; the name combines the namespace name and the local part.

void

setAttribute(java.lang.String name, java.lang.String value)

DOM L1 Modifies an existing attribute to have the specified value, or creates a new one with that value.

Attr

setAttributeNode(Attr attr)

DOM L1 Stores the specified attribute, optionally overwriting any existing one with that name.

Attr

setAttributeNodeNS(Attr attr)

DOM L2 Stores the specified attribute, optionally overwriting any existing one with that name.

void

setAttributeNS(java.lang.String uri, java.lang.String aname, java.lang.String value)

DOM L2 Modifies an existing attribute to have the specified value, or creates a new one with that value.

Constructor Details

DomElement

protected DomElement(Document owner, java.lang.String namespaceURI, java.lang.String name)

Constructs an Element node associated with the specified document.

This constructor should only be invoked by a Document as part of its createElement functionality, or through a subclass which is similarly used in a "Sub-DOM" style layer.

Parameters:
owner - The document with which this node is associated
namespaceURI - Combined with the local part of the name, this is used to uniquely identify a type of element
name - Name of this element, which may include a prefix

Method Details

clone

public Object clone()

Shallow clone of the element, except that associated attributes are (deep) cloned.


getAttribute

public String getAttribute(java.lang.String name)

DOM L1 Returns the value of the specified attribute, or an empty string.

Parameters:
name

getAttributeNode

public Attr getAttributeNode(java.lang.String name)

DOM L1 Returns the appropriate attribute node; the name is the nodeName property of the attribute.

Parameters:
name

getAttributeNodeNS

public Attr getAttributeNodeNS(java.lang.String namespace, java.lang.String localPart)

DOM L2 Returns the appropriate attribute node; the name combines the namespace name and the local part.

Parameters:
namespace
localPart

getAttributeNS

public String getAttributeNS(java.lang.String namespaceURI, java.lang.String local)

DOM L2 Returns the value of the specified attribute, or an empty string.

Parameters:
namespaceURI
local

getAttributes

public NamedNodeMap getAttributes()

DOM L1 Returns the element's attributes


getNodeType

public final short getNodeType()

DOM L1 Returns the constant ELEMENT_NODE.


getTagName

public final String getTagName()

DOM L1 Returns the element name (same as getNodeName).


hasAttribute

public boolean hasAttribute(java.lang.String name)

DOM L2 Returns true if the element has an attribute with the specified name (specified or DTD defaulted).

Parameters:
name

hasAttributeNS

public boolean hasAttributeNS(java.lang.String namespaceURI, java.lang.String local)

DOM L2 Returns true if the element has an attribute with the specified name (specified or DTD defaulted).

Parameters:
namespaceURI
local

hasAttributes

public boolean hasAttributes()

DOM L2> Returns true iff this is an element node with attributes.


makeReadonly

public void makeReadonly()

Marks this element, its children, and its associated attributes as readonly.


removeAttribute

public void removeAttribute(java.lang.String name)

DOM L1 Removes the appropriate attribute node. If there is no such node, this is (bizarrely enough) a NOP so you won't see exceptions if your code deletes non-existent attributes.

Note that since there is no portable way for DOM to record DTD information, default values for attributes will never be provided automatically.

Parameters:
name

removeAttributeNode

public Attr removeAttributeNode(Attr node)

DOM L1 Removes the appropriate attribute node; the name is the nodeName property of the attribute.

Note that since there is no portable way for DOM to record DTD information, default values for attributes will never be provided automatically.

Parameters:
node

removeAttributeNS

public void removeAttributeNS(java.lang.String namespace, java.lang.String localPart)

DOM L2 Removes the appropriate attribute node; the name combines the namespace name and the local part.

Note that since there is no portable way for DOM to record DTD information, default values for attributes will never be provided automatically.

Parameters:
namespace
localPart

setAttribute

public void setAttribute(java.lang.String name, java.lang.String value)

DOM L1 Modifies an existing attribute to have the specified value, or creates a new one with that value. The name used is the nodeName value.

Parameters:
name
value

setAttributeNode

public Attr setAttributeNode(Attr attr)

DOM L1 Stores the specified attribute, optionally overwriting any existing one with that name.

Parameters:
attr

setAttributeNodeNS

public Attr setAttributeNodeNS(Attr attr)

DOM L2 Stores the specified attribute, optionally overwriting any existing one with that name.

Parameters:
attr

setAttributeNS

public void setAttributeNS(java.lang.String uri, java.lang.String aname, java.lang.String value)

DOM L2 Modifies an existing attribute to have the specified value, or creates a new one with that value.

Parameters:
uri
aname
value