Package com.amazon.carbonado.layout

Support for recording the evolution of a storable's layout, used internally by some repositories.

See: Description

Interface Summary

Interface	Description
LayoutCapability	Capability to get layout information on any storable generation.
StoredLayout	Stored information regarding the layout of a Storable type, which is used internally by Layout.
StoredLayoutEquivalence	Maps layout generations which are equivalent.
StoredLayoutProperty	Stored property joined to a StoredLayout, which is used internally by LayoutProperty.
Unevolvable	Marker interface for storables that are not allowed to evolve.

Class Summary

Class	Description
Layout	Describes the layout of a specific generation of a storable.
LayoutFactory	Factory for obtaining references to storable layouts.
LayoutOptions	Extra options encoded with a Storable layout.
LayoutProperty	Describes how a property is defined in a specific generation of a storable.
LayoutSync	Synchronizes layout metadata between two repositories.

Package com.amazon.carbonado.layout Description

Support for recording the evolution of a storable's layout, used internally by some repositories. This allows storable's to evolve. Enough information is recorded in the layout such that an older generation can be reconstructed, allowing it to be decoded from persistent storage.

A storable generation is different than a storable version. The version increases with each update of an instance, whereas the generation increases when the storable type definition changes. The version number is stored with each instance, and the generation is stored via the classes in this package.

Whenever a property is added or removed from a storable, the storable layout is assigned a new generation value. If the storable layout reverts to a previous generation's layout, no new generation value is created. Instead, the generation value of the current storable will match the previous generation.

See Also:

LayoutFactory