## 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

Copyright © 2001-2005 MetaStuff Ltd.. All Rights Reserved.