specifies a SAX parser that uses integer values for known XML names (elements, attributes and attribute values). More...

import"XFastParser.idl";

Inheritance diagram for XFastParser:

Public Member Functions
void	parseStream ([in] InputSource aInputSource) raises ( SAXException, com::sun::star::io::IOException )
	parses an XML document from a stream. More...

void	setFastDocumentHandler ([in] XFastDocumentHandler Handler)
	Application must register a document event handler to get sax events for the parsed stream. More...

void	setTokenHandler ([in] XFastTokenHandler Handler)
	must be registered to translate known XML names to integer tokens. More...

void	registerNamespace ([in] string NamespaceURL, [in] long NamespaceToken) raises ( com::sun::star::lang::IllegalArgumentException )
	registers a known namespace url with the given integer token. More...

void	setErrorHandler ([in] XErrorHandler Handler)
	allows an application to register an error event handler. More...

void	setEntityResolver ([in] XEntityResolver Resolver)
	allows an application to register a DTD-Handler. More...

void	setLocale ([in] com::sun::star::lang::Locale locale)
	sets a locale specified for localization of warnings and error messages. More...

string	getNamespaceURL ([in] string prefix) raises ( com::sun::star::lang::IllegalArgumentException )
	Gets the namespace url string. More...

void	setNamespaceHandler ([in] XFastNamespaceHandler Handler)

void	setCustomEntityNames ([in] sequence< beans::Pair< string, string > > replacements)
	Simulate a DTD file. More...

Public Member Functions inherited from XInterface
any	queryInterface ([in] type aType)
	queries for a new interface to an existing UNO object. More...

void	acquire ()
	increases the reference counter by one. More...

void	release ()
	decreases the reference counter by one. More...

Detailed Description

specifies a SAX parser that uses integer values for known XML names (elements, attributes and attribute values).

The parser also handles namespaces and allows to have individual contexts for each XML element.

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 children 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().

See also: http://wiki.openoffice.org/wiki/FastParser

Member Function Documentation

◆ getNamespaceURL()

string getNamespaceURL	(	[in] string	prefix	)
raises	(	com::sun::star::lang::IllegalArgumentException
	)

Gets the namespace url string.

◆ parseStream()

void parseStream	(	[in] InputSource	aInputSource	)
raises	(	SAXException,
		com::sun::star::io::IOException
	)

parses an XML document from a stream.

Set the desired handlers before calling this method.

◆ registerNamespace()

void registerNamespace	(	[in] string	NamespaceURL,
		[in] long	NamespaceToken
	)
raises	(	com::sun::star::lang::IllegalArgumentException
	)

registers a known namespace url with the given integer token.

Parameters

NamespaceURL	the namespace URL.
NamespaceToken	an integer token that must be greater than FastToken::NAMESPACE.

◆ setCustomEntityNames()

void setCustomEntityNames ( [in] sequence< beans::Pair< string, string > > replacements )

Simulate a DTD file.

Will allow to use customized entity references like ∞ .

Since: LibreOffice 7.1

◆ setEntityResolver()

void setEntityResolver ( [in] XEntityResolver Resolver )

allows an application to register a DTD-Handler.

◆ setErrorHandler()

void setErrorHandler ( [in] XErrorHandler Handler )

allows an application to register an error event handler.

Note that the error handler can throw an exception when an error or warning occurs. Note that an exception is thrown by the parser when an unrecoverable (fatal) error occurs.

◆ setFastDocumentHandler()

void setFastDocumentHandler ( [in] XFastDocumentHandler Handler )

Application must register a document event handler to get sax events for the parsed stream.

◆ setLocale()

void setLocale ( [in] com::sun::star::lang::Locale locale )

sets a locale specified for localization of warnings and error messages.

Set the language of the error messages. Useful when the parsing errors will be presented to the user.

◆ setNamespaceHandler()

void setNamespaceHandler ( [in] XFastNamespaceHandler Handler )

Since: LibreOffice 5.3

◆ setTokenHandler()

void setTokenHandler ( [in] XFastTokenHandler Handler )

must be registered to translate known XML names to integer tokens.

The documentation for this interface was generated from the following file:

com/sun/star/xml/sax/XFastParser.idl

Public Member Functions