org.apache.axiom.om.impl.llom
Class OMElementImpl

java.lang.Object
  extended byorg.apache.axiom.om.impl.llom.OMNodeImpl
      extended byorg.apache.axiom.om.impl.llom.OMElementImpl
All Implemented Interfaces:
OMConstants, OMContainer, OMContainerEx, OMElement, OMNode, OMNodeEx
Direct Known Subclasses:
OMSourcedElementImpl, SOAPElement, SOAPHeaderBlockImpl

public class OMElementImpl
extends OMNodeImpl
implements OMElement, OMConstants, OMContainerEx

Class OMElementImpl


Field Summary
protected  java.util.HashMap attributes
          Field attributes
protected  OMNode firstChild
          Field firstChild
protected  OMNode lastChild
           
protected  java.lang.String localName
          Field localName
protected  java.util.HashMap namespaces
          Field namespaces
protected  int noPrefixNamespaceCounter
          Field noPrefixNamespaceCounter
protected  OMNamespace ns
          Field ns
 
Fields inherited from class org.apache.axiom.om.impl.llom.OMNodeImpl
builder, done, factory, nextSibling, nodeType, parent, previousSibling
 
Fields inherited from interface org.apache.axiom.om.OMNode
CDATA_SECTION_NODE, COMMENT_NODE, DTD_NODE, ELEMENT_NODE, ENTITY_REFERENCE_NODE, PI_NODE, SPACE_NODE, TEXT_NODE
 
Fields inherited from interface org.apache.axiom.om.OMConstants
ARRAY_ITEM_LOCALNAME, ARRAY_ITEM_NS_PREFIX, ARRAY_ITEM_NSURI, ARRAY_ITEM_QNAME, DATA_HANDLER, DEFAULT_CHAR_SET_ENCODING, DEFAULT_XML_VERSION, IS_BINARY, IS_DATA_HANDLERS_AWARE, PULL_TYPE_BUILDER, PUSH_TYPE_BUILDER, XMLNS_NS_PREFIX, XMLNS_NS_URI, XMLNS_PREFIX, XMLNS_URI
 
Constructor Summary
OMElementImpl(javax.xml.namespace.QName qname, OMContainer parent, OMFactory factory)
          It is assumed that the QName passed contains, at least, the localName for this element.
OMElementImpl(java.lang.String localName, OMNamespace ns, OMContainer parent, OMFactory factory)
          This is the basic constructor for OMElement.
OMElementImpl(java.lang.String localName, OMNamespace ns, OMContainer parent, OMXMLParserWrapper builder, OMFactory factory)
          Constructor OMElementImpl.
OMElementImpl(java.lang.String localName, OMNamespace ns, OMFactory factory)
          Constructor OMElementImpl.
 
