com.amazon.carbonado.layout (Carbonado 1.2.3 API)

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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