The following sections document how to handle parse and DOM exceptions.

Mapping exceptions are described using instances of the AbtXmlMappingError class. By default, mapping exceptions are NOT signalled. To enable signalling of mapping exceptions, execute the following code:

Enabling mapping exceptions is especially useful during initial construction of the mapping specification because it allows mapping errors to be more easily detected and debugged. An SgmlException will be signalled and will contain the AbtXmlMappingError that describes the problem. In order to simplify debugging, the domElement and mapping are saved with the AbtXmlMappingError instance.

If the XML parser detects errors while parsing an XML stream, the errors are reported by signaling exceptions. The exception class SgmlException is used to report errors. Exceptions will cause termination of the parse process unless they are handled by the application.

The following example shows an XML parser exception handler that writes error information to the Transcript. After an error is handled, the parser attempts to continue parsing.

Exceptions that occur while manipulating the DOM are reported using the exception class AbtDOMException.