A handle to the procedure containing the SAX callbacks.

Note: To get the handle to an object-oriented ABL object containing methods as callback for SAX events use the EVENT-HANDLER-OBJECT attribute.

Data type: HANDLE

Access: Readable/Writable

Applies to: SAX-reader object handle

The default is a handle to the procedure that contains the SAX-PARSE( ) method, or the SAX-PARSE-FIRST( ) and SAX-PARSE-NEXT( ) methods.

When SAX-PARSE( ), SAX-PARSE-FIRST( ), or SAX-PARSE-NEXT( ) executes, the SAX-reader object looks for callbacks only in the procedure or object whose handle is stored in the HANDLER. HANDLER must be a valid procedure or object handle and cannot be a proxy.

Note: It is permissible for both the driver procedure (the procedure that contains the SAX-PARSE( ) method, or the SAX-PARSE-FIRST( ) and SAX-PARSE-NEXT( ) methods) and callback handler procedure or object of a SAX application to reside on a remote application server. If this occurs, callbacks are invoked local to the application server.

Callbacks can reside within a special handler procedure file that is run persistently or within the driver procedure.

Within a procedure file, to get a handle to the procedure file, use the THIS-PROCEDURE handle. The following fragment assigns HANDLER a handle to the current procedure:

hSaxReader:HANDLER = THIS-PROCEDURE.

Notes

  • Assigning a value other than ? to the HANDLER attribute will cause an update to the EVENT-HANDLER-OBJECT attribute changing it to the unknown value.
  • Assigning a value other than ? to the EVENT-HANDLER-OBJECT attribute will cause an update to the HANDLER attribute changing it to the unknown value.