org.dom4j
Interface Attribute

All Superinterfaces:

Cloneable, Node

All Known Implementing Classes:

AbstractAttribute

public interface Attribute

extends Node

Attribute defines an XML attribute. An attribute may have a name, an optional namespace and a value.

Version:

$Revision: 1.9 $

Author:

James Strachan

Field Summary

Fields inherited from interface org.dom4j.Node

ANY_NODE, ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_NODE, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_REFERENCE_NODE, MAX_NODE_TYPE, NAMESPACE_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE, UNKNOWN_NODE

Method Summary

Object	getData() Accesses the data of this attribute which may implement data typing bindings such as XML Schema or Java Bean bindings or will return the same value as Node.getText().
Namespace	getNamespace() Returns the Namespace of this element if one exists otherwise null is returned returned.
String	getNamespacePrefix() Returns the namespace prefix of this element if one exists otherwise an empty String is returned.
String	getNamespaceURI() Returns the URI mapped to the namespace of this element if one exists otherwise an empty String is returned.
QName	getQName() Returns the QName of this attribute which represents the local name, the qualified name and the Namespace.
String	getQualifiedName() Returns the fully qualified name of this element.
String	getValue() Returns the value of the attribute.
void	setData(Object data) Sets the data value of this attribute if this element supports data binding or calls Node.setText(String)if it doesn't.
void	setNamespace(Namespace namespace) Sets the Namespace of this element or if this element is read only then an UnsupportedOperationException is thrown.
void	setValue(String value) Sets the value of this attribute or this method will throw an UnsupportedOperationException if it is read-only.

Methods inherited from interface org.dom4j.Node

accept, asXML, asXPathResult, clone, createXPath, detach, getDocument, getName, getNodeType, getNodeTypeName, getParent, getPath, getPath, getStringValue, getText, getUniquePath, getUniquePath, hasContent, isReadOnly, matches, numberValueOf, selectNodes, selectNodes, selectNodes, selectObject, selectSingleNode, setDocument, setName, setParent, setText, supportsParent, valueOf, write

Method Detail

getQName

public QName getQName()

Returns the QName of this attribute which represents the local name, the qualified name and the Namespace.

Returns:

the QName associated with this attribute

getNamespace

public Namespace getNamespace()

Returns the Namespace of this element if one exists otherwise null is returned returned.

Returns:

the Namespace associated with this node

setNamespace

public void setNamespace(Namespace namespace)

Sets the Namespace of this element or if this element is read only then an UnsupportedOperationException is thrown.

Parameters:

namespace - is the Namespace to associate with this element

getNamespacePrefix

public String getNamespacePrefix()

Returns the namespace prefix of this element if one exists otherwise an empty String is returned.

Returns:

the prefix of the Namespace of this element or an empty String

getNamespaceURI

public String getNamespaceURI()

Returns the URI mapped to the namespace of this element if one exists otherwise an empty String is returned.

Returns:

the URI for the Namespace of this element or an empty String

getQualifiedName

public String getQualifiedName()

Returns the fully qualified name of this element.

This will be the same as the value returned from Node.getName() if this element has no namespace attached to this element or an expression of the form

 getNamespacePrefix() + ":" + getName()
 

will be returned.

Returns:

the fully qualified name of the element

getValue

public String getValue()

Returns the value of the attribute. This method returns the same value as the Node.getText()method.

Returns:

the value of the attribute

setValue

public void setValue(String value)

Sets the value of this attribute or this method will throw an UnsupportedOperationException if it is read-only.

Parameters:

value - is the new value of this attribute

getData

public Object getData()

Accesses the data of this attribute which may implement data typing bindings such as XML Schema or Java Bean bindings or will return the same value as Node.getText().

Returns:

the attribute data

setData

public void setData(Object data)

Sets the data value of this attribute if this element supports data binding or calls Node.setText(String)if it doesn't.

Parameters:

data - the attribute data