Operation return value
Note:
When writing the output values to the output cursor, be sure to include any
generated keys or other side effects.
Error handling
Error handling behavior includes any and all exceptions thrown by create and
delete operations plus the following:
RecordNotFoundException
is thrown if the EIS does not contain an entity with the
same key values as the business object to be updated.
EISSystemException
is thrown if the EIS reports any unrecoverable errors.
MissingDataException
is thrown during adapter operations to indicate that not all
the necessary information has been provided as required.
InvalidRequestException
is thrown during adapter operations during adapter
operations to indicate poorly formatted data was provided.
After-image Delete operation:
The after-image Delete operation removes an existing entity and any contained
child entities from the EIS.
Processing overview
The after-image Delete operation is processed as follows:
1.
Perform a recursive retrieve on the input business object to obtain all data in
the EIS that is associated with the top-level business object.
2.
Perform a recursive delete on the entities represented by the input business
object, starting from the lowest-level entities and ascending to the top-level
entity; non-contained entities should be left intact although any relationships to
deleted objects should be removed if explicitly defined in the EIS.
Note:
Adapters should also delete any and all contained children whether or not
they are reflected in the input business object. For example, if just a top-level
business object is provided with keys and no children, the adapter should still
check for contained children in the EIS and delete them.
Operation return value
Since the deletion of an entity in the EIS only requires a return that indicates the
success (or failure) of the operation, the goal is to convey this with as little
overhead as possible. The Delete operation might or might not return anything.
The adapter should handle the case where the output record is initialized with the
same metadata as the input cursor. In this case, it is not necessary to populate the
output data on
getNext
, apart from the key information.
Error handling
The
RecordNotFoundException
exception is thrown if the EIS does not contain an
entity with the same key values as the business object to be deleted.
76
WebSphere Adapters: WebSphere Adapter Toolkit User Guide
Summary of Contents for WebSphere Adapters
Page 2: ......
Page 6: ...iv WebSphere Adapters WebSphere Adapter Toolkit User Guide...
Page 220: ...214 WebSphere Adapters WebSphere Adapter Toolkit User Guide...
Page 224: ...218 WebSphere Adapters WebSphere Adapter Toolkit User Guide...
Page 225: ......
Page 226: ...Printed in USA...
