public abstract class RebindIteration
extends java.lang.Object

Multi-phase deserialization:

• 1. load the manifest files and populate the summaries (ID+type) in BrooklynMementoManifest
• 2. instantiate and reconstruct catalog items
• 3. instantiate entities+locations -- so that inter-entity references can subsequently be set during deserialize (and entity config/state is set).
• 4. deserialize the manifests to instantiate the mementos
• 5. instantiate policies+enrichers+feeds (could probably merge this with (3), depending how they are implemented)
• 6. reconstruct the locations, policies, etc, then finally entities -- setting all fields and then calling RebindSupport.reconstruct(RebindContext, Memento)
• 7. associate policies+enrichers+feeds to all the entities
• 8. manage the entities

If underlying data-store is changed between first and second manifest read (e.g. to add an entity), then second phase might try to reconstitute an entity that has not been put in the rebindContext. This should not affect normal production usage, because rebind is run against a data-store that is not being written to by other brooklyn instance(s). But clearly it would be desirable to have better locking possible against the backing store.

When rebinding to code in OSGi bundles, thecatalog item id context is inferred as follows: most of the time the creator will be passing "my catalog item id" (or API could also take "BrooklynObject me" as a creation context and the receiver query the creator's catalog item id) look at the context entity of Tasks.current() (if set) propagate the catalog item id when doing setEntity, addChild when none of the above work (or they are wrong) let the user specify the catalog item

Precedence of setting the catalog item ID: 1. User-supplied catalog item ID. 2. Creating from a catalog item - all items resolved during the creation of a spec from a catalog item receive the catalog item's ID as context. 3. When using the Java API for creating specs get the catalog item ID from the context entity of the Tasks.current() task. 4. Propagate the context catalog item ID to children, adjuncts if they don't have one already.