Method Summary
 OMAttribute addAttribute(OMAttribute attr)
          Inserts an attribute to this element.
 OMAttribute addAttribute(java.lang.String attributeName, java.lang.String value, OMNamespace ns)
          Method addAttribute.
 void addChild(OMNode child)
          Adds child to the element.
 void buildNext()
          Forces the parser to proceed, if parser has not yet finished with the XML input.
 OMElement cloneOMElement()
          Clones this element.
 OMNamespace declareDefaultNamespace(java.lang.String uri)
          We use "" to store the default namespace of this element.
 OMNamespace declareNamespace(OMNamespace namespace)
          Declares a namespace with the element as its scope.
 OMNamespace declareNamespace(java.lang.String uri, java.lang.String prefix)
          Creates a namespace in the current element scope.
 OMNode detach()
          Removes this information item and its children, from the model completely.
 void discard()
          Method discard.
 OMNamespace findNamespace(java.lang.String uri, java.lang.String prefix)
          Finds a namespace with the given uri and prefix, in the scope of the document.
 OMNamespace findNamespaceURI(java.lang.String prefix)
          Checks for a namespace in the context of this element with the given prefix and returns the relevant namespace object, if available.
 java.util.Iterator getAllAttributes()
          Returns a List of OMAttributes.
 java.util.Iterator getAllDeclaredNamespaces()
          Method getAllDeclaredNamespaces.
 OMAttribute getAttribute(javax.xml.namespace.QName qname)
          Returns a named attribute if present.
 java.lang.String getAttributeValue(javax.xml.namespace.QName qname)
          Returns a named attribute's value, if present.
 OMXMLParserWrapper getBuilder()
          Method getBuilder.
 java.util.Iterator getChildElements()
          Returns a filtered list of children - just the elements.
 java.util.Iterator getChildren()
          Returns a collection of this element.
 java.util.Iterator getChildrenWithName(javax.xml.namespace.QName elementQName)
          Searches for children with a given QName and returns an iterator to traverse through the OMNodes.
 OMNamespace getDefaultNamespace()
          This will retrieve the default namespace of this element, if available. null returned if none is found.
 OMElement getFirstChildWithName(javax.xml.namespace.QName elementQName)
          Method getFirstChildWithName.
 OMElement getFirstElement()
          Gets first element.
 OMNode getFirstOMChild()
          Method getFirstOMChild.
 int getLineNumber()
           
 java.lang.String getLocalName()
          Method getLocalName.
 OMNamespace getNamespace()
          Method getNamespace.
 OMNode getNextOMSibling()
          Gets the next sibling.
 javax.xml.namespace.QName getQName()
          Method getQName.
 java.lang.String getText()
          Selects all the text children and concatinates them to a single string.
 javax.xml.namespace.QName getTextAsQName()
          OMText can contain its information as a QName as well.
 java.lang.String getTrimmedText()
          Returns the concatination string of TRIMMED values of all OMText child nodes of this element.
 int getType()
          Gets the type of node, as this is the super class of all the nodes.
 javax.xml.stream.XMLStreamReader getXMLStreamReader()
          Method getXMLStreamReader.
 javax.xml.stream.XMLStreamReader getXMLStreamReaderWithoutCaching()
          Method getXMLStreamReaderWithoutCaching.
 void internalSerialize(javax.xml.stream.XMLStreamWriter writer)
          Method internalSerialize.
protected  void internalSerialize(javax.xml.stream.XMLStreamWriter writer, boolean cache)
           
 void internalSerializeAndConsume(javax.xml.stream.XMLStreamWriter writer)
          This method serializes and consumes without building the object structure in memory.
 boolean isComplete()
          Method isComplete.
 void removeAttribute(OMAttribute attr)
          Method removeAttribute.
 javax.xml.namespace.QName resolveQName(java.lang.String qname)
          Converts a prefix:local qname string into a proper QName, evaluating it in the OMElement context.
 void setBuilder(OMXMLParserWrapper wrapper)
          Method setBuilder.
 void setFirstChild(OMNode firstChild)
          Method setFirstChild.
 void setLineNumber(int lineNumber)
           
 void setLocalName(java.lang.String localName)
          Method setLocalName.
 void setNamespace(OMNamespace namespace)
          Method setNamespace.
 void setNamespaceWithNoFindInCurrentScope(OMNamespace namespace)
          This will not search the namespace in the scope nor will declare in the current element, as in setNamespace(OMNamespace).
 void setText(javax.xml.namespace.QName text)
          Sets the text, as a QName, of the given element.
 void setText(java.lang.String text)
          Sets the text of the given element.
 java.lang.String toString()
          This is a convenience method only.
 java.lang.String toStringWithConsume()
          This is a convenience method only.
 
