imservices/searchfeatureplugin/srcsearchdatamodel/searchapidataobjfactory.inl
author hgs
Wed, 03 Nov 2010 09:32:20 +0530
changeset 51 61fad867f68e
permissions -rw-r--r--
201041
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
51
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:  Inline methods for codec to pack and unpack data objects.
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
hgs
parents:
diff changeset
    19
#include <e32base.h>
hgs
parents:
diff changeset
    20
#include <ximpapidataobjbase.h>
hgs
parents:
diff changeset
    21
hgs
parents:
diff changeset
    22
#include "searchtypehelpers.h"
hgs
parents:
diff changeset
    23
#include "searchobjectfactory.h"
hgs
parents:
diff changeset
    24
hgs
parents:
diff changeset
    25
hgs
parents:
diff changeset
    26
#include "searchinfoimp.h"
hgs
parents:
diff changeset
    27
hgs
parents:
diff changeset
    28
//DATA TYPES
hgs
parents:
diff changeset
    29
hgs
parents:
diff changeset
    30
hgs
parents:
diff changeset
    31
// ============================ MEMBER FUNCTIONS =============================
hgs
parents:
diff changeset
    32
hgs
parents:
diff changeset
    33
/**
hgs
parents:
diff changeset
    34
 * Type definition for exact API data object constructor signature.
hgs
parents:
diff changeset
    35
 */
hgs
parents:
diff changeset
    36
typedef CXIMPApiDataObjBase* (*TApiDataObjConstructor)( RReadStream& );
hgs
parents:
diff changeset
    37
hgs
parents:
diff changeset
    38
hgs
parents:
diff changeset
    39
hgs
parents:
diff changeset
    40
/**
hgs
parents:
diff changeset
    41
 * Structure for mapping data object interface IDs to
hgs
parents:
diff changeset
    42
 * to corect API data object constructors.
hgs
parents:
diff changeset
    43
 */
hgs
parents:
diff changeset
    44
struct SApiDataObjConstructorMap
hgs
parents:
diff changeset
    45
    {
hgs
parents:
diff changeset
    46
    //Interface id
hgs
parents:
diff changeset
    47
    TInt32    iInterfaceId;
hgs
parents:
diff changeset
    48
hgs
parents:
diff changeset
    49
    //Function pointer to data object interface implementation
hgs
parents:
diff changeset
    50
    TApiDataObjConstructor iConstructorPtr;
hgs
parents:
diff changeset
    51
    } ;
hgs
parents:
diff changeset
    52
hgs
parents:
diff changeset
    53
hgs
parents:
diff changeset
    54
hgs
parents:
diff changeset
    55
/**
hgs
parents:
diff changeset
    56
 * Helper macro to initialise KApiDataObjConstructorTable members.
hgs
parents:
diff changeset
    57
 *
hgs
parents:
diff changeset
    58
 * Macro forces that each data object implementation class to have static
hgs
parents:
diff changeset
    59
 * NewFromStreamLC() member function to instantiate the object.
hgs
parents:
diff changeset
    60
 *
hgs
parents:
diff changeset
    61
 * See TApiDataObjConstructor type definition for exact constructor
hgs
parents:
diff changeset
    62
 * signature.
hgs
parents:
diff changeset
    63
 */
hgs
parents:
diff changeset
    64
#define CONSTRUCTOR_ENTRY( TheImplementedIf, TheClass ) \
hgs
parents:
diff changeset
    65
    { TheImplementedIf::KInterfaceId, TheClass::NewFromStreamLC } \
hgs
parents:
diff changeset
    66
hgs
parents:
diff changeset
    67
/**
hgs
parents:
diff changeset
    68
 * Constructor function mapping for data object interface implementations.
hgs
parents:
diff changeset
    69
 *
hgs
parents:
diff changeset
    70
 * When new data object types are implemented, add them here.
hgs
parents:
diff changeset
    71
 */
hgs
parents:
diff changeset
    72
hgs
parents:
diff changeset
    73
const SApiDataObjConstructorMap KApiDataObjConstructorTable[] =
hgs
parents:
diff changeset
    74
    {
hgs
parents:
diff changeset
    75
    CONSTRUCTOR_ENTRY( MSearchInfo, CSearchInfoImp  ),
hgs
parents:
diff changeset
    76
    };
