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.
