Before parsing is possible you have to set your
XFastDocumentHandler using setFastDocumentHandler.
Parsing starts with calling parseStream. If the parser
finds a valid xml file with the given InputSource, it calls
XFastDocumentHandler::startDocument first.
This parser generates either 'fast' events that use integer token
values for namespaces, elements and attributes or 'unknown' events for
elements that are unknown.
A namespace is unknown if the namespace URL was not registered with
registerNamespace.
An element is unknown if no XFastTokenHandler is set
or if the XFastTokenHandler does not return a valid
identifier for the elements local name. An element is also unknown if
the elements local name is known but it uses a namespace that is unknown.
Setting a XFastTokenHandler with setTokenHandler
is optional, but without a XFastTokenHandler you will only
get unknown sax events. This can be useful if you are only interested
in the namespace handling and/or the context feature.
For each element the parser sends a create child element event to the
elements parent context by calling
XFastContextHandler::createFastChildContext for known
elements or XFastContextHandler::createUnknownChildContext
for unknown elements.
The parent context for the root element is the XFastDocumentHandler
itself.
If the parent context returns an empty reference, no further events for
the element and all of its childs are created.
If a valid context is returned this context gets a start event by a call to
XFastContextHandler::startFastElement for known elements or
XFastContextHandler::startUnknownElement for unknown elements.
After processing all its child elements the context gets an end event by a call to
XFastContextHandler::endFastElement for known elements or
XFastContextHandler::endUnknownElement for unknown elements.
It is valid to return one instance of XFastContextHandler more
than once. It is even possible to only use the XFastDocumentHandler
by always returning a reference to itself for each create child context event.
After the last element is processed the parser generates an end document
event at the XFastDocumentHandler by calling
XFastDocumentHandler::endDocument.
