Tigase XML Tools is a library providing support for fast and efficient parsing and working with XML documents.
It contains of many classes however three of them, described below, are the most important.
This class represent single XML element. Contains element name, namespace, attributes and inner elements if any. Instances of this class are mutable and not synchronized, so it is required to make sure that only single thread will work on particular instance of the
Methods which name contains
StaticStr require that passed parameters are static strings, which mean that strings needs be static or result of
String::intern() method. This requirement is a result of usage
== instead of
.eqauls() for comparison inside this methods which make this comparison faster.
1.1.1. Creating new instance
To create new element instance one of a few constructors may be used. Each of them require as a first argument the name of element.
Element attributes are easily accessing using one of following methods:
String getAttributeStaticStr(String attName)
Method returns attribute value for passed attribute name. It will return
nullif attribute is not set.
Map<String, String> getAttributes()
Method returns a map of attributes which are set for this XML element.
You may easily modify attribute values by using one of following methods:
void setAttribute(String key, String value)
Set value for the attribute. Does not support
nullvalue. To remove a value for attribute, you need to use
void setAttributes(Map<String, String> newAttributes)
Sets attributes for element to attribute and values passed in provided map.
void removeAttribute(String key)
Removes attribute and its value from element attributes.
Each instance of the
Element class may contain elements inside it (inner elements) named here children. To access them you may call:
Element getChild(String name);
Element getChild(String name, String child_xmlns);
Element getChildStaticStr(String name);
Element getChildStaticStr(String name, String child_xmlns)
Returns a child element or
Returns a list of children elements or
Each of this methods may return a null if there is no child matching requirements.
To add elements as a children of the element call
void addChild(XMLNodeIfc child) or
void addChildren(List<Element> children). To remove elements, you need to retrieve instance of the
Element which you want to removed and call
boolean removeChild(Element child).
In XML each element may have value assigned. To retrieve elements value you need to call
String getCData() and to set elements value
void setCData(String argCData).
This class is an implementation of
SimpleHandler interface, which is responsible for creation of elements and building XML trees in response to its method calls made by
SimpleParser (XML parser).
It is an implementation of a XML parser which is responsible for parsing provided array of chars and calling instance of
SimpleHandler to react on element being read, etc.