inc/cpublisherregistrymap.h
author Christian Morlok <symbian.org@christianmorlok.de>
Wed, 07 Apr 2010 14:35:19 +0200
branchv5backport
changeset 54 666a2952b5b3
parent 30 f9f9f96b1873
permissions -rw-r--r--
renamed dlls+exe to prevent conflicts with existing files in emulator; changelog attached. * renamed dlls/exe: - aifw.dll to aifw_hs.dll - cputils to cputils_hs - aiidleint.dll to aiidleint_hs.dll - aiutils.dll to aiutils_hs.dll - MenuInterface.dll to MenuInterface_hs.dll - XCFW.dll to XCFW_hs.dll - homescreen.exe to homescreen_hs.exe - ailaunch.exe to ailaunch_hs.exe * new UID for Active Idle (aifw_hs.dll, aiidleint_hs.dll and homescreen.exe): #define AI_UID3_AIFW_COMMON 0xEDFF45C4 (was 0x102750F0 = 271012080) * new UID for cputils_hs.dll: 0xE3E7134E (was 0x20016B7F = 536963967) * new UID for AI Utilities Factory (aiutils_hs.dll): 0xEC55106C (was 0x10281865 = 271063141) * new UID for MenuInterface_hs.dll: 0xEEE24485 (was 0x10210EAB = 270601899) * new UID for XCFW_hs.dll: 0xEB12332F (was 0x10210EA0 = 270601888) * new UID for ailaunch_hs.exe: 0xEF5A047A (was 0x200286E3 = 537036515)

/*
* Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description:  CPublisherRegistryMap - class used in Content Publisher
 *
*/

#ifndef C_CPUBLISHERREGISTRYMAP_H
#define C_CPUBLISHERREGISTRYMAP_H

#include "cpliwmap.h"

// CLASS DECLARATION
/**
 *  Map which contains Publisher Registry information
 *
 *  @lib cputils_hs_hs.dll
 *  @since S60 v5.0
 */
NONSHARABLE_CLASS( CPublisherRegistryMap ): public CCPLiwMap
    {
public:

    /**
     * Two-phased constructor.
     */
    IMPORT_C static CPublisherRegistryMap* NewL( );

    /**
     * Two-phased constructor.
     */
    IMPORT_C static CPublisherRegistryMap* NewLC( );

    /**
     * Destructor.
     */
    virtual ~CPublisherRegistryMap();

private:

    /**
     * Adds to database current content
     *  
     * @param aSqlDb handle to database
     * @param aNotificationList list of notifications to fill in when 
     *        something was actually changed in dataabse
     *
     * @return id of added entry
     */
	TInt32 AddL( RSqlDatabase aSqlDb,
            CLiwDefaultList* aNotificationList = 0 ) const;

    /**
     * Fetches entries from database
     *  
     * @param aSqlDb handle to database
     * @param aList target list for enntries
     * @param aItemsToDelete ids of entries for removal - 
     *        they were found to be expired
     *
     * @return number of fetched entries
     */
    TUint GetListL( RSqlDatabase aSqlDb,
            CLiwGenericParamList* aList,
            RArray<TInt32>& aItemsToDelete ) const;
    /**
     * 
     */
    void RemoveL( RSqlDatabase aSqlDb,
            CLiwDefaultList* aNotificationList = 0 ) const;
    
    /**
     * Removes entries from database
     *  
     * @param aSqlDb handle to database
     * @param aNotificationList list of notifications to fill in when 
     *        something was actually changed in dataabse
     */
    void SaveQueryResultsL( RSqlStatement& aStmt ,
            CLiwGenericParamList& aList,
            RArray<TInt32>& aItemsToDelete )const;
    
    /**
     * Performs actuall add operation
     *  
     * @param aSqlDb handle to database
     * @param aNotificationList list of notifications to fill in when 
     *        something was actually changed in dataabse
     *
     * @return id of added entry
     */
    TInt32 AddToDbL( RSqlDatabase aSqlDb,
            CLiwDefaultList* aNotificationList ) const;

    /**
     * Appends filter as strings to SQL query according to aFilter
     *  
     * @param aQuery SQL query
     * @param aFilter as enum
     *
     */
    void AppendFilterL( RBuf& aQuery, TUint& aFilter ) const;

    /**
     * Appends sorting criteria as strings to SQL query according to aSort
     *
     * @param aQuery SQL query
     * @param aSort sort filter as TInt
     */
    void AppendSortL( RBuf& aQuery, const TCPSortOrder& aSort ) const;

    /**
     * Prepares SQL query for Add operation
     *
     * @param aSqlDb handle to database  
     * @param aStmt handle to SQL statement
     * @param aQuery SQL query
     *
     */
    void PrepareStmtforAddL(RSqlDatabase aSqlDb, 
	                               RSqlStatement& aStmt , 
                                   const TDesC& aQuery ) const;

    /**
     * Prepares SQL query for Update operation
     *
     * @param aSqlDb handle to database  
     * @param aStmt handle to SQL statement
     * @param aId id of entry to update
     *
     */							   
    void PrepareStmtforUpdateL( RSqlDatabase aSqlDb,
            RSqlStatement& aStmt,
            TInt32 aId ) const;
			
    /**
     * Updates entry in database
     *  
     * @param aSqlDb handle to database
     * @param aId id entry to update
     * @param aNotificationList list of notifications to fill in when 
     *        something was actually changed in dataabse
     */
    void UpdateL( RSqlDatabase aSqlDb, TInt32 aId,
            CLiwDefaultList* aNotificationList = 0 ) const;
			
    /**
     * Check if IDs are valid for Delete operation
     *
     */
    void IsValidForDeleteL() const;
    
    /**
     * Check if IDs are valid for GetList operation
     */
    void IsValidForGetListL() const ;

    /**
     *
     * @return ETrue if supported, EFalse if not
     */
    TBool ActivateActionSupport( ) const;      
    
    /**
     *
     * @return ETrue if activate flag is set, EFalse if not
     */
    TBool GetActivateInfo( ) const;
    
    /**
      * Fills change info map with proper values
      *aStmt
      * @param aStmt handle to SQL statement
      * @param aChangeInfoMap map that will be filed
      *
      */
    void FillChangeInfoMapL( RSqlStatement& aStmt, 
			CLiwDefaultMap* aMap ) const;

private:

    /**
     * C++ default constructor.
     */     
    CPublisherRegistryMap();

    /**
     * Perform the second phase construction of a CPublisherRegistryMap object.
     */      
    void ConstructL();

    };

#endif // C_CPUBLISHERREGISTRYMAP_H