hgs
parents:
diff changeset
    77
hgs
parents:
diff changeset
    78
hgs
parents:
diff changeset
    79
/**
hgs
parents:
diff changeset
    80
 * Count of constructor mappings.
hgs
parents:
diff changeset
    81
 */
hgs
parents:
diff changeset
    82
const TInt KApiDataObjConstructorCount 	= sizeof( KApiDataObjConstructorTable )
hgs
parents:
diff changeset
    83
                                       / sizeof( SApiDataObjConstructorMap );
hgs
parents:
diff changeset
    84
hgs
parents:
diff changeset
    85
hgs
parents:
diff changeset
    86
hgs
parents:
diff changeset
    87
// ============================ HELPER FUNCTIONS =============================
hgs
parents:
diff changeset
    88
hgs
parents:
diff changeset
    89
hgs
parents:
diff changeset
    90
namespace {
hgs
parents:
diff changeset
    91
hgs
parents:
diff changeset
    92
    /**
hgs
parents:
diff changeset
    93
     * Helper function to locate constructor function for
hgs
parents:
diff changeset
    94
     * data object interface ID.
hgs
parents:
diff changeset
    95
     *
hgs
parents:
diff changeset
    96
     * @param aDataObjInterfaceId The data object interface ID.
hgs
parents:
diff changeset
    97
     * @return Data object constructor function.
hgs
parents:
diff changeset
    98
     */
hgs
parents:
diff changeset
    99
    TApiDataObjConstructor ConstructorForInterface( TInt32 aDataObjInterfaceId )
hgs
parents:
diff changeset
   100
    {
hgs
parents:
diff changeset
   101
        //Locate correct constructor
hgs
parents:
diff changeset
   102
        for( TInt ix = 0; ix < KApiDataObjConstructorCount; ix++ )
hgs
parents:
diff changeset
   103
        {
hgs
parents:
diff changeset
   104
           const SApiDataObjConstructorMap map = KApiDataObjConstructorTable[ ix ];
hgs
parents:
diff changeset
   105
            if( map.iInterfaceId == aDataObjInterfaceId )
hgs
parents:
diff changeset
   106
            {
hgs
parents:
diff changeset
   107
                return map.iConstructorPtr;
hgs
parents:
diff changeset
   108
            } 
hgs
parents:
diff changeset
   109
        }
hgs
parents:
diff changeset
   110
hgs
parents:
diff changeset
   111
hgs
parents:
diff changeset
   112
        //If assertion below fails, check that data object implementation
hgs
parents:
diff changeset
   113
        //class implementing requested data object interface (aDataObjInterfaceId)
hgs
parents:
diff changeset
   114
        //is registered to KApiDataObjConstructorTable
hgs
parents:
diff changeset
   115
        __ASSERT_DEBUG( EFalse,
hgs
parents:
diff changeset
   116
                User::Panic( _L("ImObjectFactory"), KErrUnknown ) );
hgs
parents:
diff changeset
   117
hgs
parents:
diff changeset
   118
        return NULL;
hgs
parents:
diff changeset
   119
    }
hgs
parents:
diff changeset
   120
hgs
parents:
diff changeset
   121
    /**
hgs
parents:
diff changeset
   122
     * Helper function to instantiate new data object object
hgs
parents:
diff changeset
   123
     * of requested type and construct it from the stream.
hgs
parents:
diff changeset
   124
     *
hgs
parents:
diff changeset
   125
     * @param aDataObjInterfaceId
hgs
parents:
diff changeset
   126
     * @return Data object constructor function.
hgs
parents:
diff changeset
   127
     */
hgs
parents:
diff changeset
   128
    CXIMPApiDataObjBase* NewDataObjectFromStreamLC( TInt32 aDataObjInterfaceId,
hgs
parents:
diff changeset
   129
            RReadStream& aStream )
hgs
parents:
diff changeset
   130
    {
hgs
parents:
diff changeset
   131
        TApiDataObjConstructor newFromStreamLC = NULL;
hgs
parents:
diff changeset
   132
hgs
parents:
diff changeset
   133
        //Locate correct constructor for interface ID
hgs
parents:
diff changeset
   134
        newFromStreamLC = ConstructorForInterface( aDataObjInterfaceId );
hgs
parents:
diff changeset
   135
hgs
parents:
diff changeset
   136
        //Instantiate the object
hgs
parents:
diff changeset
   137
        CXIMPApiDataObjBase* dataObject = newFromStreamLC( aStream );
hgs
parents:
diff changeset
   138
hgs
parents:
diff changeset
   139
        return dataObject;
hgs
parents:
diff changeset
   140
    }
hgs
parents:
diff changeset
   141
hgs
parents:
diff changeset
   142
} // namespace
hgs
parents:
diff changeset
   143
