/*
* Copyright (c) 2008-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:  Provides base class for telephonyservice API implementation classes.
*
*/

#ifndef CTELSRVBASE_H
#define CTELSRVBASE_H

// INCLUDES
#include <e32std.h>
#include <e32base.h>

#include "cmediatorservice.h"

// CLASS DECLARATION

/**
 *  CTelSrvBase
 * 
 */
NONSHARABLE_CLASS( CTelSrvBase ) : public CBase,
                                   public MMediatorServiceObserver 
    {
public:
    // Constructors and destructor

    /**
     * Destructor.
     */
    ~CTelSrvBase();    
    
// from base class MMediatorServiceObserver
        
    /**
     * From MMediatorEventObserver.     
     * Template method for handling a response to a Mediator Service command.
     *
     * @since S60 v5.1
     * @param aData      The parameters of the response.
     */
    void CommandResponseL( const TDesC8& aData );      
          
    /**
     * From MMediatorEventObserver.
     * Template method for handling a Mediator Service event.     
     *
     * @since S60 v5.1     
     * @param aData      The parameters of the event.
     * @return None.
     */
    virtual void MediatorEventL( const TDesC8& aData );
    
protected:
    
    /**
     * Constructor for performing 1st stage construction
     */
    CTelSrvBase();
    
    /**
     * EPOC default constructor for performing 2nd stage construction
     */    
    void BaseConstructL( CMediatorService* aMediatorService );
    
    /**
     * Get the current info through Mediator. 
     * Takes care about the situation that Mediator command must be re-send.
     *
     * @since S60 v5.1      
     */
    void Initialize();  
    
    /**
     * Abstract method to be implemented by concrete subclass. 
     * 
     *
     * @since S60 v5.1      
     */
    virtual void DoHandleCommandResponseL( const TDesC8& aData ) = 0;
    
    /**
     * Abstract method to be implemented by concrete subclass. 
     * 
     *
     * @since S60 v5.1      
     */
    virtual void DoHandleMediatorEventL( const TDesC8& aData ) = 0;
    
    /**
     * Starts re-sending mediator command.
     *
     * @since S60 v5.1       
     */
    static TInt DoReSendCommand(TAny* aPtr);
    
    /**
     * Subscribe to Mediator Event.
     *
     * @since S60 v5.1       
     */
    virtual void SubscribeMediatorEventL(); 

protected: //data
    
    // Ownded: Mediator service proxy, must be created by by concrete sublass. 
    CMediatorService* iMediatorService;
    
private: //data    
    /**
     * To synchronize construction.
     * Own.
     */
    CActiveSchedulerWait* iWaitForCommandResponse;    
     
    /**
     * idle object handling of re-sending mediator command.
     * Own.
     */
    CIdle*            iCommandBuffer; 

    };

#endif // CTELSRVBASE_H