Methods inherited from class org.apache.axiom.om.impl.llom.OMNodeImpl
build, getOMFactory, getParent, getPreviousOMSibling, insertSiblingAfter, insertSiblingBefore, serialize, serialize, serialize, serialize, serialize, serializeAndConsume, serializeAndConsume, serializeAndConsume, serializeAndConsume, serializeAndConsume, setComplete, setNextOMSibling, setParent, setPreviousOMSibling, setType
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.apache.axiom.om.OMNode
build, getOMFactory, getParent, getPreviousOMSibling, insertSiblingAfter, insertSiblingBefore, serialize, serialize, serialize, serialize, serialize, serializeAndConsume, serializeAndConsume, serializeAndConsume, serializeAndConsume, serializeAndConsume
 
Methods inherited from interface org.apache.axiom.om.impl.OMContainerEx
setComplete
 

Field Detail

ns

protected OMNamespace ns
Field ns


localName

protected java.lang.String localName
Field localName


firstChild

protected OMNode firstChild
Field firstChild


namespaces

protected java.util.HashMap namespaces
Field namespaces


attributes

protected java.util.HashMap attributes
Field attributes


noPrefixNamespaceCounter

protected int noPrefixNamespaceCounter
Field noPrefixNamespaceCounter


lastChild

protected OMNode lastChild
Constructor Detail

OMElementImpl

public OMElementImpl(java.lang.String localName,
                     OMNamespace ns,
                     OMContainer parent,
                     OMXMLParserWrapper builder,
                     OMFactory factory)
Constructor OMElementImpl.


OMElementImpl

public OMElementImpl(java.lang.String localName,
                     OMNamespace ns,
                     OMFactory factory)
Constructor OMElementImpl.


OMElementImpl

public OMElementImpl(java.lang.String localName,
                     OMNamespace ns,
                     OMContainer parent,
                     OMFactory factory)
This is the basic constructor for OMElement. All the other constructors depends on this.

Parameters:
localName - - this MUST always be not null
ns - - can be null
parent - - this should be an OMContainer
factory - - factory that created this OMElement

OMElementImpl

public OMElementImpl(javax.xml.namespace.QName qname,
                     OMContainer parent,
                     OMFactory factory)
              throws OMException
It is assumed that the QName passed contains, at least, the localName for this element.

Parameters:
qname - - this should be valid qname according to javax.xml.namespace.QName
Throws:
OMException
Method Detail

addChild

public void addChild(OMNode child)
Adds child to the element. One can decide whether to append the child or to add to the front of the children list.

Specified by:
addChild in interface OMContainer
Parameters:
child -

getChildrenWithName

public java.util.Iterator getChildrenWithName(javax.xml.namespace.QName elementQName)
Searches for children with a given QName and returns an iterator to traverse through the OMNodes. This QName can contain any combination of prefix, localname and URI.

Specified by:
getChildrenWithName in interface OMContainer
Parameters:
elementQName - The QName specifying namespace and local name to match.
Returns:
Returns an iterator of OMElement items that match the given QName appropriately.
Throws:
OMException

getFirstChildWithName

public OMElement getFirstChildWithName(javax.xml.namespace.QName elementQName)
                                throws OMException
Method getFirstChildWithName.

Specified by:
getFirstChildWithName in interface OMContainer
Parameters:
elementQName - The QName to use for matching.
Returns:
Returns the first element in document order that matches the elementQName criteria.
Throws:
OMException
See Also:
OMContainer.getChildrenWithName(javax.xml.namespace.QName)

getNextOMSibling

public OMNode getNextOMSibling()
                        throws OMException
Gets the next sibling. This can be an OMAttribute or OMText or OMELement for others.

Specified by:
getNextOMSibling in interface OMNode
Overrides:
getNextOMSibling in class OMNodeImpl
Returns:
Returns OMNode.
Throws:
OMException

getChildren

public java.util.Iterator getChildren()
Returns a collection of this element. Children can be of types OMElement, OMText.

Specified by:
getChildren in interface OMContainer
Returns:
Returns children.
See Also:
OMContainer.getFirstChildWithName(javax.xml.namespace.QName), OMContainer.getChildrenWithName(javax.xml.namespace.QName)

getChildElements

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

