Package org.xmlpull.v1.builder.adapter

Class XmlElementAdapter

java.lang.Object

org.xmlpull.v1.builder.adapter.XmlElementAdapter

All Implemented Interfaces:

Cloneable, XmlContained, XmlContainer, XmlElement

public class XmlElementAdapter
extends Object
implements XmlElement

Field Summary

Fields inherited from interface org.xmlpull.v1.builder.XmlElement

NO_NAMESPACE

Constructor Summary

Constructors

Constructor	Description
XmlElementAdapter(XmlElement target)

Method Summary

Modifier and Type	Method	Description
XmlAttribute	addAttribute(String name, String value)	addAttribute
XmlAttribute	addAttribute(String attributeType, String attributePrefix, String attributeNamespace, String attributeName, String attributeValue, boolean specified)	Method addAttribute
XmlAttribute	addAttribute(String type, XmlNamespace namespace, String name, String value)	Method addAttribute
XmlAttribute	addAttribute(String type, XmlNamespace namespace, String name, String value, boolean specified)	Method addAttribute
XmlAttribute	addAttribute(XmlAttribute attributeValueToAdd)	Add attribute (adds it to the XML Infoset [namespace attributes] set) Attribute mist
XmlAttribute	addAttribute(XmlNamespace namespace, String name, String value)	Method addAttribute
void	addChild(int pos, Object child)	Method addChild
void	addChild(Object child)	NOTE: =child added is _not_ checked if it XmlContainer, caller must manually fix parent in child by calling setParent() !!!!
XmlElement	addElement(int pos, XmlElement child)	Method addElement
XmlElement	addElement(String name)	Method addElement
XmlElement	addElement(XmlElement child)	NOTE: the child element must unattached to be added (it is atttached if it is XmlContainer of recognized type and getParent() != null)
XmlElement	addElement(XmlNamespace namespace, String name)	Method addElement
XmlAttribute	attribute(String attributeName)	Find attribute that matches given name or namespace Returns null if not found.
XmlAttribute	attribute(XmlNamespace attributeNamespaceName, String attributeName)	Find attribute that matches given name or namespace Returns null if not found.
Iterator	attributes()	Return Iterator - null is never returned if there is no children then iteraotr over empty collection is returned
static XmlElementAdapter	castOrWrap(XmlElement el, Class adapterClass)
Iterator	children()	Return Iterator
Object	clone()	Method clone
XmlNamespace	declareNamespace(String prefix, String namespaceName)	Create new namespace with prefix and namespace name (both must be not null) and add it to current element.
XmlNamespace	declareNamespace(XmlNamespace namespace)	Add namespace to current element (both prefix and namespace name must be not null)
XmlElement	element(int position)	return element at poition (0..count-1) or IndexOutOfBoundsException if positon incorrect
XmlElement	element(XmlNamespace n, String name)	find first element with name and namespace (if namespace is null it is ignored in search)
XmlElement	element(XmlNamespace n, String name, boolean create)	find first element with name and namespace (if namespace is null it is ignored in search) if no matching element is found then new element is created, appended to children, and returned
Iterable	elements(XmlNamespace n, String name)	Return all elements that has namespace and name (null is never returned but empty iteraotr)
void	ensureAttributeCapacity(int minCapacity)	Method ensureAttributeCapacity
void	ensureChildrenCapacity(int minCapacity)	Method ensureChildrenCapacity
void	ensureNamespaceDeclarationsCapacity(int minCapacity)	Method ensureNamespaceDeclarationsCapacity
XmlAttribute	findAttribute(String attributeNamespaceName, String attributeName)	Find attribute that matches given name or namespace Returns null if not found.
XmlElement	findElementByName(String name)
XmlElement	findElementByName(String namespaceName, String name)
XmlElement	findElementByName(String namespaceName, String name, XmlElement elementToStartLooking)
XmlElement	findElementByName(String name, XmlElement elementToStartLooking)
String	getAttributeValue(String attributeNamespaceName, String attributeName)	Method getAttributeValue
String	getBaseUri()	XML Infoset [base URI] property
String	getName()	XML Infoset [local name] property.
XmlNamespace	getNamespace()	Return namespace of current element (XML Infoset [namespace name] and [prefix] properties combined) null is only returned if element was created without namespace
String	getNamespaceName()	Return namespace name (XML Infoset [namespace name]property or null if element has no namespace
XmlContainer	getParent()	XML Infoset [parent] property.
XmlContainer	getRoot()	Get top most container that is either XmlDocument or XmlElement (may be event this element!!!)
XmlElement	getTarget()
XmlElementAdapter	getTopAdapter()
boolean	hasAttributes()	Method hasAttributes
boolean	hasChild(Object child)	Method hasChild
boolean	hasChildren()	Method hasChildren
boolean	hasNamespaceDeclarations()	Method hasNamespaceDeclarations
void	insertChild(int pos, Object childToInsert)
XmlNamespace	lookupNamespaceByName(String namespaceName)	Find namespace (will have non empty prefix) corresponding to namespace name checking first current elemen and if not found continue in parent (if element has parent).
XmlNamespace	lookupNamespaceByPrefix(String namespacePrefix)	Find namespace (will have non empty prefix) corresponding to namespace prefix checking first current elemen and if not found continue in parent (if element has parent) and so on.
Iterator	namespaces()	Return Iterator - null is never returned if there is no children then iteraotr over empty collection is returned
XmlElement	newElement(String name)	Create unattached element
XmlElement	newElement(String namespaceName, String name)	Method newElement
XmlElement	newElement(XmlNamespace namespace, String name)	Method newElement
XmlNamespace	newNamespace(String namespaceName)	Create new namespace with null prefix (namespace name must be not null).
XmlNamespace	newNamespace(String prefix, String namespaceName)	Create new namespace with prefix and namespace name (both must be not null).
void	removeAllAttributes()	Method removeAllAttributes
void	removeAllChildren()	Removes all children - every child that was implementing XmlNode will have set parent to null.
void	removeAllNamespaceDeclarations()	Method removeAllNamespaceDeclarations
void	removeAttribute(XmlAttribute attr)	Method removeAttribute
void	removeChild(Object child)	Method removeChild
void	replaceChild(Object newChild, Object oldChild)	Method replaceChild
void	replaceChildrenWithText(String textContent)	Remove all children and then add this text as only child.
XmlElement	requiredElement(XmlNamespace n, String name)	call element(n, name) and if null was returnedthrow XmlBuilderException
Iterable	requiredElementContent()	Return Iterator - that represents all XmlElement content.
String	requiredTextContent()	return children content as text - if there are any no text children throw exception
void	setBaseUri(String baseUri)	XML Infoset [base URI] property
void	setName(String name)	XML Infoset [local name] property.
void	setNamespace(XmlNamespace namespace)	Set namespace ot use for theis element.
void	setParent(XmlContainer parent)	Method setParent
void	setTopAdapter(XmlElementAdapter adapter)

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

XmlElementAdapter

public XmlElementAdapter(XmlElement target)

Method Detail

clone

public Object clone()
             throws CloneNotSupportedException

Description copied from interface: XmlElement

Method clone

Specified by:

clone in interface XmlElement

Overrides:

clone in class Object

Returns:

an Object

Throws:

CloneNotSupportedException

getTarget

public XmlElement getTarget()

getTopAdapter

public XmlElementAdapter getTopAdapter()

setTopAdapter

public void setTopAdapter(XmlElementAdapter adapter)

castOrWrap

public static XmlElementAdapter castOrWrap(XmlElement el,
                                           Class adapterClass)

getRoot

public XmlContainer getRoot()

Description copied from interface: XmlElement

Get top most container that is either XmlDocument or XmlElement (may be event this element!!!)

Specified by:

getRoot in interface XmlElement

getParent

public XmlContainer getParent()

Description copied from interface: XmlElement

XML Infoset [parent] property. If current element is not child of containing parent XmlElement or XmlDocument then builder exception will be thrown

Specified by:

getParent in interface XmlContained

Specified by:

getParent in interface XmlElement

setParent

public void setParent(XmlContainer parent)

Description copied from interface: XmlElement

Method setParent

Specified by:

setParent in interface XmlContained

Specified by:

setParent in interface XmlElement

Parameters:

parent - a XmlContainer

newNamespace

public XmlNamespace newNamespace(String prefix,
                                 String namespaceName)

Description copied from interface: XmlElement

Create new namespace with prefix and namespace name (both must be not null).

Specified by:

newNamespace in interface XmlElement

attribute

public XmlAttribute attribute(String attributeName)

Description copied from interface: XmlElement

Find attribute that matches given name or namespace Returns null if not found. Will match only attribute that have no namesapce.

Specified by:

attribute in interface XmlElement

attribute

public XmlAttribute attribute(XmlNamespace attributeNamespaceName,
                              String attributeName)

Description copied from interface: XmlElement

Find attribute that matches given name or namespace Returns null if not found. NOTE: if namespace is null in this case it will match only attributes that have no namespace.

Specified by:

attribute in interface XmlElement

findAttribute

public XmlAttribute findAttribute(String attributeNamespaceName,
                                  String attributeName)

Description copied from interface: XmlElement

Find attribute that matches given name or namespace Returns null if not found. NOTE: if namespace is null in this case it will match only attributes that has no namespace.

Specified by:

findAttribute in interface XmlElement

attributes

public Iterator attributes()

Description copied from interface: XmlElement

Return Iterator - null is never returned if there is no children then iteraotr over empty collection is returned

Specified by:

attributes in interface XmlElement

removeAllChildren

public void removeAllChildren()

Description copied from interface: XmlElement

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

Specified by:

removeAllChildren in interface XmlElement

addAttribute

public XmlAttribute addAttribute(String attributeType,
                                 String attributePrefix,
                                 String attributeNamespace,
                                 String attributeName,
                                 String attributeValue,
                                 boolean specified)

Description copied from interface: XmlElement

Method addAttribute

Specified by:

addAttribute in interface XmlElement

Parameters:

attributeType - a String

attributePrefix - a String

attributeNamespace - a String

attributeName - a String

attributeValue - a String

specified - a boolean

Returns:

a XmlAttribute

getAttributeValue

public String getAttributeValue(String attributeNamespaceName,
                                String attributeName)

Description copied from interface: XmlElement

Method getAttributeValue

Specified by:

getAttributeValue in interface XmlElement

attributeName - a String

Returns:

a String

addAttribute

public XmlAttribute addAttribute(XmlNamespace namespace,
                                 String name,
                                 String value)

Description copied from interface: XmlElement

Method addAttribute

Specified by:

addAttribute in interface XmlElement

Parameters:

namespace - a XmlNamespace

name - a String

value - a String

Returns:

a XmlAttribute

getNamespaceName

public String getNamespaceName()

Description copied from interface: XmlElement

Return namespace name (XML Infoset [namespace name]property or null if element has no namespace

Specified by:

getNamespaceName in interface XmlElement

ensureChildrenCapacity

public void ensureChildrenCapacity(int minCapacity)

Description copied from interface: XmlElement

Method ensureChildrenCapacity

Specified by:

ensureChildrenCapacity in interface XmlElement

Parameters:

minCapacity - an int

namespaces

public Iterator namespaces()

Description copied from interface: XmlElement

Return Iterator - null is never returned if there is no children then iteraotr over empty collection is returned

Specified by:

namespaces in interface XmlElement

removeAllAttributes

public void removeAllAttributes()

Description copied from interface: XmlElement

Method removeAllAttributes

Specified by:

removeAllAttributes in interface XmlElement

getNamespace

public XmlNamespace getNamespace()

Description copied from interface: XmlElement

Return namespace of current element (XML Infoset [namespace name] and [prefix] properties combined) null is only returned if element was created without namespace

Specified by:

getNamespace in interface XmlElement

getBaseUri

public String getBaseUri()

Description copied from interface: XmlElement

XML Infoset [base URI] property

Specified by:

getBaseUri in interface XmlElement

Returns:

a String

removeAttribute

public void removeAttribute(XmlAttribute attr)

Description copied from interface: XmlElement

Method removeAttribute

Specified by:

removeAttribute in interface XmlElement

Parameters:

attr - a XmlAttribute

declareNamespace

public XmlNamespace declareNamespace(String prefix,
                                     String namespaceName)

Description copied from interface: XmlElement

Create new namespace with prefix and namespace name (both must be not null) and add it to current element.

Specified by:

declareNamespace in interface XmlElement

removeAllNamespaceDeclarations

public void removeAllNamespaceDeclarations()

Description copied from interface: XmlElement

Method removeAllNamespaceDeclarations

Specified by:

removeAllNamespaceDeclarations in interface XmlElement

hasAttributes

public boolean hasAttributes()

Description copied from interface: XmlElement

Method hasAttributes

Specified by:

hasAttributes in interface XmlElement

Returns:

a boolean

addAttribute

public XmlAttribute addAttribute(String type,
                                 XmlNamespace namespace,
                                 String name,
                                 String value,
                                 boolean specified)

Description copied from interface: XmlElement

Method addAttribute

Specified by:

addAttribute in interface XmlElement

Parameters:

type - a String

namespace - a XmlNamespace

name - a String

value - a String

specified - a boolean

Returns:

a XmlAttribute

declareNamespace

public XmlNamespace declareNamespace(XmlNamespace namespace)

Description copied from interface: XmlElement

Add namespace to current element (both prefix and namespace name must be not null)

Specified by:

declareNamespace in interface XmlElement

addAttribute

public XmlAttribute addAttribute(String name,
                                 String value)

Description copied from interface: XmlElement

addAttribute

Specified by:

addAttribute in interface XmlElement

Parameters:

name - a String

value - a String

Returns:

a XmlAttribute

hasNamespaceDeclarations

public boolean hasNamespaceDeclarations()

Description copied from interface: XmlElement

Method hasNamespaceDeclarations

Specified by:

hasNamespaceDeclarations in interface XmlElement

Returns:

a boolean

lookupNamespaceByName

public XmlNamespace lookupNamespaceByName(String namespaceName)

Description copied from interface: XmlElement

Find namespace (will have non empty prefix) corresponding to namespace name checking first current elemen and if not found continue in parent (if element has parent). and so on.

Specified by:

lookupNamespaceByName in interface XmlElement

lookupNamespaceByPrefix

public XmlNamespace lookupNamespaceByPrefix(String namespacePrefix)

Description copied from interface: XmlElement

Find namespace (will have non empty prefix) corresponding to namespace prefix checking first current elemen and if not found continue in parent (if element has parent) and so on.

Specified by:

lookupNamespaceByPrefix in interface XmlElement

newNamespace

public XmlNamespace newNamespace(String namespaceName)

Description copied from interface: XmlElement

Create new namespace with null prefix (namespace name must be not null).

Specified by:

newNamespace in interface XmlElement

setBaseUri

public void setBaseUri(String baseUri)

Description copied from interface: XmlElement

XML Infoset [base URI] property

Specified by:

setBaseUri in interface XmlElement

Parameters:

baseUri - a String

setNamespace

public void setNamespace(XmlNamespace namespace)

Description copied from interface: XmlElement

Set namespace ot use for theis element. Note: namespace prefix is always ignored.

Specified by:

setNamespace in interface XmlElement

ensureNamespaceDeclarationsCapacity

public void ensureNamespaceDeclarationsCapacity(int minCapacity)

Description copied from interface: XmlElement

Method ensureNamespaceDeclarationsCapacity

Specified by:

ensureNamespaceDeclarationsCapacity in interface XmlElement

Parameters:

minCapacity - an int

getName

public String getName()

Description copied from interface: XmlElement

XML Infoset [local name] property.

Specified by:

getName in interface XmlElement

Returns:

a String

setName

public void setName(String name)

Description copied from interface: XmlElement

XML Infoset [local name] property.

Specified by:

setName in interface XmlElement

Parameters:

name - a String

addAttribute

public XmlAttribute addAttribute(String type,
                                 XmlNamespace namespace,
                                 String name,
                                 String value)

Description copied from interface: XmlElement

Method addAttribute

Specified by:

addAttribute in interface XmlElement

Parameters:

type - a String

namespace - a XmlNamespace

name - a String

value - a String

Returns:

a XmlAttribute

ensureAttributeCapacity

public void ensureAttributeCapacity(int minCapacity)

Description copied from interface: XmlElement

Method ensureAttributeCapacity

Specified by:

ensureAttributeCapacity in interface XmlElement

Parameters:

minCapacity - an int

addAttribute

public XmlAttribute addAttribute(XmlAttribute attributeValueToAdd)

Description copied from interface: XmlElement

Add attribute (adds it to the XML Infoset [namespace attributes] set) Attribute mist

Specified by:

addAttribute in interface XmlElement

Parameters:

attributeValueToAdd - a XmlAttribute

Returns:

a XmlAttribute

element

public XmlElement element(int position)

Description copied from interface: XmlElement

return element at poition (0..count-1) or IndexOutOfBoundsException if positon incorrect

Specified by:

element in interface XmlElement

requiredElement

public XmlElement requiredElement(XmlNamespace n,
                                  String name)

Description copied from interface: XmlElement

call element(n, name) and if null was returnedthrow XmlBuilderException

Specified by:

requiredElement in interface XmlElement

element

public XmlElement element(XmlNamespace n,
                          String name)

Description copied from interface: XmlElement

find first element with name and namespace (if namespace is null it is ignored in search)

Specified by:

element in interface XmlElement

element

public XmlElement element(XmlNamespace n,
                          String name,
                          boolean create)

Description copied from interface: XmlElement

find first element with name and namespace (if namespace is null it is ignored in search) if no matching element is found then new element is created, appended to children, and returned

Specified by:

element in interface XmlElement

elements

public Iterable elements(XmlNamespace n,
                         String name)

Description copied from interface: XmlElement

Return all elements that has namespace and name (null is never returned but empty iteraotr)

Specified by:

elements in interface XmlElement

findElementByName

public XmlElement findElementByName(String name,
                                    XmlElement elementToStartLooking)

Specified by:

findElementByName in interface XmlElement

newElement

public XmlElement newElement(XmlNamespace namespace,
                             String name)

Description copied from interface: XmlElement

Method newElement

Specified by:

newElement in interface XmlElement

Parameters:

namespace - a XmlNamespace

name - a String

Returns:

a XmlElement

addElement

public XmlElement addElement(XmlElement child)

Description copied from interface: XmlElement

NOTE: the child element must unattached to be added (it is atttached if it is XmlContainer of recognized type and getParent() != null)

Specified by:

addElement in interface XmlElement

addElement

public XmlElement addElement(int pos,
                             XmlElement child)

Description copied from interface: XmlElement

Method addElement

Specified by:

addElement in interface XmlElement

Parameters:

pos - an int (starting from 0)

child - a XmlElement

Returns:

a XmlElement

addElement

public XmlElement addElement(String name)

Description copied from interface: XmlElement

Method addElement

Specified by:

addElement in interface XmlElement

Parameters:

name - a String

Returns:

a XmlElement

findElementByName

public XmlElement findElementByName(String namespaceName,
                                    String name)

Specified by:

findElementByName in interface XmlElement

addChild

public void addChild(Object child)

Description copied from interface: XmlElement

NOTE: =child added is _not_ checked if it XmlContainer, caller must manually fix parent in child by calling setParent() !!!!

Specified by:

addChild in interface XmlElement

insertChild

public void insertChild(int pos,
                        Object childToInsert)

Specified by:

insertChild in interface XmlElement

findElementByName

public XmlElement findElementByName(String name)

Specified by:

findElementByName in interface XmlElement

findElementByName

public XmlElement findElementByName(String namespaceName,
                                    String name,
                                    XmlElement elementToStartLooking)

Specified by:

findElementByName in interface XmlElement

removeChild

public void removeChild(Object child)

Description copied from interface: XmlElement

Method removeChild

Specified by:

removeChild in interface XmlElement

Parameters:

child - an Object

children

public Iterator children()

Description copied from interface: XmlElement

Return Iterator