1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-053FFF2B-6FB1-5065-B9D1-047477F3DE01" xml:lang="en"><title>Introduction

    13 to dictionary stores</title><shortdesc>A dictionary store is a store where all streams are accessed through

    14 a UID, rather than directly by stream ID.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <p>A dictionary store contains streams in the usual way but, in addition,

    16 the root stream is a stream dictionary. That is, the external representation

    17 of a <codeph>CStreamDictionary</codeph> object is a list of two-way associations

    18 between UIDs and stream ids.</p>

    19 <p>The following diagram illustrates the concept of the dictionary store.</p>

    20 <fig id="GUID-6EEADFD0-FFCD-513F-BC26-99B46B54D600">

    21 <title>Dictionary store</title>

    22 <image href="GUID-22699952-D032-5B69-B38A-43347A40A420_d0e361579_href.png" placement="inline"/>

    23 </fig>

    24 <p>The interface to a dictionary store is provided by the <codeph>CDictionaryStore</codeph> abstract

    25 class. The classes for concrete dictionary stores are derived from this abstract

    26 class; for example, <codeph>CDictionaryFileStore</codeph> is a concrete dictionary

    27 store class which is implemented using a file store. </p>

    28 <p>Note that a dictionary store does not derive from <codeph>CStreamStore</codeph>,

    29 but owns a persistent store, a <codeph>CPersistentStore</codeph> type, and

    30 a stream dictionary, a <codeph>CStreamDictionary</codeph> type, as part of

    31 its implementation.</p>

    32 <p><b>See also</b> </p>

    33 <p><xref href="GUID-5592E9C1-D490-538F-9B11-5EFB72DEDBE2.dita">File based dictionary

    34 store</xref> </p>

    35 <p><xref href="GUID-F535B464-3125-549B-9130-E59B64C4B865.dita">Stream dictionaries</xref> </p>

    36 <p><xref href="GUID-A928E956-9800-5277-B0D3-34BBB2707AE1.dita">Stream ID</xref> </p>

    37 <p><xref href="GUID-95DF676F-F9BA-56E0-A4DE-E68B42C06932.dita">UID manipulation</xref></p>

    38 </conbody></concept>