Specified by:
getChildElements in interface OMElement
Returns:
Returns an iterator of the child elements.
See Also:
OMContainer.getChildren(), OMContainer.getChildrenWithName(javax.xml.namespace.QName)

declareNamespace

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

Specified by:
declareNamespace in interface OMElement
Parameters:
uri - The namespace to declare in the current scope. The caller is expected to ensure that the URI is a valid namespace name.
prefix - The prefix to associate with the given namespace. The caller is expected to ensure that this is a valid XML prefix. If "" is given, first this will check for an existing namespace with the same uri. If not found, a prefix will be auto-generated.
Returns:
Returns namespace.
See Also:
OMElement.declareNamespace(OMNamespace), OMElement.findNamespace(String, String), OMElement.getAllDeclaredNamespaces()

declareDefaultNamespace

public OMNamespace declareDefaultNamespace(java.lang.String uri)
We use "" to store the default namespace of this element. As one can see user can not give "" as the prefix, when he declare a usual namespace.

Specified by:
declareDefaultNamespace in interface OMElement
Parameters:
uri -
Returns:

getDefaultNamespace

public OMNamespace getDefaultNamespace()
Description copied from interface: OMElement
This will retrieve the default namespace of this element, if available. null returned if none is found.

Specified by:
getDefaultNamespace in interface OMElement
Returns:

declareNamespace

public OMNamespace declareNamespace(OMNamespace namespace)
Description copied from interface: OMElement
Declares a namespace with the element as its scope.

Specified by:
declareNamespace in interface OMElement
Parameters:
namespace - The namespace to declare.
Returns:
Returns namespace.
See Also:
OMElement.declareNamespace(String, String), OMElement.findNamespace(String, String), OMElement.getAllDeclaredNamespaces()

findNamespace

public OMNamespace findNamespace(java.lang.String uri,
                                 java.lang.String prefix)
Finds a namespace with the given uri and prefix, in the scope of the document. Starts to find from the current element and goes up in the hiararchy until one is found. If none is found, returns null.

Specified by:
findNamespace in interface OMElement
Parameters:
uri - The namespace to look for. If this is specified, prefix should be null.
prefix - The prefix to look for. If this is specified, uri should be null.
Returns:
Returns the matching namespace declaration, or null if none was found.
See Also:
OMElement.declareNamespace(String, String), OMElement.declareNamespace(OMNamespace), OMElement.getAllDeclaredNamespaces()

findNamespaceURI

public OMNamespace findNamespaceURI(java.lang.String prefix)
Description copied from interface: OMElement
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.

Specified by:
findNamespaceURI in interface OMElement
Parameters:
prefix -

getAllDeclaredNamespaces

public java.util.Iterator getAllDeclaredNamespaces()
Method getAllDeclaredNamespaces.

Specified by:
getAllDeclaredNamespaces in interface OMElement
Returns:
Returns Iterator.
See Also:
OMElement.findNamespace(String, String), OMElement.declareNamespace(String, String), OMElement.declareNamespace(OMNamespace)

getAllAttributes

public java.util.Iterator getAllAttributes()
Returns a List of OMAttributes.

Specified by:
getAllAttributes in interface OMElement
Returns:
Returns iterator.
See Also:
OMElement.getAttribute(javax.xml.namespace.QName), OMElement.addAttribute(OMAttribute), OMElement.addAttribute(String, String, OMNamespace)

getAttribute

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

Specified by:
getAttribute in interface OMElement
Parameters:
qname - the qualified name to search for
Returns:
Returns an OMAttribute with the given name if found, or null

getAttributeValue

public java.lang.String getAttributeValue(javax.xml.namespace.QName qname)
Returns a named attribute's value, if present.

Specified by:
getAttributeValue in interface OMElement
Parameters:
qname - the qualified name to search for
Returns:
Returns a String containing the attribute value, or null.

addAttribute

public OMAttribute addAttribute(OMAttribute attr)
Inserts an attribute to this element. Implementor can decide as to insert this in the front or at the end of set of attributes.

