/*
* Copyright (c) 2007-2008 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 file contains the header file of MIAUpdateAnyNode class 
*
*/



#ifndef IA_UPDATE_ANY_NODE_H
#define IA_UPDATE_ANY_NODE_H


class MIAUpdateBaseNode;


/**
 * MIAUpdateAnyNode
 * This interface provides enumerations for the node types.
 * Classes that implement this interface provide information
 * about their type. By using the type information, 
 * a MIAUpdateAnyNode object can be static casted to a more
 * specific object if necessary. This can be usefull, for example,
 * when arrays for MIAUpdateAnyNode objects are used. Also,
 * a function to get the base node is provided. So, common
 * information for all the nodes can be gotten through this
 * interface without casting the object.
 *
 * @see MIAUpdateBaseNode
 * @see MIAUpdateNormalNode
 * @see MIAUpdateFwNode
 */
class MIAUpdateAnyNode
    {

public:

    /**
     * These enumerations provide known node types that
     * can be interpreted as known more specific interfaces.
     */
    enum TNodeType
        {
        /**
         * Node type is not defined.
         * Static casting of the node should be avoided.
         */
        ENodeTypeNotDefined,
        
        /**
         * Node is normal node.
         * @see MIAUpdateNode
         */
        ENodeTypeNormal,

        /**
         * Node is firmware node.
         * @see MIAUpdateFwNode
         */        
        ENodeTypeFw
        };

    /**
     * @return TNodeType Describes the type of the node. 
     */
    virtual TNodeType NodeType() const = 0;
    
    /**
     * @return MIAUpdateBaseNode& Base interface for nodes.
     * This interface provides common details for all the different nodes.
     */
    virtual MIAUpdateBaseNode& Base() = 0;


protected:

    /**
     * Protected destructor to prevent deletion.
     */    
    virtual ~MIAUpdateAnyNode() { }

    };


#endif // IA_UPDATE_ANY_NODE_H