om.SaxDocumentHandler.createForName

Creates a new SAX document handler object for the given .4gl module.

Syntax

om.SaxDocumentHandler.createForName(
   module STRING )
  RETURNING result om.SaxDocumentHandler

module is the name of the .4gl module defining the document handler events.

Usage

The om.SaxDocumentHandler.createForName() method creates a om.SaxDocumentHandler instance and binds the .4gl module passed as argument to the object.

To hold the reference to a SAX document handler object, define a variable with the type om.SaxDocumentHandler type.

The .4gl module must be available as a compiled 42m file, loadable according to environment settings (FGLLDPATH).

The .4gl module must implement the following functions to process the SAX filter events:

Table 1. Functions of the SAX document handler module
Function	Description
startDocument()	Called once at the beginning of the document processing.
endDocument()	Called once at the end of the document processing.
startElement( `tagname` STRING, `attrs` om.SaxAttributes ) `tagname` is the tag name of element. `attrs` is list of attributes.	Called when an XML element is reached. Use the `om.SaxAttributes` methods to handle the attributes of the processed element.
endElement( `tagname` STRING ) `tagname` is the tag name of element.	Called when the end of an XML element is reached.
processingInstruction( `piname` STRING, `data` STRING ) `piname` is the name of the processing instruction. `data` is the content of the processing instruction.	Called when a processing instruction is reached.
characters( `data` STRING ) `data` is the text data.	Called when a text node is reached.
skippedEntity( `name` STRING ) `name` is the name of the unknown entity.	Called when an unknown entity node is reached (like &xxx; for example).

Example

DEFINE f om.SaxDocumentHandler
LET f = om.SaxDocumentHandler.createForName("mysaxmod")