Package com.lowagie.text.xml.simpleparser

Class SimpleXMLParser

java.lang.Object

com.lowagie.text.xml.simpleparser.SimpleXMLParser

public final class SimpleXMLParser
extends Object

A simple XML and HTML parser. This parser is, like the SAX parser, an event based parser, but with much less functionality.

The parser can:

• It recognizes the encoding used
• It recognizes all the elements' start tags and end tags
• It lists attributes, where attribute values can be enclosed in single or double quotes
• It recognizes the <[CDATA[ ... ]]> construct
• It recognizes the standard entities: &, <, >, ", and ', as well as numeric entities
• It maps lines ending in \r\n and \r to \n on input, in accordance with the XML Specification, Section 2.11

Method Summary

Modifier and Type	Method	Description
static String	escapeXML(String s, boolean onlyASCII)	Escapes a string with the appropriated XML codes.
static void	parse(SimpleXMLDocHandler doc, SimpleXMLDocHandlerComment comment, Reader r, boolean html)	Parses the XML document firing the events to the handler.
static void	parse(SimpleXMLDocHandler doc, InputStream in)	Parses the XML document firing the events to the handler.
static void	parse(SimpleXMLDocHandler doc, Reader r)

Methods inherited from class java.lang.Object

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

Method Details

parse

public static void parse(SimpleXMLDocHandler doc,
 SimpleXMLDocHandlerComment comment,
 Reader r,
 boolean html)
                  throws IOException

Parses the XML document firing the events to the handler.

Parameters:

doc - the document handler

r - the document. The encoding is already resolved. The reader is not closed

Throws:

IOException - on error

parse

public static void parse(SimpleXMLDocHandler doc,
 InputStream in)
                  throws IOException

Parses the XML document firing the events to the handler.

Parameters:

doc - the document handler

in - the document. The encoding is deduced from the stream. The stream is not closed

Throws:

IOException - on error

parse

public static void parse(SimpleXMLDocHandler doc,
 Reader r)
                  throws IOException

Throws:

IOException

escapeXML

public static String escapeXML(String s,
 boolean onlyASCII)

Escapes a string with the appropriated XML codes.

Parameters:

s - the string to be escaped

onlyASCII - codes above 127 will always be escaped with &#nn; if true

Returns:

the escaped string