Interface XmlNode

All Superinterfaces:

XmlStartTag, XmlTag

All Known Subinterfaces:

XmlPullNode

public interface XmlNode
extends XmlStartTag

This class represents XML subtree. XmlNode is extension of XmlStartTag adding support for children (some of them may be also XmlNode so we get recursively built tree) and namespaces declarations associated with this node. When node has no children and namespaces declared it is essentially equivalent to XmlStartTag.

When XmlNode user does not need namespaces then namespace related methods may be ignored. However to use namespaces it is required to:

• call setDefaultNamespaceUri() to associate default namespace in which this node is declared
• and to declare additional namespaces (as of xmlns:prefix="...") with calling first removeNamespaces() and then addNamespaces()

Author:

Aleksander Slominski

See Also:

• XmlStartTag

Method Summary

Modifier and Type	Method	Description
void	addDeclaredNamespaces(String[] prefix, int off, int len, String[] namespaceUri)	NOTE: node SHOULD NOT keep references to passed arrays!
void	addNamespaceDeclaration(String prefix, String namespaceUri)
void	appendChild(Object child)
Enumeration	children()
void	ensureChildrenCapacity(int minCapacity)
void	ensureDeclaredNamespacesCapacity(int minCapacity)
Object	getChildAt(int pos)
int	getChildrenCount()	it may need to reconsruct whole subtree to get count ...
int	getDeclaredNamespaceLength()
String	getDefaultNamespaceUri()	Namesapce URI associated with default namesapce prefix (xmlns='....')
XmlNode	getParentNode()
String	getQNameLocal(String qName)	Return local part of qname.
String	getQNameUri(String qName)	Return uri part of qname.
void	insertChildAt(int pos, Object child)
String	namespace2Prefix(String namespaceUri)	return prefix for namesapce searching node tree upward.
XmlNode	newNode()	context sensitive factory method to create the same type of node
XmlNode	newNode(String amespaceUri, String localName)
String	prefix2Namespace(String prefix)	return namespace for prefix searching node tree upward.
void	readDeclaredNamespaceUris(String[] uris, int off, int len)
void	readDeclaredPrefixes(String[] prefixes, int off, int len)
void	removeChildAt(int pos)
void	removeChildren()	Removes all children - every child that was implementing XmlNode will have set parent to null.
void	removeDeclaredNamespaces()
void	replaceChildAt(int pos, Object child)
void	resetNode()	Clear all Tag state to default values.
void	setDefaultNamespaceUri(String defaultNamespaceUri)	Set default namesapce URI (xmlns='....')
void	setParentNode(XmlNode parent)

Methods inherited from interface XmlStartTag

addAttribute, addAttribute, ensureAttributesCapacity, getAttributeCount, getAttributeLocalName, getAttributeNamespaceUri, getAttributePrefix, getAttributeRawName, getAttributeValue, getAttributeValueFromName, getAttributeValueFromRawName, isAttributeNamespaceDeclaration, removeAttributeByName, removeAttributeByRawName, removeAttributes, resetStartTag

Methods inherited from interface XmlTag

getLocalName, getNamespaceUri, getPrefix, getRawName, modifyTag, resetTag

Method Details

resetNode

void resetNode()

Clear all Tag state to default values.

newNode

XmlNode newNode()
         throws XmlPullParserException

context sensitive factory method to create the same type of node

Throws:

XmlPullParserException

newNode

XmlNode newNode(String amespaceUri,
 String localName)
         throws XmlPullParserException

Throws:

XmlPullParserException

getParentNode

XmlNode getParentNode()

setParentNode

void setParentNode(XmlNode parent)
            throws XmlPullParserException

Throws:

XmlPullParserException

children

Enumeration children()

getChildrenCount

int getChildrenCount()

it may need to reconsruct whole subtree to get count ...

getChildAt

Object getChildAt(int pos)

appendChild

void appendChild(Object child)
          throws XmlPullParserException

Throws:

XmlPullParserException

insertChildAt

void insertChildAt(int pos,
 Object child)
            throws XmlPullParserException

Throws:

XmlPullParserException

removeChildAt

void removeChildAt(int pos)
            throws XmlPullParserException

Throws:

XmlPullParserException

replaceChildAt

void replaceChildAt(int pos,
 Object child)
             throws XmlPullParserException

Throws:

XmlPullParserException

ensureChildrenCapacity

void ensureChildrenCapacity(int minCapacity)
                     throws XmlPullParserException

Throws:

XmlPullParserException

removeChildren

void removeChildren()
             throws XmlPullParserException

Removes all children - every child that was implementing XmlNode will have set parent to null.

Throws:

XmlPullParserException

getQNameLocal

String getQNameLocal(String qName)
              throws XmlPullParserException

Return local part of qname. For example for 'xsi:type' it returns 'type'.

Throws:

XmlPullParserException

getQNameUri

String getQNameUri(String qName)
            throws XmlPullParserException

Return uri part of qname. The return value is dependent on declared namespaces in this node and possible when looking for value in parent node. For example for 'xsi:type' if xsi namespace prefix was declared to 'http://foo' it will return 'http://foo'.

Throws:

XmlPullParserException

prefix2Namespace

String prefix2Namespace(String prefix)
                 throws XmlPullParserException

return namespace for prefix searching node tree upward.

Throws:

XmlPullParserException

namespace2Prefix

String namespace2Prefix(String namespaceUri)
                 throws XmlPullParserException

return prefix for namesapce searching node tree upward.

Throws:

XmlPullParserException

getDefaultNamespaceUri

String getDefaultNamespaceUri()

Namesapce URI associated with default namesapce prefix (xmlns='....')

setDefaultNamespaceUri

void setDefaultNamespaceUri(String defaultNamespaceUri)
                     throws XmlPullParserException

Set default namesapce URI (xmlns='....')

Throws:

XmlPullParserException

getDeclaredNamespaceLength

int getDeclaredNamespaceLength()

readDeclaredNamespaceUris

void readDeclaredNamespaceUris(String[] uris,
 int off,
 int len)
                        throws XmlPullParserException

Throws:

XmlPullParserException

readDeclaredPrefixes

void readDeclaredPrefixes(String[] prefixes,
 int off,
 int len)
                   throws XmlPullParserException

Throws:

XmlPullParserException

ensureDeclaredNamespacesCapacity

void ensureDeclaredNamespacesCapacity(int minCapacity)
                               throws XmlPullParserException

Throws:

XmlPullParserException

addNamespaceDeclaration

void addNamespaceDeclaration(String prefix,
 String namespaceUri)
                      throws XmlPullParserException

Throws:

XmlPullParserException

addDeclaredNamespaces

void addDeclaredNamespaces(String[] prefix,
 int off,
 int len,
 String[] namespaceUri)
                    throws XmlPullParserException

NOTE: node SHOULD NOT keep references to passed arrays!

Throws:

XmlPullParserException

removeDeclaredNamespaces

void removeDeclaredNamespaces()
                       throws XmlPullParserException

Throws:

XmlPullParserException