|
||
Provides stream types suitable for use in stores (structured data storage).
The Store Streams API is based on the abstract stream types defined by the Streaming API. They are designed to be used in conjunction with the structured data storage defined by the Stores API.
The API has threee key concepts: store streams, stream dictionary, and swizzle.
The store streams extends the base stream types defined in the Streaming API, to allow streams to be used in stores.
The store streams classes are RStoreReadStream
and RStoreWriteStream
.
A stream dictionary maintains a list of two-way associations between
UIDs and stream IDs (TStreamId
). They are used in the root
streams of some stores: from them other streams in the store can be found.
The stream dictionary class is
CStreamDictionary
.
For large stores, it can be desirable to defer reading some objects from streams into memory. A swizzle is a device for handling a dual representation of an object:
if it is not in memory, by the relevant stream ID
if in memory, by a pointer
Full access is available to the object through the swizzle.
Swizzles for non-const objects are provided by the template class
TSwizzle
. Swizzles for const objects are provided by the
template class TSwizzleC
.
A store map is a table of entries where each entry consists of a
swizzle and a stream ID. It is provided by CStoreMap
.