/*

* Copyright (c) 2005 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:  Implementation of the CImConnection interface (imconnection.h)

*

*/

#ifndef IMCONNECTIONIMPL_H

#define IMCONNECTIONIMPL_H

//  INCLUDES

#include <e32base.h>

#include <imconnection.h>

#include <ImpsAccessCli.h>

// FORWARD DECLARATIONS

class CContactDBReader;

// CLASS DECLARATION

/**

*  Implementation of the MImConnection interface

*

*  @lib imclient.lib

*  @since 3.0

*/

class CImConnectionImpl : public CImConnection,

            public MImpsAccessHandler2,

            public MImpsErrorHandler2,

            public MImpsStatusHandler2

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        static CImConnectionImpl* NewL( TDesC& aApplicationId );

        /**

        * Destructor.

        */

        virtual ~CImConnectionImpl();

    public: // New functions

        /**

        * Return the IMPS engine

        * @since 3.0

        * @return the IMPS engine

        */

        RImpsEng& ImpsEngine();

        /**

        * Return the Contact DB reader

        * @since 3.0

        * @return the reader

        */

        CContactDBReader& ContactDBReader();

        /**

        * Returns the Application ID with which the client connected

        * @since 3.0

        * @return ClientId

        */

        const TDesC& ApplicationId();

        /**

        * Converts the error code returned by the IMPS engine to API error code.

        * @since 3.0

        * @param aErroCode ImpsEngine error code

        * @return API error code

        */

        TInt ConvertImpsEngineErrorCode( TInt aErrorCode );

    public: // Functions from base classes

        /**

        * From MImConnection

        */

        MImClient* CreateImClientL();

        /**

        * From MImConnection

        */

        void RegisterObserverL(

            MImConnectionObserver* aObserver );

        /**

        * From MImConnection

        */

        void UnregisterObserver();

        /**

        * From MImConnection

        */

        TImConnectionStatus ImConnectionStatus();

        /**

        * From MImConnection

        */

        void LoginL(

            const TDesC&  aServer,

            const TDesC&  aUserID,

            const TDesC&  aPassword,

            const TUint32 aAP );

        /**

        * From MImConnection

        */

        void CancelLoginL( );

        /**

        * From MImConnection

        */

        void LogoutL( );

    public: // from MImpsAccessHandler2

        void HandleLoginL(

            TInt aId,

            TImpsCspIdentifier& aCspId );

        void HandleLoginCancelL(

            TInt aCancelledOpId,

            TImpsCspIdentifier& aCspId );

        void HandleLogoutL(

            TInt aId,

            TImpsCspIdentifier& aCspId );

        void HandleNbrSessionsL(

            TInt aId,

            TInt aNbr,

            TImpsCspIdentifier& aCspId

        );

        void HandleErrorL(

            TInt                 aStatus,

            TInt                 aOpId,

            const TDesC*         aDescription,

            const CImpsDetailed* aDetailedRes,

            TImpsCspIdentifier&  aCspId );

    public: // from MImpsStatusHandler

        void HandleStatusChangeL(

            TImpsServiceStatus aStatus,

            TImpsCspIdentifier& aCspId );

    private:

        enum TConnectionState

            {

            EImNotLogged = 0,

            EImLoggingIn,

            EImCancelingLogin,

            EImLoggingOut,

            EImLoggedIn

            };

        /**

        * C++ default constructor.

        */

        CImConnectionImpl();

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL( TDesC& aApplicationId );

        /**

        * Changes the current state

        */

        void SetState( TConnectionState aNewState );

    private:    // Data

        RImpsEng                iEngine; // IMP engine

        RImpsAccessClient2      iAccessClient; // IMPS access client

        MImConnectionObserver*  iClientObserver; // Client observer

        CContactDBReader*       iContactReader; // Contact DB reader

        HBufC*                  iApplicationId;// Application ID of the

        // 3rd party app (owned)

        TReal                   iCspVersion; // the CSP version

        TInt                    iCurrentOpId;

        TConnectionState        iState;

    };

#endif      // IMCONNECTIONIMPL_H   

// End of File