Problem Determination - IBM WebSphere Adapters User Manual

v When WBIStructuredRecord is initialized with data that contains Bidi

Problem determination

You can implement messages to accompany a range events.
Fault handling support
Through enhancements to the Service Component Architecture (SCA) and the
Adapter Foundation Classes (AFC), the WebSphere Adapter Toolkit provides fault
handling support. Fault handling allows the developer to differentiate information
technology (IT) exceptions from business processing exceptions during outbound
processing.
A fault is an exception condition that alters the normal flow of a business process.
Typically, a fault represents a predictable error that has a well-defined action.
Presenting errors as faults instead of exceptions makes it easier for you to
configure recovery processing, because fault handling does not require you to write
Java code to catch and handle an exception. Adapters created with the WebSphere
Adapter Toolkit generate several faults.
Fault handling support adheres to the DataBinding model, in that when an
exception is thrown by an adapter, a fault selector determines that it is a fault and
the fault (data) binding converts the exception to a fault business object and
returns it to the server runtime.
Fault artifacts:
To facilitate fault handling support, WebSphere Adapter Toolkit provides artifacts
that include fault classes, fault business objects, a fault selector, and a fault binding
class.
The following table shows AFC fault classes, corresponding fault business names
and fault type names. The configured fault binding and a descriptive example of
each fault can be found in the section about configuration for fault handling.
Fault Exception in AFC
DuplicateRecordException
InvalidRequestException
MatchesExceededLimitException
MissingDataException
MultipleMatchingRecordsException MULTIPLE_MATCHING_RECORDS
RecordNotFoundException
In addition to the fault classes, the following fault selector class and base fault
binding class are provided:
v WBIFaultSelectorImpl
v WBIFaultDataBindingImpl
A utility class named FaultBOUtil can help you define simple custom fault
business objects.
168
WebSphere Adapters: WebSphere Adapter Toolkit User Guide
annotations, Cursors and accessors that are associated with that structured
record will automatically translate the content into or from the Bidi format
specified in the annotations, via special cursors and accessors that wrap the
versions provided by the data exchange factory .
Corresponding Fault Name
DUPLICATE_RECORD
INVALID_REQUEST
MATCHES_EXCEEDED_LIMIT
MISSING_DATA
RECORD_NOT_FOUND
Corresponding Fault Type Name
DuplicateRecordFault
InvalidRequestFault
MatchesExceededLimitFault
MissingDataFault
MultipleMatchingRecordsFault
RecordNotFoundFault