Performs the verb processing for the active verb of a business object.
Syntax
public int doVerbFor(CWConnectorBusObj theBusObj);
Parameters
Return values
An integer that indicates the outcome status of the verb operation. Compare this integer value with the following outcome-status constants to determine the status:
Exceptions
Notes
The doVerbFor() method performs the action of the active verb in the theBusObj business object. This method is the primary public interface for the business object handler. However, when the connector framework invokes a business object handler, it actually executes the low-level doVerbFor() method, inherited from the BOHandlerBase class. The low-level doVerbFor() method calls this doVerbFor() (in the business-object-handler class), which the connector developer must implement. For more information, see "Populating the return-status descriptor"..
If the doVerbFor() method needs to throw one of its exceptions, it first needs to populate an exception-detail object that contains information about the exception. In particular, the method must set the status code, as Table 119 shows.
Table 119. Exception status codes for the doVerbFor() method
doVerbFor() exception | Exception status code |
---|---|
ConnectionFailureException |
APPRESPONSETIMEOUT |
VerbProcessingFailedException |
The same outcome status code that doVerbFor() returns |
To initialize an exception-detail object, follow these steps:
setMsg() | Sets a message in the exception-detail object if there is an informational, warning, or error return message. |
setStatus() |
Sets a status return code, which is an integer whose value should be the same as shown in Table 119. |
The connector framework handles copying information from the exception-detail object into the return-status descriptor that it returns to the integration broker:
For more information on how to implement this method, see Implementing the doVerbFor() method.
See also