Class Element

java.lang.Object

de.pdark.decentxml.NodeWithChildren

de.pdark.decentxml.Element

All Implemented Interfaces:

Child, Node, Parent, TextNode

public class Element
extends NodeWithChildren
implements Child, TextNode

An element in a XML document.

Elements can have attributes and they have children like a document.

See Also:

• Document
• Attribute

Field Summary

Fields

Modifier and Type	Field	Description
private Map<String, Attribute>	attributeMap
private String	beginName
private boolean	compactEmpty
static final NodeFilter<Element>	ELEMENT_FILTER
private String	endName
private String	name
private Namespace	namespace
private Parent	parent
private String	postSpace
private Token	startToken

Constructor Summary

Constructors

Constructor	Description
Element(Parent parent, String name)
Element(Parent parent, String name, Namespace ns)
Element(Token token)
Element(String name)
Element(String name, Namespace ns)

Method Summary

Modifier and Type	Method	Description
Element	addAttribute(Attribute a)
Element	addAttribute(String name, String value)
Element	addAttributes(Attribute... attributes)
Element	addNode(int index, Node node)
Element	addNode(Node node)
Element	addNodes(int index, Node... nodes)
Element	addNodes(int index, Collection<? extends Node> nodes)
Element	addNodes(Node... nodes)
Element	addNodes(Collection<? extends Node> nodes)
Element	checkMandatoryAttribute(String name)
int	childIndexOf(Element element)
Element	clearChildNodes()	Deprecated. Use Element.clearChildren() instead
Element	clearChildren()
Element	clearText()
Element	copy()	Simulate clone()
Element	copy(Node orig)	Copy all data from orig into this
Element	createClone()	Simulate clone()
Attribute	getAttribute(String name)
Attribute	getAttribute(String name, Namespace ns)
Map<String, Attribute>	getAttributeMap()
List<Attribute>	getAttributes()
String	getAttributeValue(String name)
String	getAttributeValue(String name, Namespace ns)
String	getBeginName()
Element	getChild(int index)
Element	getChild(String path)	Find a child element (not a node!) by path
Element	getChild(String path, Namespace ns)
String	getChildPath()
List<Element>	getChildren()
List<Element>	getChildren(String name)
List<Element>	getChildren(String name, Namespace ns)
Document	getDocument()
String	getEndName()
int	getEndOffset()
String	getName()
Namespace	getNamespace()
String	getNodePath()	Deprecated. Use Element.getChildPath() instead
String	getNormalizedText()
Parent	getParent()	The parent of this child
Element	getParentElement()
String	getPostSpace()	Space before the closing bracket of the element
int	getStartOffset()
Token	getStartToken()
String	getText()	Get the text from the node
String	getTrimmedText()
XMLTokenizer.Type	getType()	Get the node type
boolean	hasChildren()
boolean	isCompactEmpty()
void	remove()
Element	removeAttribute(String name)
Element	setAttribute(Attribute a)
Element	setAttribute(String name, String value)
Element	setAttribute(String name, String value, Namespace ns)
Element	setBeginName(String beginName)
Element	setCompactEmpty(boolean compactEmpty)
Element	setEndName(String endName)	The string to be put into the end tag.
Element	setName(String name)
void	setNamespace(Namespace namespace)
Element	setParent(Parent parent)	Change the parent of this child.
Element	setPostSpace(String postSpace)
Element	setText(String text)	Change the text of the node.
Element	toXML(XMLWriter writer)	Fast way to convert many nodes to XML

Methods inherited from class NodeWithChildren

clearNodes, getNode, getNodes, getNodes, hasNodes, nodeCount, nodeIndexOf, removeNode, removeNode, toString, toXML

Methods inherited from class Object

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

Methods inherited from interface Node

toXML

Field Details

startToken

private Token startToken

namespace

private Namespace namespace

beginName

private String beginName

postSpace

private String postSpace

endName

private String endName

name

private String name

parent

private Parent parent

attributeMap

private Map<String, Attribute> attributeMap

compactEmpty

private boolean compactEmpty

ELEMENT_FILTER

public static final NodeFilter<Element> ELEMENT_FILTER

Constructor Details

Element

public Element(Token token)

Element

public Element(String name)

Element

public Element(Parent parent,
 String name)

Element

public Element(String name,
 Namespace ns)

Element

public Element(Parent parent,
 String name,
 Namespace ns)

Method Details

getStartToken

public Token getStartToken()

getStartOffset

public int getStartOffset()

getEndOffset

public int getEndOffset()

getBeginName

public String getBeginName()

setBeginName

public Element setBeginName(String beginName)

getEndName

public String getEndName()

setEndName

public Element setEndName(String endName)

The string to be put into the end tag. This can contain whitespace around the name

getPostSpace

public String getPostSpace()

Space before the closing bracket of the element

