1 /*

     2 * Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Contact list properties update handler

    15 *

    16 */

    17 

    18 #ifndef __CPENGCONTACTLISTMNGTRANSPROPERTIES_H__

    19 #define __CPENGCONTACTLISTMNGTRANSPROPERTIES_H__

    20 

    21 //  INCLUDES

    22 #include "MPEngOutgoingTransactionHandler.h"

    23 #include "PEngWVCspVersion.h"

    24 #include <e32base.h>

    25 

    26 

    27 // FORWARD DECLARATIONS

    28 class CPEngContactListModBase;

    29 class CPEngTransactionStatus;

    30 class MPEngContactListSettingsManager;

    31 class MPEngContactListTransactionManager;

    32 

    33 

    34 // CLASS DECLARATION

    35 /**

    36  * Handler to update the contact list properties

    37  *

    38  * @lib PEngListLib2

    39  * @since 3.0

    40  */

    41 NONSHARABLE_CLASS( CPEngContactListMngTransProperties ) :

    42         public CBase,

    43         public MPEngOutgoingTransactionHandler

    44     {

    45 public:

    46 

    47     /**

    48      * Two-phased constructor.

    49      */

    50     static CPEngContactListMngTransProperties* NewLC(

    51         CPEngContactListModBase& aContactList,

    52         MPEngContactListTransactionManager& aManager,

    53         TPEngWVCspVersion& aCSPVersion,

    54         TInt aOperationId );

    55 

    56     /**

    57      * Destructor.

    58      */

    59     virtual ~CPEngContactListMngTransProperties();

    60 

    61 

    62 public: // From MPEngOutgoingTransactionHandler

    63 

    64     /**

    65      * Synchronous method, get Outgoing transaction request

    66      * @see <MPEngOutgoingTransactionHandler.h>

    67      */

    68     void RequestL( TDes8& aSendBuffer );

    69 

    70 

    71     /**

    72      * Signals to the transaction handler thst it is last

    73      * @see <MPEngOutgoingTransactionHandler.h>

    74      */

    75     void LastRunningTransactionHandler();

    76 

    77 

    78     /**

    79      * Process the response to the request.

    80      * @see <MPEngOutgoingTransactionHandler.h>

    81      */

    82     void ProcessResponseL( const TDesC8& aResponse,

    83                            TRequestStatus& aStatus );

    84 

    85     /**

    86      * Cancels asynchronous processing of the request

    87      * @see <MPEngOutgoingTransactionHandler.h>

    88      */

    89     void CancelProcessing();

    90 

    91 

    92     /**

    93      * Support for simultaneous transaction handling

    94      * @see <MPEngOutgoingTransactionHandler.h>

    95      */

    96     void NewTransactionHandlersL(

    97         RPointerArray<MPEngOutgoingTransactionHandler>& aHandlers );

    98 

    99 

   100     /**

   101      * Function to signal completing of the transaction

   102      * @see <MPEngOutgoingTransactionHandler.h>

   103      */

   104     TBool TransactionCompleted();

   105 

   106 

   107     /**

   108      * Gets transaction status result class

   109      * @see <MPEngOutgoingTransactionHandler.h>

   110      */

   111     CPEngTransactionStatus* TransactionResult();

   112 

   113 

   114     /**

   115      * Releases the handler

   116      * @see <MPEngOutgoingTransactionHandler.h>

   117      */

   118     void ReleaseHandler();

   119 

   120 

   121 

   122 private: // Constructors

   123 

   124     /**

   125      * C++ constructor.

   126      */

   127     CPEngContactListMngTransProperties(

   128         CPEngContactListModBase& aContactList,

   129         MPEngContactListTransactionManager& aManager,

   130         TPEngWVCspVersion& aCSPVersion,

   131         TInt aOperationId );

   132 

   133 

   134     /**

   135      * Symbian constructor.

   136      */

   137     void ConstructL();

   138 

   139 

   140 private:    // Data

   141 

   142     /// OWN: Contact List model

   143     CPEngContactListModBase&                iContactList;

   144 

   145     /// REF: Contact List Transaction manager

   146     MPEngContactListTransactionManager&     iManager;

   147 

   148     /// OWN: Transaction status class

   149     CPEngTransactionStatus*                 iTransactionStatus;

   150 

   151     /// OWN: Transaction state

   152     TBool                                   iTransactionCompleted;

   153 

   154     /// OWN: CSP version

   155     TPEngWVCspVersion&                      iCSPVersion;

   156 

   157     /// OWN: Operation Id

   158     TInt                                    iOperationId;

   159     };

   160 

   161 #endif      //  __CPENGCONTACTLISTMNGTRANSPROPERTIES_H__

   162 

   163 

   164 //  End of File

   165