inc/ccontentmap.h
branchv5backport
changeset 30 f9f9f96b1873
child 54 666a2952b5b3
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/inc/ccontentmap.h	Fri Mar 26 03:06:02 2010 +0530
@@ -0,0 +1,215 @@
+/*
+* 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:  CContentMap - class used in Content Publisher
+ *
+*/
+
+#ifndef C_CONTENTMAP_H
+#define C_CONTENTMAP_H
+
+#include "cpliwmap.h"
+
+// CLASS DECLARATION
+/**
+ *  Map which contains ids and serialized data stored by 
+ * 	Content Publisher
+ *
+ *  @lib cputils.dll
+ *  @since S60 v5.0
+ */
+NONSHARABLE_CLASS( CContentMap ): public CCPLiwMap
+    {
+public:
+
+    /**
+     * Two-phased constructor.
+     */
+    IMPORT_C static CContentMap* NewL( );
+
+    /**
+     * Two-phased constructor.
+     */
+    IMPORT_C static CContentMap* NewLC( );
+
+    /**
+     * Destructor.
+     */
+    virtual ~CContentMap();
+
+        
+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 = NULL ) 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;
+
+    /**
+     * 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 RemoveL( RSqlDatabase aSqlDb ,
+            CLiwDefaultList* aNotificationList = 0 ) const;
+    
+    /**
+     * Saves results from query to SQLite Server
+     *  
+     * @param aStmt handle to SQL statement
+     * @param aList target list for enntries
+     * @param aItemsToDelete ids of entries for removal - 
+     *        they were found to be expired
+     */
+    void SaveQueryResultsL( RSqlStatement& aStmt ,
+            CLiwGenericParamList& aList,
+            RArray<TInt32>& aItemsToDelete ) 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 ) 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 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;
+
+    /**
+     * Checks expiration time
+     * @param aExpirationTime time to checking with current time
+     * @return true if aExpirationTime is correct
+     */
+    TBool IsOutdated( const TTime aExpirationTime ) const;
+
+    /**
+     * Check if data map is set
+     *
+     * @return ETrue if ContentType was set, EFalse if not
+     */
+    void IsDataMapL() const;
+    
+    /**
+     * Gets expiration time from own data
+     * @param aResult expiration date
+     * @return ETrue if expiration date is find, EFalse if not 
+     */
+    TBool GetExpirationDateL( TTime& aResult ) 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;
+	
+	                                              
+private:
+
+    /**
+     * C++ default constructor.
+     */    
+    CContentMap();
+
+    /**
+     * Perform the second phase construction of a CContentMap object.
+     */        
+    void ConstructL();
+    
+    };
+
+#endif // C_CONTENTMAP_H