/*

* 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 IAUPDATECONTROLLEROBSERVER_H

#define IAUPDATECONTROLLEROBSERVER_H

#include <e32cmn.h>

class MIAUpdateAnyNode;

/**

 *

 */

class MIAUpdateControllerObserver

    {

public:

    /**

     * Notifies observer that controller startup is completed.

     *

     * @param aError IAUpdateErrorCodes::KErrCacheCleared if the

     * database cache was cleared. In this case, the refresh is 

     * recommended to update the database. In other cases, 

     * system wide error code. 

     **/

    virtual void StartupComplete( TInt aError ) = 0;

    /**

     * Notifies observer that nodes have been loaded from the server

     * or from the local storage.

     *

     * @note aNodes does not contain nodes that are set hidden.

     * UI side should not normally use hidden nodes. But, in case

     * of dependencies, hidden nodes may be asked for special purposes.

     *

     * @param aNodes Nodes resulting from operation.

     * @param aError Error value

     **/

    virtual void RefreshComplete( 

        const RPointerArray< MIAUpdateAnyNode >& aNodes,

        TInt aError ) = 0;

    /**

     * Notifies observer that the self updater has completed its task. 

     * In normal case the application will be closed before self update completes.

     * If this function is called, then most likely something has gone wrong in the

     * self update.

     *

     * @param aErrorCode Error code of the self update operation.

     */

    virtual void SelfUpdaterComplete( TInt aErrorCode ) = 0;

    /**

     * Called when a server report has been sent.

     *

     * 

     * @param aError Error code for operation completion.

     *               KErrNone for successful completion, otherwise a system

     *               wide error code.

     *

     * @see MIAUpdateController::FinishedUpdatesL

     */

    virtual void ServerReportSent( TInt aError ) = 0;

    /**

     * Called when setup configuration is read

     *

     * 

     * @param aClientRole

     */

    virtual void ClientRole( const TDesC& aClientRole ) = 0;

protected:

    virtual ~MIAUpdateControllerObserver()

        {

        }

    };

#endif  //  IAUPDATECONTROLLEROBSERVER_H