Retrieve operation

This topic describes the steps the adapter takes to retrieve a hierarchical business object.

The adapter performs the retrieve operation as follows:
  1. It removes all child business objects from the top-level business object received. In other words, it makes a copy of the top-level business object without any children.
  2. It retrieves the top-level business object from the database.
    • If the retrieval returns one row, the adapter continues processing.
    • If the retrieval returns no rows, indicating that the top-level business object does not exist in the database, the adapter returns the error RecordNotFoundException.
    • If the retrieval returns more than one row, the adapter returns an error.
  3. It recursively retrieves all multiple-cardinality child business objects.
    Note: The adapter does not enforce uniqueness when populating an array of business objects. It is the database’s responsibility to ensure uniqueness. If the database returns duplicate child business objects, the adapter returns duplicate children.
  4. It recursively retrieves each of the single-cardinality children, regardless whether the child business object is contained with or without ownership.
    Note: All single-cardinality child business objects are processed based on their occurrence in the business object and before the parent business object is processed. Child object ownership and non-ownership do not determine the processing sequence, but they do determine the type of processing.

Terms of use |

Last updated: Thu Mar 23 13:24:31 2006

(c) Copyright IBM Corporation 2005.
This information center is powered by Eclipse technology (http://www.eclipse.org)