/*

* Copyright (c) 2006 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:  

*

*/

#ifndef C_NCDLOADNODEOPERATIONPROXY_H

#define C_NCDLOADNODEOPERATIONPROXY_H

#include <e32base.h>

#include "catalogsbaseimpl.h"

#include "ncdbaseoperationproxy.h"

#include "ncdsearchoperation.h"

#include "ncdoperationimpl.h"

#include "ncdconfigurationdata.h"

class CDesC16ArrayFlat;

class CNcdNodeIdentifier;

class CNcdNodeProxy;

class CNcdNodeManagerProxy;

/**

 *  Load node operation proxy.

 *

 *  Client side implementation for load node operation.

 *

 *  @lib ?library

 *  @since S60 ?S60_version *** for example, S60 v3.0

 */

class CNcdLoadNodeOperationProxy : 

    public CNcdOperation< MNcdSearchOperation >,

    public MNcdConfigurationData

    {

public:

    /**

     * Constructor

     *

     * @param aSession is the session that is used between

     *                 the proxy and the server.

     * @param aHandle is the handle that identifies the serverside

     *                object that this proxy uses.

     * @param aRemoveHandler An observer that is called during destruction.

     * @param aNode The node this operation was started from.

     * @param aLocalizer The client localizer.

     */    

    static CNcdLoadNodeOperationProxy* NewL( MCatalogsClientServer& aSession,

                        TInt aHandle,

                        MNcdOperationProxyRemoveHandler* aRemoveHandler,

                        CNcdNodeProxy* aNode,

                        CNcdNodeManagerProxy* aNodeManager,

                        TBool aSearch,

                        MNcdClientLocalizer* aLocalizer );

    /**

     * Constructor

     *

     * @param aSession is the session that is used between

     *                 the proxy and the server.

     * @param aHandle is the handle that identifies the serverside

     *                object that this proxy uses.

     * @param aRemoveHandler An observer that is called during destruction.

     * @param aNode The node this operation was started from.

     * @param aLocalizer The client localizer.

     */

    static CNcdLoadNodeOperationProxy* NewLC( MCatalogsClientServer& aSession,

                        TInt aHandle,

                        MNcdOperationProxyRemoveHandler* aRemoveHandler,

                        CNcdNodeProxy* aNode,

                        CNcdNodeManagerProxy* aNodeManager,

                        TBool aSearch,

                        MNcdClientLocalizer* aLocalizer );

    /**

     * Adds an observer.

     */

    virtual void AddObserverL( MNcdLoadNodeOperationObserver* aObserver );

    /**

     * Removes an observer.

     */

    virtual TInt RemoveObserver( MNcdLoadNodeOperationObserver* aObserver );

public: // from MNcdConfigurationData

    /**

     * @see MNcdConfigurationData

     */

    virtual HBufC8* ProtocolResponseDataL();

public: // from MNcdOperation

    /**

     * @see MNcdOperation::OperationType

     */

    TNcdInterfaceId OperationType() const;

public: // from MNcdSearchOperation

    /**

     * @see MNcdSearchOperation::SearchRootNodeL

     */

    MNcdNodeContainer* SearchRootNodeL();

public: // from MNcdOperation

public: // from CCatalogsBase

    const TAny* QueryInterfaceL( TInt aInterfaceId ) const;

protected:

    /**

     * Constructor

     *

     */

    CNcdLoadNodeOperationProxy( TBool aSearch, MNcdClientLocalizer* aLocalizer );

    virtual ~CNcdLoadNodeOperationProxy();

    /**

     * ConstructL

     *

     * @param aSession is the session that is used between

     *                 the proxy and the server.

     * @param aHandle is the handle that identifies the serverside

     *                object that this proxy uses.

     * @param aRemoveHandler An observer that is called during destruction.

     * @param aNode The node this operation was started from.

     */         

    void ConstructL( MCatalogsClientServer& aSession,

                        TInt aHandle,

                        MNcdOperationProxyRemoveHandler* aRemoveHandler,

                        CNcdNodeProxy* aNode,

                        CNcdNodeManagerProxy* aNodeManager );

protected: // from CNcdBaseOperationProxy

    /**

     * @see CNcdBaseOperationProxy::HandleCompletedMessage

     */

    virtual void HandleCompletedMessage( 

        TNcdOperationMessageCompletionId aCompletionId,

        RReadStream& aReadStream,

        TInt aDataLength );

    /**

     * @see CNcdBaseOperationProxy::ProgressCallback

     */

    virtual void ProgressCallback();

    /**

     * @see CNcdBaseOperationProxy::QueryReceivedCallback

     */

    virtual void QueryReceivedCallback( CNcdQuery* aQuery );

    /**

     * @see CNcdBaseOperationProxy::CompleteCallback

     */

    virtual void CompleteCallback( TInt aError );

private: // data

    /**

     * Operation observers, for callbacks.

     * Observers not own.

     */    

    RPointerArray<MNcdLoadNodeOperationObserver> iObservers;

    /**

     * Recently loaded nodes's ids are temporarily stored here.

     */

    RPointerArray<CNcdNodeIdentifier> iLoadedNodes;

    CNcdNodeManagerProxy* iNodeManager;

    /**

     * Flag that indicates whether an op is a plain load or search.

     */

    TBool iSearch;

    };

#endif // C_NCDLOADNODEOPERATIONPROXY_H