/*

* 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:  Subsession for Messenger.

*

*/

#ifndef CPHSRVSUBSESSIONMESSENGER_H

#define CPHSRVSUBSESSIONMESSENGER_H

// INCLUDES

#include "CPhSrvSubSessionBase.h"

#include <CPhCltMessenger.h>

// FORWARD DECLARATIONS

class MPhSrvMessengerNegotiator;

// CLASS DECLARATION

/**

*  Messenger Subsession.

*

*  @since 2.6

*/

class CPhSrvSubSessionMessenger

:   public CPhSrvSubSessionBase

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        * 

        * @param aSession The pre-opened Phone Server session.

        * @return CPhSrvSubSessionMessenger subsession.

        */

        static CPhSrvSubSessionBase* NewL(

            CPhSrvSession& aSession );

        /**

        * Destructor.

        *

        */

        ~CPhSrvSubSessionMessenger();

    private: // Functions from base classes   

        /**

        * @see MPhSrvMessageDecoder

        */

        TBool PhSrvMessageDecoderCanProcessMessage( TInt aFunction );

        /**

        * @see MPhSrvMessageProcessor

        */

        void PhSrvMessageProcessorHandleMessageL( const RMessage2& aMessage );

    private: // SubSession function handlers

        /**

        * Handle the close command.

        * 

        * @param aMessage The received message.

        */

        void CmdSubSessionClose( const RMessage2& aMessage );

        /**

        * Handle the construct command.

        */

        void CmdSubSessionMessengerConstructL( const RMessage2& aMessage );

        /**

        * Handle the receive command.

        */

        void CmdSubSessionMessengerReceive( const RMessage2& aMessage );

        /**

        * Handle the send command.

        * 

        * @param aMessage The received message.

        */

        void CmdSubSessionMessengerSend( const RMessage2& aMessage );

        /**

        * Handle the skip command.

        * 

        * @param aMessage The received message.

        */

        void CmdSubSessionMessengerSkip( const RMessage2& aMessage );

        /**

        * Handle the cancel command.

        * 

        * @param aMessage The received message.

        */

        void CmdSubSessionMessengerCancel( const RMessage2& aMessage );

    private: // Helper functions.

        /**

        * Returns the Messenger negotiator.

        * 

        * @return Messenger negotiator.

        */

        MPhSrvMessengerNegotiator& GetMessengerNegotiator();

        /**

        * Forwards the request to messenger negotiator.

        * 

        * @param aSubSession Subsession for messenger.

        * @param aParameters The request parameters.

        * @param aMessage The received message.

        */

        void ForwardRequest(

            CPhSrvSubSessionBase& aSubSession,

            const TPhCltMessengerParameters& aParameters,

            const RMessage2& aMessage );

        /**

        * Cleans the negotiator side.

        */

        void Clean();

    private: 

        /**

        * Constructor.

        *

        * @param aSession The session where this subsession belongs.

        */

        CPhSrvSubSessionMessenger( CPhSrvSession& aSession );

    };

#endif // CPHSRVSUBSESSIONMESSENGER_H

// End of File