The IBM WebSphere InterChange Server 4.2.1 release and the
IBM WebSphere Business Integration Adapter 2.3.0 release provide
the following new functionality in the Java connector library:
- The connector can now provide additional configuration to a data handler
when it calls the data handler. The following methods support a
config argument to specify this additional information:
- boToString()
- stringToBo()
For more information, see the descriptions of these methods in CWConnectorUtil class.
- The Java connector library now provides access to individual name-value
pairs in application-specific information through new forms of the
getAppText() method in the CWConnectorBusObj
class.
For more information, see the description of this method in CWConnectorBusObj class.
- In support of duplicate event elimination (which provides guaranteed event
delivery), the Java connector library provides the setDEEId()
method in the CWConnectorBusObj class to enable a connector to set
a business object's ObjectEventId attribute with the event identifier
(ID). For more information, see Guaranteed event delivery for connectors with non-JMS event stores and the description of the setDEEId() method
in CWConnectorBusObj class.
- The Java connector library now provides the ability to modularize the
instantiation of an event-store object from its event-store factory with the
following features:
- The getEventStore() method (in the CWConnectorAgent class)
instantiates an event-store object from its event-store factory. The
CWConnectorAgent class provides a default implementation of this
method. However, you can override it for custom behavior. The
default implementation of the pollForEvents() method now calls this
getEventStore() method to obtain its event-store object
- The EventStoreFactory connector configuration property can
contain the name of the event-store-factory class for your event store.
The getEventStore() method (in the CWConnectorAgent
class) obtains the name of the event-store-factory class it uses from the
EventStoreFactory property.
For more information, see CWConnectorEventStoreFactory interface.
- The Java connector library now provides the getTerminate() and setTerminate() methods (in the
CWConnectorEventStore class) to allow the
pollForEvents() method to better handle the application-timeout
(APPRESPONSETIMEOUT) condition.
- The Java connector library now provides verb constants for the Exists and
RetrieveByContent verbs. The VERB_EXISTS and
VERB_RETRIEVEBYCONTENT verb constants are defined in the
CWConnectorConstant class.
- To supplement changes to the return codes of the
gotApplEvents() method, the manual now provides more information on
how to respond to these different outcome-status values. In addition,
the pollForEvents() method has been enhanced to take these same
responses. For more information, see Sending the business object.
- The Java connector library now supports the creation of a custom business
object handler through a custom-business-object-handler class, which
implements the CWCustomBOHandler interface. If your
connector supports a business object that requires different processing for
one of its verbs, you can create a custom business object handler to handle
that verb for the business object. For more information, see Creating a custom business object handler.
