cz.muni.fi.mir.mathmlunificator

Class DocumentParser

java.lang.Object

cz.muni.fi.mir.mathmlunificator.DocumentParser

public class DocumentParser
extends Object

Tools for analysing XML documents and extracting wanted data.

Author:

Michal Růžička

Constructor Summary

Constructors

Constructor and Description
DocumentParser()

Method Summary

Modifier and Type	Method and Description
static List<Node>	findMathMLNodes(Document doc) Find MathML nodes in the W3C DOM represented input XML document and return collection of links to thiese nodes to the DOM.

Methods inherited from class java.lang.Object

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

Constructor Detail

DocumentParser

public DocumentParser()

Method Detail

findMathMLNodes

public static List<Node> findMathMLNodes(Document doc)

Find MathML nodes in the W3C DOM represented input XML document and return collection of links to thiese nodes to the DOM.

The method is XML namespace aware and expectes the input DOM to be build as XML aware (see DocumentBuilderFactory.setNamespaceAware(boolean)).

In case the input DOM was created as namespace unaware or the input XML document does not correctly use namespaces the method tries to fall back to element-plain-name-only maths nodes detection. The behaviour is as follows:

1. Find all <math> elements (see Constants.MATHML_ROOT_ELEM) in MathML namespace, i.e. XML namespace represented by URI http://www.w3.org/1998/Math/MathML (see Constants.MATHML_NS). If at least one element is found, stop futher processing and return collection of links to these nodes.
2. Find any <math> named elements regadless of XML namespaces. If at least one element is found, stop futher processing and return collection of links to these nodes.
3. Return empty list.

Parameters:

doc - W3C DOM representation of the XML document to find maths nodes in.

Returns:

Collection of maths W3C DOM Nodes that are still linkend to the original input DOM.

See Also:

DOMBuilder