/*

* Copyright (c) 2004 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: this class is an operation handler for fetching attributes from network.

*

*/

#ifndef CPENGATTRIBUTEFETCHOP_H

#define CPENGATTRIBUTEFETCHOP_H

//  INCLUDES

#include "CPEngAsyncOperation.h"

#include <E32Base.h>

#include <BaMDesCa.h>

// FORWARD DECLARATIONS

class MPEngAttributeTransactionObserver2;

class CPEngAttributeTransaction2;

class MPEngPresenceAttrManager;

class MPEngPresenceAttrModel2;

/**

 * Operation handler for fetching attributes from network.

 *

 * @lib

 * @since 3.0

 */

NONSHARABLE_CLASS( CPEngAttributeFetchOp ) : public CPEngAsyncOperation

    {

public:  // Constructors and destructor

    /**

     * Two-phased constructor.

     */

    static CPEngAttributeFetchOp* NewL( TInt aPriority,

    CPEngAttributeTransaction2& aInterface,

    CPEngNWSessionSlotStorageProxy& aUsedSlot,

    TBool aResultAsLocalObjects,

    const MDesCArray& aPresenceIDs,

    const TArray<TUint32>& aTypes,

    MPEngAttributeTransactionObserver2& aObserver,

    RPEngManagerClient& aServer );

    /**

     * Destructor.

     */

    virtual ~CPEngAttributeFetchOp();

private:

    /**

     * C++ default constructor.

     */

    CPEngAttributeFetchOp( TInt aPriority,

                           CPEngAttributeTransaction2& aInterface,

                           MPEngAttributeTransactionObserver2& aObserver,

                           RPEngManagerClient& aServer );

    /**

     * Symbian OS constructor.

     */

    void ConstructL( CPEngNWSessionSlotStorageProxy& aUsedSlot,

                     const MDesCArray& aPresenceIDs,

                     const TArray<TUint32>& aTypes,

                     TBool aResultAsLocalObjects );

public: //New services

    /**

     * Starts the fetch operation

     *

     * @since 3.0

     */

    void Fetch();

    /**

     *

     *

     * @since 3.0

     */

    TInt GetFetchedAttributes(

        RPointerArray< MPEngPresenceAttrModel2>& aModels );

private: //Template method from base

    /**

     * Notifies from operation complete.

     */

    void DoHandleOpSuccessL( MPEngAdvTransactionStatus2& aStatus,

                             TInt aTransactionOperation );

    void DoHandleOpFailure( MPEngAdvTransactionStatus2& aStatus,

                            TInt aTransactionOperation );

    TPEngAsyncOpResult DoNotifyObserver( MPEngAdvTransactionStatus2& aStatus,

                                         TInt aTransactionOperation );

private: //Data

    //REF: The implemented interface

    CPEngAttributeTransaction2&     iInterface;

    //REF: The observer

    MPEngAttributeTransactionObserver2&     iObserver;

    //OWN: Attribute manager

    MPEngPresenceAttrManager*   iAttrManager;

    //OWN: Result models

    RPointerArray<MPEngPresenceAttrModel2>  iResultModels;

    };

#endif // CPENGATTRIBUTEFETCHOP_H