hgs
parents:
diff changeset
   144
// ---------------------------------------------------------------------------
hgs
parents:
diff changeset
   145
// SearchApiDataObjFactory::InternalizeL
hgs
parents:
diff changeset
   146
// ---------------------------------------------------------------------------
hgs
parents:
diff changeset
   147
//
hgs
parents:
diff changeset
   148
template< class INFOIMP >
hgs
parents:
diff changeset
   149
inline void CSearchApiDataObjFactory::InternalizeL( 
hgs
parents:
diff changeset
   150
        RReadStream& aStream,
hgs
parents:
diff changeset
   151
        RPointerArray<INFOIMP>& aArray )
hgs
parents:
diff changeset
   152
    {
hgs
parents:
diff changeset
   153
    TInt32 arrLen = aStream.ReadInt32L();
hgs
parents:
diff changeset
   154
hgs
parents:
diff changeset
   155
    for ( TInt i = 0; i < arrLen; i++ )
hgs
parents:
diff changeset
   156
        {
hgs
parents:
diff changeset
   157
        TInt paramType = aStream.ReadInt32L();
hgs
parents:
diff changeset
   158
        INFOIMP* infoObj = ( INFOIMP* ) NewDataObjectFromStreamLC( paramType, aStream );
hgs
parents:
diff changeset
   159
        aArray.AppendL( infoObj );
hgs
parents:
diff changeset
   160
        CleanupStack::Pop( infoObj );
hgs
parents:
diff changeset
   161
        }
hgs
parents:
diff changeset
   162
    }
hgs
parents:
diff changeset
   163
hgs
parents:
diff changeset
   164
// ---------------------------------------------------------------------------
hgs
parents:
diff changeset
   165
// SearchApiDataObjFactory::ExternalizeL
hgs
parents:
diff changeset
   166
// ---------------------------------------------------------------------------
hgs
parents:
diff changeset
   167
//
hgs
parents:
diff changeset
   168
template <class INFOIMP>
hgs
parents:
diff changeset
   169
inline void CSearchApiDataObjFactory::ExternalizeL( 
hgs
parents:
diff changeset
   170
        RWriteStream& aWs,
hgs
parents:
diff changeset
   171
        const RPointerArray<INFOIMP>& aArray )
hgs
parents:
diff changeset
   172
    {
hgs
parents:
diff changeset
   173
    aWs.WriteInt32L( aArray.Count() ); // array length
hgs
parents:
diff changeset
   174
hgs
parents:
diff changeset
   175
    for ( TInt i = 0; i < aArray.Count(); i++ )
hgs
parents:
diff changeset
   176
        {
hgs
parents:
diff changeset
   177
        INFOIMP* infoField = aArray[ i ];
hgs
parents:
diff changeset
   178
hgs
parents:
diff changeset
   179
        // write the type
hgs
parents:
diff changeset
   180
        aWs.WriteInt32L( infoField->Base().GetInterfaceId() );
hgs
parents:
diff changeset
   181
hgs
parents:
diff changeset
   182
        // write the actual object
hgs
parents:
diff changeset
   183
        infoField->ExternalizeL( aWs );
hgs
parents:
diff changeset
   184
        }
hgs
parents:
diff changeset
   185
hgs
parents:
diff changeset
   186
    aWs.CommitL();
hgs
parents:
diff changeset
   187
    }
hgs
parents:
diff changeset
   188