setPostSpace

public Element setPostSpace(String postSpace)

setName

public Element setName(String name)

getName

public String getName()

getParent

public Parent getParent()

Description copied from interface: Child

The parent of this child

Specified by:

getParent in interface Child

setParent

public Element setParent(Parent parent)

Description copied from interface: Child

Change the parent of this child.

CAUTION: If the child is already attached to a parent, this call will not detach the old relation! You must call child.getParent().removeNode (child), first!

Specified by:

setParent in interface Child

addAttributes

public Element addAttributes(Attribute... attributes)

addAttribute

public Element addAttribute(String name,
 String value)

addAttribute

public Element addAttribute(Attribute a)

setAttribute

public Element setAttribute(Attribute a)

getAttributes

public List<Attribute> getAttributes()

getAttributeMap

public Map<String, Attribute> getAttributeMap()

getAttribute

public Attribute getAttribute(String name,
 Namespace ns)

getAttribute

public Attribute getAttribute(String name)

setAttribute

public Element setAttribute(String name,
 String value)

setAttribute

public Element setAttribute(String name,
 String value,
 Namespace ns)

checkMandatoryAttribute

public Element checkMandatoryAttribute(String name)

removeAttribute

public Element removeAttribute(String name)

getAttributeValue

public String getAttributeValue(String name)

getAttributeValue

public String getAttributeValue(String name,
 Namespace ns)

addNode

public Element addNode(Node node)

Specified by:

addNode in interface Parent

Overrides:

addNode in class NodeWithChildren

addNode

public Element addNode(int index,
 Node node)

Specified by:

addNode in interface Parent

Overrides:

addNode in class NodeWithChildren

addNodes

public Element addNodes(Collection<? extends Node> nodes)

Specified by:

addNodes in interface Parent

Overrides:

addNodes in class NodeWithChildren

addNodes

public Element addNodes(int index,
 Collection<? extends Node> nodes)

Specified by:

addNodes in interface Parent

Overrides:

addNodes in class NodeWithChildren

addNodes

public Element addNodes(Node... nodes)

Specified by:

addNodes in interface Parent

Overrides:

addNodes in class NodeWithChildren

addNodes

public Element addNodes(int index,
 Node... nodes)

Specified by:

addNodes in interface Parent

Overrides:

addNodes in class NodeWithChildren

setCompactEmpty

public Element setCompactEmpty(boolean compactEmpty)

isCompactEmpty

public boolean isCompactEmpty()

toXML

public Element toXML(XMLWriter writer)
              throws IOException

Description copied from interface: Node

Fast way to convert many nodes to XML

Specified by:

toXML in interface Node

Overrides:

toXML in class NodeWithChildren

Throws:

IOException

getType

public XMLTokenizer.Type getType()

Description copied from interface: Node

Get the node type

Specified by:

getType in interface Node

getChild

public Element getChild(int index)

hasChildren

public boolean hasChildren()

getChildren

public List<Element> getChildren()

getChildren

public List<Element> getChildren(String name)

getChildren

public List<Element> getChildren(String name,
 Namespace ns)

clearChildNodes

public Element clearChildNodes()

Deprecated.

Use Element.clearChildren() instead

clearChildren

public Element clearChildren()

getText

public String getText()

Description copied from interface: TextNode

Get the text from the node

Specified by:

getText in interface TextNode

getTrimmedText

public String getTrimmedText()

getNormalizedText

public String getNormalizedText()

setText

public Element setText(String text)

Description copied from interface: TextNode

Change the text of the node. When necessary, the text will be escaped before writing it to the output stream.

Specified by:

setText in interface TextNode

clearText

public Element clearText()

getParentElement

public Element getParentElement()

getNodePath

public String getNodePath()

Deprecated.

Use Element.getChildPath() instead

Description copied from interface: Child

Return a path which uniquely describes this child.

Specified by:

getNodePath in interface Child

getChildPath

public String getChildPath()

childIndexOf

public int childIndexOf(Element element)

getDocument

public Document getDocument()

getChild

public Element getChild(String path)

Description copied from interface: Parent

Find a child element (not a node!) by path

Specified by:

getChild in interface Parent

getChild

public Element getChild(String path,
 Namespace ns)

createClone

public Element createClone()

Description copied from interface: Node

Simulate clone()

Specified by:

createClone in interface Node

copy

public Element copy(Node orig)

Description copied from interface: Node

Copy all data from orig into this

Specified by:

copy in interface Node

Overrides:

copy in class NodeWithChildren

copy

public Element copy()

Description copied from interface: Node

Simulate clone()

Specified by:

copy in interface Node

Overrides:

copy in class NodeWithChildren

setNamespace

public void setNamespace(Namespace namespace)

getNamespace

public Namespace getNamespace()

remove

public void remove()

Specified by:

remove in interface Child