com.nt.udc.io.xml

Class CXMLElement

java.lang.Object

com.nt.udc.io.xml.CXMLContentItem

com.nt.udc.io.xml.CXMLElement

public class CXMLElement
extends CXMLContentItem

This class represents a XML element token.

A XML element may contain other XML character data or other XML elements. XML elements not contained by other XML elements are called root-elements.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	CXMLElement.CXMLElementEnum This class is used to enumerate the contents of a CXMLElement.

Field Summary

Fields

Modifier and Type	Field and Description
protected CXMLContentItem[]	m_content The XML element's content - an array of objects of type CXMLContentItem.
protected int	m_contentCount This member represents the numer of content items.
char[]	m_name This member represents the element's name.
protected CXMLElement	m_parent Reference to the element containing this element.

Constructor Summary

Constructors

Constructor and Description
CXMLElement(char[] name, CXMLElement parent)

Method Summary

Modifier and Type	Method and Description
void	addToContent(CXMLContentItem obj)
static CXMLElement	alloc(char[] name, CXMLElement parent)
void	free() This function is used for managing freed objects, which we reuse.
CXMLElement.CXMLElementEnum	getEnum()
char[]	getFilteredName()
char[]	getName()
CXMLElement	getParent()
java.lang.String	getPath()

Methods inherited from class java.lang.Object

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

Field Detail

m_parent

protected CXMLElement m_parent

Reference to the element containing this element. The reference is null in the case of root-elements.

m_name

public char[] m_name

This member represents the element's name.

Example: -> name = "Record:ingress"

m_content

protected CXMLContentItem[] m_content

The XML element's content - an array of objects of type CXMLContentItem.

m_contentCount

protected int m_contentCount

This member represents the numer of content items.

Constructor Detail

CXMLElement

public CXMLElement(char[] name,
                   CXMLElement parent)
            throws java.lang.Exception

Throws:

java.lang.Exception

Method Detail

getParent

public final CXMLElement getParent()

getName

public final char[] getName()

getFilteredName

public char[] getFilteredName()

Returns:

A filtered version of an element's name. Strips out newlines.

getEnum

public final CXMLElement.CXMLElementEnum getEnum()

addToContent

public void addToContent(CXMLContentItem obj)

getPath

public java.lang.String getPath()

Returns:

A string representing the concatenation of the names of all ascendents of this XML Element, starting with the associated contaning root-element. The names are separated by colons.

alloc

public static CXMLElement alloc(char[] name,
                                CXMLElement parent)
                         throws java.lang.Exception

Throws:

java.lang.Exception

free

public void free()

Description copied from class: CXMLContentItem

This function is used for managing freed objects, which we reuse.

Specified by:

free in class CXMLContentItem