/*
* Copyright (c) 2003 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 the CCbsRecEtelMonitor class
*    
*                This class receives CBS message pages from the EPOC Telephony server and
*                sends them to a CCbsRecEtel instance.
*
*/



#ifndef     CCBSRECETELMONITOR_H
#define     CCBSRECETELMONITOR_H

//  INCLUDES
        /*****************************************************
		*	Series 60 Customer / ETel
		*	Series 60  ETel API
		*****************************************************/
#include <etelmm.h>

//  FORWARD DECLARATIONS
class TGsmBroadcastMessageData;
class CCbsRecEtel;
class MCbsEtelMessaging;
class CCbsMessageFactory;
class CCbsLivecastHandler;

//  CLASS DECLARATION 

/**
*   CCbsRecEtelMonitor is an active object handling the reception of 
*   CB message pages from the EPOC Telephony server.
*    
*   CCbsRecMessages are constructed from the received CBS message pages and
*   forwarded to an instance of CCbsRecEtel for decoding.
*   Constructing a whole message, in case of multipage messages, is also left 
*   to CCbsRecEtel and CCbsRecCollector.
*/
class CCbsRecEtelMonitor : public CActive
    {
    public:     // New functions

        /**
        *   Creates an instance of the class.
        *
        *   @param      aEtel               A reference to the receiver
        *   @param      aSmsMessaging       A reference to the messaging object
        *   @param      aFactory            A reference to the message factory
        *   @param      aLivecastHandler    A reference to the Livecast handler
        *   @return                         A new instance of CCbsRecEtelMonitor
        */
        static CCbsRecEtelMonitor* NewL( CCbsRecEtel& aEtel, 
            MCbsEtelMessaging& aSmsMessaging,  
            CCbsMessageFactory& aFactory,
            CCbsLivecastHandler& aLivecastHandler );

        /**
        *   Destructor.
        */
        ~CCbsRecEtelMonitor();

        /** 
        *   Requests EPOC Telephony server to forward next received CB message to 
        *   this object.
        */
        void IssueRequest();

    private:    // From CActive

        /**
        *   Becomes active when EPOC Telephony server has copied a CB message to 
        *   iCbsMessagePage. The page is then given to CCbsRecEtel for
        *   processing.
        *
        *   Finally this function reissues the ReceiveMessage request.
        */
        void RunL();

        /**
        *   Cancels an outstanding ReceiveMessage request.
        */
        void DoCancel();

    private:

        /**
        *   The constructor.
        *
        *   @param  aEtel               CCbsRecEtel object.
        *   @param  aMessaging          ETel messaging object
        *   @param  aFactory            A reference to the message factory
        *   @param  aLivecastHandler    A reference to the Livecast handler
        */
        CCbsRecEtelMonitor( CCbsRecEtel& aEtel, MCbsEtelMessaging& aMessaging,
            CCbsMessageFactory& aFactory, CCbsLivecastHandler& aLivecastHandler );

        /**
        *   Finalizes the construction.
        */
        void ConstructL();
      
    private:    // Data

        // CCbsRecEtel instance to which CB messages are passed.
        CCbsRecEtel& iEtel;
                
        // Messaging subsession.
        MCbsEtelMessaging& iSmsMessaging;       

        /**
        *   Message page is stored here when the monitor becomes active
        *   due the arrival of a CBS message.
        */        
        // Message data
        RMobileBroadcastMessaging::TBroadcastPageData iMsgData;
        
        // Attributedata of an incoming broadcast message
        RMobileBroadcastMessaging::TMobileBroadcastAttributesV2 iAttributes;

        // Attributepackage of an incoming broadcast message
        RMobileBroadcastMessaging::TMobileBroadcastAttributesV2Pckg iMsgAttributesPckg;
        
        // Message factory
        CCbsMessageFactory& iFactory;

        // LC message handler
        CCbsLivecastHandler& iLivecastHandler;

        // Is Newsticker feature supported
        TBool iNewstickerSupported;

    };

#endif      //  CCBSRECETELMONITOR_H   
            
// End of File