# XMLElement (Slick - The 2D Library)
Date: 2013-06-03

## org.newdawn.slick.util.xml
Class XMLElement

    java.lang.Object
      org.newdawn.slick.util.xml.XMLElement

    public class XMLElement

extends java.lang.Object

A utility wrapper round the standard DOM XML element. This provides a more simple API for accessing attributes, children and providing defaults when schemas arn't used - which is generally a little simpler for most of us.

Author:
  kevin

Method Summary
`java.lang.String` `getAttribute(java.lang.String name)` Get the value specified for a given attribute on this element
`java.lang.String` `getAttribute(java.lang.String name, java.lang.String def)` Get the value specified for a given attribute on this element
`java.lang.String[]` `getAttributeNames()` Get the names of the attributes specified on this element
`boolean` `getBooleanAttribute(java.lang.String name)` Get the value specified for a given attribute on this element as a boolean.
`boolean` `getBooleanAttribute(java.lang.String name, boolean def)` Get the value specified for a given attribute on this element as a boolean.
`XMLElementList` `getChildren()` Get the complete list of children for this node
`XMLElementList` `getChildrenByName(java.lang.String name)` Get a list of children with a given element name
`java.lang.String` `getContent()` Get the text content of the element, i.e.
`double` `getDoubleAttribute(java.lang.String name)` Get the value specified for a given attribute on this element as an double.
`double` `getDoubleAttribute(java.lang.String name, double def)` Get the value specified for a given attribute on this element as an double.
`int` `getIntAttribute(java.lang.String name)` Get the value specified for a given attribute on this element as an integer.
`int` `getIntAttribute(java.lang.String name, int def)` Get the value specified for a given attribute on this element as an integer.
`java.lang.String` `getName()` Get the name of this element
`java.lang.String` `toString()`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Method Detail

### getAttributeNames

    public java.lang.String[] getAttributeNames()

  Get the names of the attributes specified on this element

  Returns:
    The names of the elements specified

### getName

    public java.lang.String getName()

  Get the name of this element

  Returns:
    The name of this element

### getAttribute

    public java.lang.String getAttribute(java.lang.String name)

  Get the value specified for a given attribute on this element

  Parameters:
    `name` - The name of the attribute whose value should be retrieved
  Returns:
    The value given for the attribute

### getAttribute

    public java.lang.String getAttribute(java.lang.String name,
                                         java.lang.String def)

  Get the value specified for a given attribute on this element

  Parameters:
    `name` - The name of the attribute whose value should be retrieved
    `def` - The default value to return if the attribute is specified
  Returns:
    The value given for the attribute

### getIntAttribute

    public int getIntAttribute(java.lang.String name)
                        throws SlickXMLException

  Get the value specified for a given attribute on this element as an integer.

  Parameters:
    `name` - The name of the attribute whose value should be retrieved
  Returns:
    The value given for the attribute
  Throws:
    `SlickXMLException` - Indicates a failure to convert the value into an integer

### getIntAttribute

    public int getIntAttribute(java.lang.String name,
                               int def)
                        throws SlickXMLException

  Get the value specified for a given attribute on this element as an integer.

  Parameters:
    `name` - The name of the attribute whose value should be retrieved
    `def` - The default value to return if the attribute is specified
  Returns:
    The value given for the attribute
  Throws:
    `SlickXMLException` - Indicates a failure to convert the value into an integer

### getDoubleAttribute

    public double getDoubleAttribute(java.lang.String name)
                              throws SlickXMLException

  Get the value specified for a given attribute on this element as an double.

  Parameters:
    `name` - The name of the attribute whose value should be retrieved
  Returns:
    The value given for the attribute
  Throws:
    `SlickXMLException` - Indicates a failure to convert the value into an double

### getDoubleAttribute

    public double getDoubleAttribute(java.lang.String name,
                                     double def)
                              throws SlickXMLException

  Get the value specified for a given attribute on this element as an double.

  Parameters:
    `name` - The name of the attribute whose value should be retrieved
    `def` - The default value to return if the attribute is specified
  Returns:
    The value given for the attribute
  Throws:
    `SlickXMLException` - Indicates a failure to convert the value into an double

### getBooleanAttribute

    public boolean getBooleanAttribute(java.lang.String name)
                                throws SlickXMLException

  Get the value specified for a given attribute on this element as a boolean.

  Parameters:
    `name` - The name of the attribute whose value should be retrieved
  Returns:
    The value given for the attribute
  Throws:
    `SlickXMLException` - Indicates a failure to convert the value into an boolean

### getBooleanAttribute

    public boolean getBooleanAttribute(java.lang.String name,
                                       boolean def)
                                throws SlickXMLException

  Get the value specified for a given attribute on this element as a boolean.

  Parameters:
    `name` - The name of the attribute whose value should be retrieved
    `def` - The default value to return if the attribute is specified
  Returns:
    The value given for the attribute
  Throws:
    `SlickXMLException` - Indicates a failure to convert the value into an boolean

### getContent

    public java.lang.String getContent()

  Get the text content of the element, i.e. the bit between the tags

  Returns:
    The text content of the node

### getChildren

    public XMLElementList getChildren()

  Get the complete list of children for this node

  Returns:
    The list of children for this node

### getChildrenByName

    public XMLElementList getChildrenByName(java.lang.String name)

  Get a list of children with a given element name

  Parameters:
    `name` - The name of the element type that should be retrieved
  Returns:
    A list of elements

### toString

    public java.lang.String toString()

  Overrides:
    `toString` in class `java.lang.Object`
  See Also:
    `Object.toString()`

Copyright © 2006 New Dawn Software. All Rights Reserved.