Specified by:
addAttribute in interface OMElement
Parameters:
attr - The attribute to add.
Returns:
Returns attribute.

removeAttribute

public void removeAttribute(OMAttribute attr)
Method removeAttribute.

Specified by:
removeAttribute in interface OMElement
Parameters:
attr -

addAttribute

public OMAttribute addAttribute(java.lang.String attributeName,
                                java.lang.String value,
                                OMNamespace ns)
Method addAttribute.

Specified by:
addAttribute in interface OMElement
Parameters:
attributeName - The "local name" for the attribute.
value - The string value of the attribute.
ns - The namespace has to be one of the in scope namespace. i.e. the passed namespace must be declared in the parent element of this attribute or ancestors of the parent element of the attribute.
Returns:
Returns OMAttribute.

setBuilder

public void setBuilder(OMXMLParserWrapper wrapper)
Method setBuilder.

Specified by:
setBuilder in interface OMElement
Parameters:
wrapper -

getBuilder

public OMXMLParserWrapper getBuilder()
Method getBuilder.

Specified by:
getBuilder in interface OMElement
Returns:
Returns OMXMLParserWrapper.

buildNext

public void buildNext()
Forces the parser to proceed, if parser has not yet finished with the XML input.

Specified by:
buildNext in interface OMContainer

getFirstOMChild

public OMNode getFirstOMChild()
Method getFirstOMChild.

Specified by:
getFirstOMChild in interface OMContainer
Returns:
Returns child.

setFirstChild

public void setFirstChild(OMNode firstChild)
Method setFirstChild.

Specified by:
setFirstChild in interface OMElement
Parameters:
firstChild -

detach

public OMNode detach()
              throws OMException
Removes this information item and its children, from the model completely.

Specified by:
detach in interface OMNode
Overrides:
detach in class OMNodeImpl
Throws:
OMException

isComplete

public boolean isComplete()
Method isComplete.

Specified by:
isComplete in interface OMNode
Overrides:
isComplete in class OMNodeImpl
Returns:
Returns boolean.

getType

public int getType()
Gets the type of node, as this is the super class of all the nodes.

Specified by:
getType in interface OMNode
Overrides:
getType in class OMNodeImpl
Returns:
Returns the type of node as indicated by OMNodeImpl.setType(int)
See Also:
OMNodeImpl.setType(int)

getXMLStreamReader

public javax.xml.stream.XMLStreamReader getXMLStreamReader()
Method getXMLStreamReader.

Specified by:
getXMLStreamReader in interface OMElement
Returns:
Returns an XMLStreamReader relative to this element.
See Also:
OMElement.getXMLStreamReader()

getXMLStreamReaderWithoutCaching

public javax.xml.stream.XMLStreamReader getXMLStreamReaderWithoutCaching()
Method getXMLStreamReaderWithoutCaching.

Specified by:
getXMLStreamReaderWithoutCaching in interface OMElement
Returns:
Returns an XMLStreamReader relative to this element, with no caching.
See Also:
OMElement.getXMLStreamReaderWithoutCaching()

setText

public void setText(java.lang.String text)
Sets the text of the given element. caution - This method will wipe out all the text elements (and hence any mixed content) before setting the text.

Specified by:
setText in interface OMElement
Parameters:
text -

setText

public void setText(javax.xml.namespace.QName text)
Sets the text, as a QName, of the given element. caution - This method will wipe out all the text elements (and hence any mixed content) before setting the text.

Specified by:
setText in interface OMElement

getText

public java.lang.String getText()
Selects all the text children and concatinates them to a single string.

Specified by:
getText in interface OMElement
Returns:
Returns String.

getTextAsQName

public javax.xml.namespace.QName getTextAsQName()
Description copied from interface: OMElement
OMText can contain its information as a QName as well. This will return the text as a QName

Specified by:
getTextAsQName in interface OMElement
Returns:

getTrimmedText

