Package com.amazon.carbonado.layout

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

See:
Description

Interface Summary

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.
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

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.

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