/*

* Copyright (c) 2003-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:   Base class for all task handlers

*

*/

// @file taskhandler.h

#ifndef __TASK_HANDLER_H__

#define __TASK_HANDLER_H__

#include "sit.h"

class MTaskHandlerManager;

/**

 * Parent class of all task handlers

 */

NONSHARABLE_CLASS(CTaskHandler) : public CActive, public MEventObserver

    {

public:

    CTaskHandler(MTaskHandlerManager* aManager, const TTaskArrivedEventData& aTaskInfo,

                 TEventType aCancelEventType, TDes8* iEventSpecPtr);

    void Start();

    void TaskDone();

    void SetDelayedTaskEnd(TBool aDelayedTaskEnd);

public: // From MEventObserver

    void EventOccured(TInt aStatus, TEventType aType, TDesC8* aData);

private: // From CActive

    void DoCancel();

    void RunL();

protected: // From CActive

    TInt RunError(TInt aError);

private:

    void OnFetchTaskInfoEvent(TInt aStatus, TDesC8* aData);

    void OnTaskRequestCancelledEvent(TInt aStatus);

protected:

    virtual void StartTaskHandling() = 0;

    virtual void ReportResult(TInt aStatus) = 0;

    void GotoState(TInt aState);

    void SetCurrState(TInt aState);

    void SetNextState(TInt aState);

    TInt CurrState();

    TInt NextState();

    virtual void ChangeStateL() = 0;

    virtual void CancelOngoingOperation() = 0;

    void ReportEvent(TEventType aEventType, TDesC8& aEventSpec, TDesC8& aEventData);

    void TaskComplete(TInt aStatus = KErrNone);

    void FatalError(TInt aStatus);

protected:

    MTaskHandlerManager* iManager;

    const TTaskArrivedEventData& iTaskInfo;

    TEventType iCancelEventType;

    TDes8* iEventSpecPtr;

    TInt iCurrState;

    TInt iNextState;

    TBool iDelayedTaskEnd;

public:

    REventMediator iEventMediator;

    };

/**

 * An interface that the manager of task handlers must implement

 */

class MTaskHandlerManager

    {

public:

    virtual void TaskHandlerComplete(CTaskHandler* aTaskHandler) = 0;

    virtual void TaskHandlerFatalError(CTaskHandler* aTaskHandler, TInt aError) = 0;

    };

#endif // __TASK_HANDLER_H__