public OMAttribute addAttribute(OMAttribute attr)
Adds an attribute to this element.

There is no order implied by added attributes.

 public OMAttribute addAttribute(String attributeName,
    String value,
    OMNamespace ns)
Adds an attribute to the current element.

This function does not check to make sure that the given attribute value can be serialized
directly as an XML value. The caller may, for example, pass a string with the character
0x01.

 public OMElement cloneOMElement()
Clones this element. Since both elements are build compleletely, you will lose the differed
building capability.

 public OMNamespace declareDefaultNamespace(String uri)
This will declare a default namespace for this element explicitly

 public OMNamespace declareNamespace(OMNamespace namespace)
Declares a namespace with the element as its scope.

 public OMNamespace declareNamespace(String uri,
    String prefix)
Creates a namespace in the current element scope.

 public OMNamespace findNamespace(String uri,
    String prefix)
Finds a namespace with the given uri and prefix, in the scope of the hierarchy.

Searches from the current element and goes up the hiararchy until a match is found. If no
match is found, returns null.

Either prefix or uri should be null. Results are undefined if both are
specified.

 public OMNamespace findNamespaceURI(String prefix)
Checks for a namespace in the context of this element with the given prefix and returns the
relevant namespace object, if available. If not available, returns null.

 public Iterator getAllAttributes()
Returns a list of OMAttributes.

Note that the iterator returned by this function will be invalidated by any
addAttribute call. 

 public Iterator getAllDeclaredNamespaces() throws OMException
Returns an iterator for all of the namespaces declared on this element.

If you're interested in all namespaces in scope, you need to call this function for all
parent elements as well. Note that the iterator may be invalidated by any call to either
declareNamespace function. 

 public OMAttribute getAttribute(QName qname)
Returns a named attribute if present.

 public String getAttributeValue(QName qname)
Returns a named attribute's value, if present.

 public OMXMLParserWrapper getBuilder()
Returns the builder object.

 public Iterator getChildElements()
Returns a filtered list of children - just the elements.

 public OMNamespace getDefaultNamespace()
This will retrieve the default namespace of this element, if available. null returned if none
is found.

 public OMElement getFirstElement()
Returns the first child element of the element.

 public int getLineNumber()

 public String getLocalName()
Returns the local name of the element.

 public OMNamespace getNamespace() throws OMException

 public QName getQName()
Gets the QName of this node.

 public String getText()
Returns the non-empty text children as a string.

This method iterates over all the text children of the element and concatenates
them to a single string. Only direct children will be considered, i.e. the text
is not extracted recursively. For example the return value for
<element>A<child>B</child>C</element> will be AC.

All whitespace will be preserved.

 public QName getTextAsQName()
OMText can contain its information as a QName as well. This will return the text as a QName

 public XMLStreamReader getXMLStreamReader()
Returns the pull parser that will generate the pull events relevant to THIS element.

Caching is on.

 public XMLStreamReader getXMLStreamReaderWithoutCaching()
Returns the pull parser that will generate the pull events relevant to THIS element.

Caching is off.

 public  void removeAttribute(OMAttribute attr)
Method removeAttribute

 public QName resolveQName(String qname)
Turns a prefix:local qname string into a proper QName, evaluating it in the OMElement
context. Unprefixed qnames resolve to the local namespace.

 public  void setBuilder(OMXMLParserWrapper wrapper)
Method setBuilder.

 public  void setFirstChild(OMNode node)Deprecated! This -  method should not be called, un-intentionally. When some one randomly set
the first child, all the links handling will not happen inside this method. So we
have moved this method to the less visible interface, OMContainerEx.

Sets the first child.

 public  void setLineNumber(int lineNumber)

 public  void setLocalName(String localName)
Method setLocalName

 public  void setNamespace(OMNamespace namespace)
Sets the Namespace. This will first search for a namespace in the current scope with the
given namespace. If no namespace is found with the given details, then it will declare a new
one. Then that namespace will be assigned to this element.

 public  void setNamespaceWithNoFindInCurrentScope(OMNamespace namespace)
This will not search the namespace in the scope nor will declare in the current element, as
in setNamespace(OMNamespace). This will just assign the given namespace to the element.

 public  void setText(String text)

 public  void setText(QName text)

 public String toString()
This is a convenience method only. This will basically serialize the given OMElement to a
String but will build the OMTree in the memory

 public String toStringWithConsume() throws XMLStreamException
This is a convenience method only. This basically serializes the given OMElement to a String
but will NOT build the OMTree in the memory. So you are at your own risk of losing
information.