public java.lang.String getTrimmedText()
Returns the concatination string of TRIMMED values of all OMText child nodes of this element. This is included purely to improve usability.


internalSerialize

public void internalSerialize(javax.xml.stream.XMLStreamWriter writer)
                       throws javax.xml.stream.XMLStreamException
Method internalSerialize.

Specified by:
internalSerialize in interface OMNodeEx
Overrides:
internalSerialize in class OMNodeImpl
Parameters:
writer -
Throws:
javax.xml.stream.XMLStreamException
See Also:
#internalSerialize(org.apache.axiom.om.impl.MTOMXMLStreamWriter)

internalSerialize

protected void internalSerialize(javax.xml.stream.XMLStreamWriter writer,
                                 boolean cache)
                          throws javax.xml.stream.XMLStreamException
Throws:
javax.xml.stream.XMLStreamException

internalSerializeAndConsume

public void internalSerializeAndConsume(javax.xml.stream.XMLStreamWriter writer)
                                 throws javax.xml.stream.XMLStreamException
This method serializes and consumes without building the object structure in memory. Misuse of this method will cause loss of data. So it is advised to use populateYourSelf() method, before calling this method, if one wants to preserve data in the stream. This was requested during the second Axis2 summit.

Specified by:
internalSerializeAndConsume in interface OMNodeEx
Overrides:
internalSerializeAndConsume in class OMNodeImpl
Parameters:
writer -
Throws:
javax.xml.stream.XMLStreamException
See Also:
#internalSerializeAndConsume(org.apache.axiom.om.impl.MTOMXMLStreamWriter)

getFirstElement

public OMElement getFirstElement()
Gets first element.

Specified by:
getFirstElement in interface OMElement
Returns:
Returns element.

getLocalName

public java.lang.String getLocalName()
Method getLocalName.

Specified by:
getLocalName in interface OMElement
Returns:
Returns local name.

setLocalName

public void setLocalName(java.lang.String localName)
Method setLocalName.

Specified by:
setLocalName in interface OMElement
Parameters:
localName -

getNamespace

public OMNamespace getNamespace()
                         throws OMException
Method getNamespace.

Specified by:
getNamespace in interface OMElement
Returns:
Returns the OMNamespace object associated with this element
Throws:
OMException

setNamespace

public void setNamespace(OMNamespace namespace)
Method setNamespace.

Specified by:
setNamespace in interface OMElement
Parameters:
namespace -

setNamespaceWithNoFindInCurrentScope

public void setNamespaceWithNoFindInCurrentScope(OMNamespace namespace)
Description copied from interface: OMElement
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.

Specified by:
setNamespaceWithNoFindInCurrentScope in interface OMElement
Parameters:
namespace -

getQName

public javax.xml.namespace.QName getQName()
Method getQName.

Specified by:
getQName in interface OMElement
Returns:
Returns QName.

toStringWithConsume

public java.lang.String toStringWithConsume()
                                     throws javax.xml.stream.XMLStreamException
Description copied from interface: OMElement
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.

Specified by:
toStringWithConsume in interface OMElement
Throws:
javax.xml.stream.XMLStreamException

toString

public java.lang.String toString()
Description copied from interface: OMElement
This is a convenience method only. This will basically serialize the given OMElement to a String but will build the OMTree in the memory

Specified by:
toString in interface OMElement

discard

public void discard()
             throws OMException
Method discard.

Specified by:
discard in interface OMNode
Throws:
OMException

resolveQName

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

Specified by:
resolveQName in interface OMElement
Parameters:
qname - prefixed qname string to resolve
Returns:
Returns null for any failure to extract a qname.

cloneOMElement

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

Specified by:
cloneOMElement in interface OMElement
Returns:
Returns OMElement.

setLineNumber

public void setLineNumber(int lineNumber)
Specified by:
setLineNumber in interface OMElement

getLineNumber

public int getLineNumber()
Specified by:
getLineNumber in interface OMElement