ncdengine/provider/client/inc/ncdnodesupplierproxy.h
author Pat Downey <patd@symbian.org>
Wed, 01 Sep 2010 12:22:02 +0100
branchRCL_3
changeset 26 8b7f4e561641
parent 0 ba25891c3a9e
permissions -rw-r--r--
Revert incorrect RCL_3 drop: Revision: 201033 Kit: 201035

/*
* 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:   Contains CNcdNodeSupplierProxy class
*
*/


#ifndef NCDNODESUPPLIERPROXY_H
#define NCDNODESUPPLIERPROXY_H

#include "ncdnodeproxy.h"

class CNcdNodeSupplierProxy : public CNcdNodeProxy 
{
public:
    /**
     * NewLC
     *
     * @param aSession The session between the client proxy and the
     * corresponding server object.
     * @param aHandle The handle which identifies the server object
     * that this proxy uses.
     * @param aNodeManager The manager that creates the nodes and keeps
     * track of the existing nodes.
     * @param aOperationManager This manager is used to create operations
     * for the node.     
     * @param aFavoriteManager This manager is used to add or remove favorite nodes.
     */
    static CNcdNodeSupplierProxy* NewLC(
        MCatalogsClientServer& aSession,
        TInt aHandle, 
        CNcdNodeManagerProxy& aNodeManager,
        CNcdOperationManagerProxy& aOperationManager,
        CNcdFavoriteManagerProxy& aFavoriteManager );

    /**
     * Destructor
     *
     * @note Usually Release function should be used instead of
     * directly calling delete for this class object.
     *
     */    
    virtual ~CNcdNodeSupplierProxy();
    
        
public: // MNcdNode

    /**
     * @see MNcdNode::State
     */
    virtual TState State() const;
    

    /**
     * @see MNcdNode::CatalogSourceName
     */
    virtual const TDesC& CatalogSourceName() const;


    /**
     * @see MNcdNode::ParentL
     */
    virtual MNcdNodeContainer* ParentL() const;
    

    /**
     * @see MNcdNode::LoadL
     */
    virtual MNcdLoadNodeOperation* LoadL( MNcdLoadNodeOperationObserver& aObserver );


    /**
     * @see MNcdNode::OperationsL
     */
    virtual RCatalogsArray< MNcdOperation > OperationsL() const;

    
public: // MNcdLoadNodeOperationObserver

    /**
     * @see MNcdLoadNodeOperationObserver::OperationComplete     
     */
    virtual void OperationComplete( MNcdLoadNodeOperation& aOperation,
                                    TInt aError );
    
    
protected:

    /**
     * Constructor
     *
     * @param aSession The session between the client proxy and the
     * corresponding server object.
     * @param aHandle The handle which identifies the server object
     * that this proxy uses.
     * @param aNodeManager The manager that creates the nodes and keeps
     * track of the existing nodes.
     * @param aOperationManager This manager is used to create operations
     * for the node.     
     * @param aFavoriteManager This manager is used to add or remove favorite nodes.
     */
    CNcdNodeSupplierProxy(
        MCatalogsClientServer& aSession,
        TInt aHandle, 
        CNcdNodeManagerProxy& aNodeManager,
        CNcdOperationManagerProxy& aOperationManager,
        CNcdFavoriteManagerProxy& aFavoriteManager );

    
private: // data

    // This node class will be set as a interface parent for iActualNode. So,
    // this class object will contain also the reference counts of the actual node.
    // So, when total reference count reaches zero and this class object will be deleted,
    // it can also delete iActualNode, because its reference count is also zero then.    
    CNcdNodeProxy* iActualNode;
};

#endif // NCDNODESUPPLIERPROXY_H