/*

* Copyright (c) 2009 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:   ?Description

*

*/

#ifndef IA_UPDATE_INTER_DEP_XML_PARSER_H

#define IA_UPDATE_INTER_DEP_XML_PARSER_H

#include <e32cmn.h>

#include "iaupdatexmlsubparser.h"

class CIAUpdateNodeDependency;

/**

 * CIAUpdateInterDepXmlParser handles the node dependency elements and

 * inserts information into the node dependency object. Also, inserts the dependency

 * object to the given node dependency array.

 *

 * @since S60 v3.2

 */

class CIAUpdateInterDepXmlParser : public CIAUpdateXmlSubParser

    {

public:

    /**

     * @param aDependencies Array where node dependencies that are

     * created according to the XML data are appended.

     * @return CIAUpdateInterDepXmlParser* Created object.

     *

     * @since S60 v3.2

     */

    static CIAUpdateInterDepXmlParser* NewL( 

                      RPointerArray< CIAUpdateNodeDependency >& aDependencies );

    /**

     * @see CIAUpdateInterDepXmlParser::NewL

     *

     * @since S60 v3.2

     */

    static CIAUpdateInterDepXmlParser* NewLC( 

                      RPointerArray< CIAUpdateNodeDependency >& aDependencies );

    /**

     * Destructor

     *

     * @since S60 v3.2

     */

    virtual ~CIAUpdateInterDepXmlParser();

public: // CIAUpdateXmlSubParser 

    /**

     * @see CIAUpdateXmlSubParser::OnStartElementL

     *

     * @since S60 v3.2

     */    

    virtual void OnStartElementL( const Xml::RTagInfo& aElement, 

                                  const Xml::RAttributeArray& aAttributes, 

                                  TInt aErrorCode );

    /**

     * @see CIAUpdateXmlSubParser::OnEndElementL

     *

     * @since S60 v3.2

     */    

    virtual void OnEndElementL( const Xml::RTagInfo& aElement, 

                                TInt aErrorCode );

protected:

    /**

     * Constructor

     *

     * @see CIAUpdateInterDepXmlParser::NewL

     *

     *

     * @since S60 v3.2

     */

    CIAUpdateInterDepXmlParser( RPointerArray< CIAUpdateNodeDependency >& aDependencies );

    /**

     * 2nd. phase constructor.

     * Adds the node dependency sub parsers to the parent class sub parser list. 

     *

     * @since S60 v3.2

     */

    virtual void ConstructL();

private:

    // Prevent these if not implemented

    CIAUpdateInterDepXmlParser( const CIAUpdateInterDepXmlParser& aObject );

    CIAUpdateInterDepXmlParser& operator =( const CIAUpdateInterDepXmlParser& aObject );

private: // data

    // Current dependency object. That will be inserted into the dependencies array

    // when parsing is done for the object.

    CIAUpdateNodeDependency* iDependency; 

    // Reference to the dependency array where parsed dependencies will be inserted.

    RPointerArray< CIAUpdateNodeDependency >& iDependencies;

    };

#endif // IA_UPDATE_INTER_DEP_XML_PARSER_H