BOHandlerCPP class

The BOHandlerCPP class is the base class for the business object handlers of a C++ connector. It contains the code for one business object handler. From this class, a connector developer must derive business-object-handler classes (as many as needed) and implement the abstract method, doVerbFor(), for the business object handler.

Important:
All C++ connectors must extend this virtual class. Developers must implement the single virtual method, doVerbFor(), in their derived business-object-handler class. If your connector handles request processing, your doVerbFor() method must provide verb processing for all supported verbs for the business object (or objects) it handles. If your connector does not provide request processing, it must still provide verb processing for the Retrieve verb.

An connector includes one or more business object handlers to perform tasks for the verbs in business objects. Depending on the active verb, a business object handler can insert business object data into an application, retrieve data, delete application data, or perform another task. For an introduction to request processing and business object handlers, see "Request processing". For information on how to implement a business object handler, see Request processing

The header file for this class is BOHandlerCPP.hpp. It resides in the following subdirectory of your product directory:

DevelopmentKits\cdk\generic_include
 

Table 96 summarizes the methods in the BOHandlerCPP class

Table 96.
Member methods of the BOHandlerCPP class
Member method Description Page
BOHandlerCPP() Creates a business object handler. BOHandlerCPP()
doVerbFor() Performs the action for the active verb of a business object. doVerbFor()
generateAndLogMsg() Generates a message from a set of predefined messages in a message file and logs the generated message in the connector's log destination. generateAndLogMsg()
generateAndTraceMsg() Generates a trace message from a set of predefined messages in a message file and sends the generated trace message to the connector's log destination. generateAndTraceMsg()
generateMsg() Generates a message from a set of predefined messages in a message file. generateMsg()
getConfigProp() Retrieves a connector configuration property from the repository. getConfigProp()
getTheSubHandler() Retrieves a pointer to the subscription handler. The caller can use this pointer to determine whether any subscriptions to a particular business object definition exist for the incoming business object. getTheSubHandler()
logMsg() Logs a message to the connector's log destination. Log messages must be contained in a message file that you provide for your connector. logMsg()
traceWrite() Logs a message to the connector's log destination. Log messages must be contained in a message file that you provide for your connector. traceWrite()

Copyright IBM Corp. 1997, 2003