IElement (intarsys runtime library)

All Known Implementing Classes:

ElementElementAdapter, StandardElement
```
public interface IElement
```
An IElement is an information container in the infoset abstraction. The IElement contains optional other IAttribute or IElement instances and a text value.

Method Summary

Methods
Modifier and Type	Method and Description
`String`	`asXML()` This `IElement` serialized as an XML string.
`IAttribute`	`attribute(String name)` The `IAttribute` named "name" within this element or null if it does not exist.
`Iterator<String>`	`attributeNames()` An `Iterator` providing all attribute names attached to this element.
`String`	`attributeTemplate(String name)` If this implementation supports template expansion, return the template (unexpanded) value of the `IAttribute` named "name" in this element or null if it does not exist.
`String`	`attributeValue(String name, String defaultValue)` The value of the `IAttribute` named "name" in this element or "defaultValue" if it does not exist.
`IElement`	`element(String name)` The (first) `IElement` named "name" within this element or null if it does not exist.
`Iterator<IElement>`	`elementIterator()` An `Iterator` providing all `IElement` instances attached to this element.
`Iterator<IElement>`	`elementIterator(String name)` An `Iterator` providing all `IElement` instances attached to this element having a name of "name".
`void`	`elementRemove(IElement targetElement)` Remove targeElement from this.
`void`	`elementsClear()` Remove all child `IElement` instances .
`String`	`elementText(String name)` The text content of the `IElement` named "name" within this element or null if the child does not exist.
`String`	`getName()` The name of this `IElement`.
`String`	`getText()` The text content of this element.
`boolean`	`hasAttribute(String name)` true if this `IElement` has `IAttribute` instances with name
`boolean`	`hasAttributes()` true if this `IElement` has `IAttribute` instances.
`boolean`	`hasElements()` true if this `IElement` has child `IElement` instances.
`boolean`	`hasElements(String name)` true if this `IElement` has child `IElement` instances with name "name"
`IElement`	`newElement(String name)` Create and attach a new `IElement`
`void`	`setAttributeTemplate(String name, String template)` If this implementation supports template expansion, set the template (unexpanded) value for an attribute.
`void`	`setAttributeValue(String name, String value)` Set the value for an attribute.
`void`	`setName(String name)` Set the element name to "name".
`void`	`setText(String value)` Set the element text content to "value".

- Method Detail
  - asXML
```
String asXML()
```
    This IElement serialized as an XML string.
    
    Returns:
  - attribute
```
IAttribute attribute(String name)
```
    The IAttribute named "name" within this element or null if it does not exist.
    
    Parameters:
    name -
    
    Returns:
  - attributeNames
```
Iterator<String> attributeNames()
```
    An Iterator providing all attribute names attached to this element. There's no guarantee on the order of the names.
    
    Returns:
  - attributeTemplate
```
String attributeTemplate(String name)
```
    If this implementation supports template expansion, return the template (unexpanded) value of the IAttribute named "name" in this element or null if it does not exist.
    
    Parameters:
    name -
    
    Returns:
  - attributeValue
```
String attributeValue(String name,
                    String defaultValue)
```
    The value of the IAttribute named "name" in this element or "defaultValue" if it does not exist.
    
    Parameters:
    name -
    
    Returns:
  - element
```
IElement element(String name)
```
    The (first) IElement named "name" within this element or null if it does not exist.
    
    Parameters:
    name -
    
    Returns:
  - elementIterator
```
Iterator<IElement> elementIterator()
```
    An Iterator providing all IElement instances attached to this element.
    
    Returns:
  - elementIterator
```
Iterator<IElement> elementIterator(String name)
```
    An Iterator providing all IElement instances attached to this element having a name of "name".
    
    Returns:
  - elementRemove
```
void elementRemove(IElement targetElement)
```
    Remove targeElement from this.
    
    Parameters:
    targetElement -
  - elementsClear
```
void elementsClear()
```
    Remove all child IElement instances .
  - elementText
```
String elementText(String name)
```
    The text content of the IElement named "name" within this element or null if the child does not exist.
    
    Parameters:
    string -
    
    Returns:
  - getName
```
String getName()
```
    The name of this IElement.
    
    Returns:
  - getText
```
String getText()
```
    The text content of this element. This method never returns null.
    
    Returns:
  - hasAttribute
```
boolean hasAttribute(String name)
```
    true if this IElement has IAttribute instances with name
    
    Returns:
  - hasAttributes
```
boolean hasAttributes()
```
    true if this IElement has IAttribute instances.
    
    Returns:
  - hasElements
```
boolean hasElements()
```
    true if this IElement has child IElement instances.
    
    Returns:
  - hasElements
```
boolean hasElements(String name)
```
    true if this IElement has child IElement instances with name "name"
    
    Returns:
  - newElement
```
IElement newElement(String name)
```
    Create and attach a new IElement
    
    Parameters:
    name -
    
    Returns:
  - setAttributeTemplate
```
void setAttributeTemplate(String name,
                        String template)
```
    If this implementation supports template expansion, set the template (unexpanded) value for an attribute. If the attribute already exists, the value is replaced. If value is null, an existing attribute will be removed.
    
    Parameters:
    name -
    value -
  - setAttributeValue
```
void setAttributeValue(String name,
                     String value)
```
    Set the value for an attribute. IF the attribute already exists, the value is replaced. If value is null, an existing attribute will be removed.
    
    Parameters:
    name -
    value -
  - setName
```
void setName(String name)
```
    Set the element name to "name".
    
    Parameters:
    xeQuery -
  - setText
```
void setText(String value)
```
    Set the element text content to "value".
    
    Parameters:
    value -

Interface IElement

Method Summary

Method Detail

asXML

attribute

attributeNames

attributeTemplate

attributeValue

element

elementIterator

elementIterator

elementRemove

elementsClear

elementText

getName

getText

hasAttribute

hasAttributes

hasElements

hasElements

newElement

setAttributeTemplate

setAttributeValue

setName

setText