Class Element

java.lang.Object

org.castor.xmlctf.xmldiff.xml.nodes.XMLNode

org.castor.xmlctf.xmldiff.xml.nodes.ParentNode

org.castor.xmlctf.xmldiff.xml.nodes.Element

public class Element
extends ParentNode

A representation of an Element XML node.

Since:

Castor 1.1

Version:

$Revision: 0000 $ $Date: 2007-01-11 00:00:00 -0600 (Thu, 11 Jan 2007) $

Author:

Edward Kuns

Field Summary

Fields inherited from class XMLNode

ATTRIBUTE, ELEMENT, PROCESSING_INSTRUCTION, ROOT, TEXT

Modifier and Type	Field	Description
static final int	ATTRIBUTE	Node is an attribute.
static final int	ELEMENT	Node is an element.
static final int	PROCESSING_INSTRUCTION	Node is a processing instruction.
static final int	ROOT	Node is a root node.
static final int	TEXT	Node is a text node.

Constructor Summary

Constructors

Constructor	Description
Element(String namespace, String localName)	Creates a new Element.

Method Summary

Modifier and Type	Method	Description
void	addAttribute(Attribute attr)	Adds the given Attribute to this Element.
void	addNamespace(Namespace namespace)	Adds the given Namespace to this Element.
String	getAttribute(String uri, String localName)	Returns the value of the named attribute, or null if the node has no such attribute.
Iterator	getAttributeIterator()	Returns an Iterator over the List of Attributes.
Location	getLocation()	Returns the location of this Element in the document.
String	getNamespacePrefix(String uri)	Returns the namespace prefix associated with this namespace URI, as defined in the context of this node.
String	getNamespaceURI(String prefix)	Returns the namespace URI associated with this namespace prefix, as defined in the context of this node.
void	setLocation(Location location)	Sets the location of this Element in the document.

Methods inherited from class ParentNode

addChild, getChildIterator, getStringValue, hasChildNodes

Modifier and Type	Method	Description
void	addChild(XMLNode node)	Adds the given child node to this ParentNode.
Iterator	getChildIterator()	Returns an Iterator over the list of child nodes.
String	getStringValue()	Returns the string value of this parent node.
boolean	hasChildNodes()	Returns true if this node has any child nodes.

Methods inherited from class XMLNode

getLocalName, getNamespaceURI, getNodeLocation, getNodeType, getParentNode, getRootNode, getXPath, setNamespace

Modifier and Type	Method	Description
String	getLocalName()	Returns the local name of the node.
String	getNamespaceURI()	Returns the namespace URI the node.
String	getNodeLocation()	Finds and returns the location of this node in its root's tree.
final int	getNodeType()	Returns the type of this node.
ParentNode	getParentNode()	Returns the parent node, or null if the node has no parent.
XMLNode	getRootNode()	Returns the root node.
protected String	getXPath()	Returns the XPath from the root node to this node.
void	setNamespace(String namespace)	Sets the namespace URI for this XMLNode.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Element

public Element(String namespace,
 String localName)

Creates a new Element.

Parameters:

namespace - the namespace URI for this node. (May be null.)

localName - the localname of this node. (Cannot be null.)

Method Details

getAttributeIterator

public Iterator getAttributeIterator()

Returns an Iterator over the List of Attributes.

Returns:

an Iterator over the List of Attributes.

getAttribute

public String getAttribute(String uri,
 String localName)

Returns the value of the named attribute, or null if the node has no such attribute. If the argument uri is null, the node's namespace URI will be used.

Parameters:

uri - The attribute's namespace URI, or null

localName - The attribute's local name

Returns:

The attribute's value, or null if no such attribute exists

getNamespaceURI

public String getNamespaceURI(String prefix)

Returns the namespace URI associated with this namespace prefix, as defined in the context of this node. Returns null if the prefix is undefined. Returns an empty String if the prefix is defined and associated with no namespace.

Overrides:

getNamespaceURI in class XMLNode

Parameters:

prefix - The namespace prefix

Returns:

The namespace URI, or null.

getNamespacePrefix

public String getNamespacePrefix(String uri)

Returns the namespace prefix associated with this namespace URI, as defined in the context of this node. Returns null if no prefix is defined for this namespace URI. Returns an empty string if the default prefix is associated with this namespace URI.

Parameters:

uri - The namespace URI

Returns:

The namespace prefix, or null

addAttribute

public void addAttribute(Attribute attr)

Adds the given Attribute to this Element.

Parameters:

attr - the Attribute to add

addNamespace

public void addNamespace(Namespace namespace)

Adds the given Namespace to this Element.

Parameters:

namespace - the Namespace to add

setLocation

public void setLocation(Location location)

Sets the location of this Element in the document.

Parameters:

location - the location of this Element in the document.

getLocation

public Location getLocation()

Returns the location of this Element in the document.

Returns:

the location of this Element in the document.