/*

* Copyright (c) 2004 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:  Header file for the CCbsMessageFactory class.

*

*/

#ifndef     CCBSMESSAGEFACTORY_H

#define     CCBSMESSAGEFACTORY_H

//  INCLUDES

#include <e32base.h>

#include <etelmm.h>

#include "CCbsMessage.h"

//  FORWARD DECLARATIONS

class CCbsRecEtel;

//  CLASS DECLARATION 

/**

*   CCbsMessageFactory constructs CB messages based on a page

*   received through ETel.

*

*   The selection between GSM and WCDMA messages is made when

*   constructing the message.

*/

class CCbsMessageFactory : public CBase

    {

    public:     // New functions        

        /**

        *   Constructs a new CCbsMessage based on TDes8&

        *   (which is a descriptor) received from EPOC Telephony Server.

        *   

        *   @param      aRecEtel        CCbsRecEtel reference

        *   @return                     A new instance of CCbsMessageFactory

        */

        static CCbsMessageFactory* NewL( CCbsRecEtel& aRecEtel );

        /**

        *   Destructor

        */

        ~CCbsMessageFactory();

        /**

        *   Creates a new message.

        *

        *   @param  aMessagePage        Source message descriptor

        *   @param  aAttributes         Message attributes

        *   @return aMsgType            Message type (GSM/WCDMA/Livecast)

        *   @return                     Current instance of CCbsMessage

        */

        CCbsMessage* CreateMessageL( const TDes8& aMessagePage,

            const RMobileBroadcastMessaging::TMobileBroadcastAttributesV2& aAttributes,

            TCbsMessageType& aMsgType );

        /**

        *   Creates a new message.

        *        

        *   @param  aMessage            Message from which to create the new msg

        *   @return                     Current instance of CCbsMessage

        */

        CCbsMessage* CreateMessageL( const CCbsMessage& aMessage );

    private:

        /**

        *   Default constructor               

        */  

        CCbsMessageFactory( CCbsRecEtel& aRecEtel );

        /**

        *   2nd-phase constructor               

        */

        void ConstructL();

    private: // Data

        // Message attributes, mainly used with WCDMA

        RMobileBroadcastMessaging::TMobileBroadcastAttributesV2 iAttributes;

        // CCbsRecEtel instance to which CB messages are passed.

        CCbsRecEtel& iRecEtel;

    };

#endif      //  CCBSMESSAGEFACTORY_H   

// End of File