getBO()

Builds a business object based on the information in an event from the event store.

Syntax

public CWConnectorBusObj getBO(CWConnectorEvent eventObject);
 

Parameters

eventObject
Is the event that contains the business object information.

Return values

A CWConnectorBusObj object containing a new business object based on information retrieved from the application's database. If the method was unable to retrieve the eventObject event object, it returns null.

Exceptions

AttributeNotFoundException
Thrown if getBO() cannot find an attribute when assigning a key value to a key attribute.

SpecNameNotFoundException
Thrown if the name of the business object within the event object is invalid.

AttributeValueException
Thrown if the retrieved attribute value is not valid for a particular attribute.

InvalidVerbException
Thrown if the verb within the event object is invalid.

WrongAttributeException
Thrown if getBO() encounters an invalid attribute type when assigning a key value a key attribute. For example, if the attribute is a container, it cannot hold a key value.

AttributeNullValueException
Thrown if the business object could not be created.

Notes

The getBO() method returns a business object that contains information for an application entity that the eventObject event object describes.

Important:
The getBO() method must be overridden by any connector that does not use the RetrieveByContent verb.

The default implementation of this method performs the following actions:

Note:
The getBO() method is usually called from the poll method, pollForEvents().

See also

doVerbFor(), pollForEvents()

Copyright IBM Corp. 1997, 2003