imservices/xmppsettingsapi/inc/xmppsettingsrecord.h
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:  This class is used for data table manipulations.
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
hgs
parents:
diff changeset
    20
hgs
parents:
diff changeset
    21
#ifndef C_XMPPSETTINGSRECORD_H
hgs
parents:
diff changeset
    22
#define C_XMPPSETTINGSRECORD_H
hgs
parents:
diff changeset
    23
hgs
parents:
diff changeset
    24
#include <e32base.h>
hgs
parents:
diff changeset
    25
hgs
parents:
diff changeset
    26
class CRepository;
hgs
parents:
diff changeset
    27
hgs
parents:
diff changeset
    28
/**
hgs
parents:
diff changeset
    29
 *  This class is used for data table manipulations.
hgs
parents:
diff changeset
    30
 *
hgs
parents:
diff changeset
    31
 *  This class contains all methods needed to read and write to settings id
hgs
parents:
diff changeset
    32
 *  table.
hgs
parents:
diff changeset
    33
 *
hgs
parents:
diff changeset
    34
 *
hgs
parents:
diff changeset
    35
 *  @lib jabbersettings.lib
hgs
parents:
diff changeset
    36
 *  @since S60 5.0
hgs
parents:
diff changeset
    37
 */
hgs
parents:
diff changeset
    38
class CXmppSettingsRecord: public CBase
hgs
parents:
diff changeset
    39
    {
hgs
parents:
diff changeset
    40
hgs
parents:
diff changeset
    41
public:
hgs
parents:
diff changeset
    42
		
hgs
parents:
diff changeset
    43
		/**
hgs
parents:
diff changeset
    44
     * Two-phased constructor.         
hgs
parents:
diff changeset
    45
     * @return Instance of this class
hgs
parents:
diff changeset
    46
     */
hgs
parents:
diff changeset
    47
    static CXmppSettingsRecord* NewL( CRepository& aRepository );
hgs
parents:
diff changeset
    48
hgs
parents:
diff changeset
    49
    static CXmppSettingsRecord* NewLC( CRepository& aRepository );
hgs
parents:
diff changeset
    50
		
hgs
parents:
diff changeset
    51
		/**
hgs
parents:
diff changeset
    52
	   * Destructor
hgs
parents:
diff changeset
    53
	   */
hgs
parents:
diff changeset
    54
    virtual ~CXmppSettingsRecord();
hgs
parents:
diff changeset
    55
hgs
parents:
diff changeset
    56
    /**
hgs
parents:
diff changeset
    57
     * This method checks does this setting id exist. Leaves with
hgs
parents:
diff changeset
    58
     * KErrNotFound if it does not.
hgs
parents:
diff changeset
    59
     *
hgs
parents:
diff changeset
    60
     * @since S60 5.0
hgs
parents:
diff changeset
    61
     * @param aSettingsRecordId Setting id.
hgs
parents:
diff changeset
    62
     * @param aSettingsRecordKey If setting id is found, this contains the setting
hgs
parents:
diff changeset
    63
     *                    key on return.
hgs
parents:
diff changeset
    64
     */
hgs
parents:
diff changeset
    65
    void FindSettingsRecordKeyL( TUint32 aSettingsRecordId,
hgs
parents:
diff changeset
    66
                                 TUint32& aSettingsRecordKey );
hgs
parents:
diff changeset
    67
hgs
parents:
diff changeset
    68
    /**
hgs
parents:
diff changeset
    69
     * This method fids all setting keys.
hgs
parents:
diff changeset
    70
     *
hgs
parents:
diff changeset
    71
     * @since S60 5.0
hgs
parents:
diff changeset
    72
     * @@param aSettingsRecordKeys On return contains all setting keys.
hgs
parents:
diff changeset
    73
     */
hgs
parents:
diff changeset
    74
    void GetSettingsRecordkeysL( RArray<TUint32>& aResults );
hgs
parents:
diff changeset
    75
hgs
parents:
diff changeset
    76
    /**
hgs
parents:
diff changeset
    77
     * This method creates unique setting id.
hgs
parents:
diff changeset
    78
     *
hgs
parents:
diff changeset
    79
     * @since S60 5.0
hgs
parents:
diff changeset
    80
     * @param aNewSettingId On return contains new setting id.
hgs
parents:
diff changeset
    81
     */
hgs
parents:
diff changeset
    82
    void CreateSettingsRecordIdL( TUint32& aNewSettingId );
hgs
parents:
diff changeset
    83
hgs
parents:
diff changeset
    84
private:
hgs
parents:
diff changeset
    85
hgs
parents:
diff changeset
    86
		/**
hgs
parents:
diff changeset
    87
		 * Default Contructor
hgs
parents:
diff changeset
    88
		 */
hgs
parents:
diff changeset
    89
    CXmppSettingsRecord( CRepository& aRepository );
hgs
parents:
diff changeset
    90
hgs
parents:
diff changeset
    91
    void ConstructL();
hgs
parents:
diff changeset
    92
hgs
parents:
diff changeset
    93
    /**
hgs
parents:
diff changeset
    94
     * This method returns next available slot for settings record. It can
hgs
parents:
diff changeset
    95
     * be new index or it can use deleted slot.
hgs
parents:
diff changeset
    96
     *
hgs
parents:
diff changeset
    97
     * @since S60 5.0
hgs
parents:
diff changeset
    98
     * @param aFreeKey On return contains the next free key.
hgs
parents:
diff changeset
    99
     */
hgs
parents:
diff changeset
   100
    void NextFreeSlotL( TUint32& aFreeKey );
hgs
parents:
diff changeset
   101
hgs
parents:
diff changeset
   102
    /**
hgs
parents:
diff changeset
   103
     * This method fids all setting keys. It fills the internal array with
hgs
parents:
diff changeset
   104
     * unique ids.
hgs
parents:
diff changeset
   105
     *
hgs
parents:
diff changeset
   106
     * @since S60 5.0
hgs
parents:
diff changeset
   107
     */
hgs
parents:
diff changeset
   108
    void GetSettingsRecordkeysL();
hgs
parents:
diff changeset
   109
hgs
parents:
diff changeset
   110
private: // Data
hgs
parents:
diff changeset
   111
hgs
parents:
diff changeset
   112
    /**
hgs
parents:
diff changeset
   113
     * Handle to the Central Repository.
hgs
parents:
diff changeset
   114
     */
hgs
parents:
diff changeset
   115
    CRepository& iRepository;
hgs
parents:
diff changeset
   116
hgs
parents:
diff changeset
   117
    /**
hgs
parents:
diff changeset
   118
     * Contains setting id keys.
hgs
parents:
diff changeset
   119
     */
hgs
parents:
diff changeset
   120
    RArray<TUint32> iSettingsRecordKeyArray;
hgs
parents:
diff changeset
   121
hgs
parents:
diff changeset
   122
    };
hgs
parents:
diff changeset
   123
hgs
parents:
diff changeset
   124
hgs
parents:
diff changeset
   125
#endif // C_XMPPSETTINGSRECORD_H