cz.muni.fi.mathml.mathml2text.converter.impl

Class XmlParserStAX

java.lang.Object

cz.muni.fi.mathml.mathml2text.converter.impl.XmlParserStAX

public final class XmlParserStAX
extends Object

This parser is responsible for reading input file or string and invoking converter for every occurence of MathML code block in the input. Resulting output format depends on the type of input:

• XML file → output is an XML file in which every MathML node is substituted with converted value,
• string →
  1. if input string is just MathML element (parent node of XML is <math>), output will consist only of the converted string without any XML tags
  2. otherwise result will be similar to the case of input XML file, but instead of to file, the result will be written as string and outputted.

Author:

Maros Kucbel Oct 31, 2012, 19:07:12 PM

Constructor Summary

Constructors

Constructor and Description
XmlParserStAX() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
File	parse(File file, Locale language) Parses single file.
String	parse(String inputString, Locale language) Parses input string and converts every occurence of math element into plain text.

Methods inherited from class java.lang.Object

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

Constructor Detail

XmlParserStAX

public XmlParserStAX()

Constructor. XMLInputFactory is configured with values:

• XMLInputFactory.IS_REPLACING_ENTITY_REFERENCES &rarr true
• XMLInputFactory.IS_SUPPORTING_EXTERNAL_ENTITIES &rarr true
• XMLInputFactory.IS_COALESCING &rarr true
• XMLInputFactory.IS_VALIDATING &rarr false
• XMLInputFactory.SUPPORT_DTD &rarr true

Method Detail

parse

public String parse(@Nonnull
           String inputString,
           Locale language)
             throws UnsupportedLanguageException

Parses input string and converts every occurence of math element into plain text. Returned string is a concatenation of every such converted element.

Parameters:

inputString - Input.

language - Language of conversion.

Returns:

Input converted to plain text.

Throws:

UnsupportedLanguageException

parse

public File parse(@Nonnull
         File file,
         Locale language)

Parses single file. For every occurrence of math element inside input XML file new MathMLNode tree is builded and subsequently converted to string.

Parameters:

file - Input XML file.

language - Language of conversion.

Returns:

A file with every occurence of <math> tag replaced with converted string inside <mathconv> tag.

Throws:

UnsupportedLanguageException