rebuild

rebuild() updating, abstract;

The rebuild method of the Collection class restores the structural integrity of a collection, removes invalid object references, and fixes up dictionary keys in the receiving collection.

The rebuild method records information in the jommsg.log file about entries that have been corrected and if the collection size changes as a result of the rebuild action.

This method iterates the collection and performs the following actions.

• Sets, arrays, and external key dictionaries

  • Restores structural integrity of the collection.

  • Removes references to non‑existent objects or references that are not type‑compatible with the membership of the collection.

• Member key dictionaries and dynamic dictionaries (DynaDictionary instances)

  • Restores structural integrity of the collection.

  • Removes references to non‑existent objects or references that are not type‑compatible with the membership, and checks that dictionary keys match the member keys. When they do not, the entry is removed and reinserted with the correct keys.

• Arrays of primitive types

  • Restores structural integrity of the collection.

The rebuild method must be enclosed in a transaction to repair persistent collections.