/*

* Copyright (c) 2006 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:  Access handler of the network session

*

*/

#ifndef __IMPSPLUGINACCESSHANDLER_H__

#define __IMPSPLUGINACCESSHANDLER_H__

//  INCLUDES

#include    <E32Base.h>

#include    <ImpsAccessCli.h>

#include    "PEngPresenceEngineConsts2.h"

#include    "PEngWVServices2.h"

#include    "MImpsPluginAccessHandler.h"

// FORWARD DECLARATIONS

class MPEngSessionStatusObserver;

/**

 * CImpsPluginAccessHandler

 *

 * @since 3.0

 */

NONSHARABLE_CLASS( CImpsPluginAccessHandler ) :

        public CBase,

        public MImpsPluginAccessHandler,

        public MImpsAccessHandler2,

        public MImpsErrorHandler2,

        public MImpsStatusHandler2

    {

public: /* Construction */

    /**

     * Instantiates CImpsPluginAccessHandler object.

     *

     * @return New CImpsPluginAccessHandler instance.

     */

    static CImpsPluginAccessHandler* NewL( RImpsEng& aSessClient );

    /**

     * Destructor.

     */

    ~CImpsPluginAccessHandler();

    //-----------------------------------------------------------------------

public: // from MImpsPluginAccessHandler

    /**

     *  Log in to the presence server

     *  @see <MImpsPluginAccessHandler>

     */

    void LogInL( TRequestStatus& aStatus,

                 TDesC &aPassword,

                 TDesC &aClientId,

                 TDesC &aServiceAddress,

                 TInt32 aIapId );

    /**

     *  Log out from the presence server

     *  @see <MImpsPluginAccessHandler>

     */

    void LogOutL( TRequestStatus& aStatus );

    /**

     *  Cancels active asynchronous operation

     *  @see <MImpsPluginAccessHandler>

     */

    void Cancel( TInt aReason );

    /**

     *  Register session status observer

     *  @see <MImpsPluginAccessHandler>

     */

    void RegisterSessionObserverL(

        MPEngSessionStatusObserver& aObserver );

    /**

     *  UnRegister session status observer

     *  @see <MImpsPluginAccessHandler>

     */

    void UnregisterSessionObserver(

        MPEngSessionStatusObserver& aObserver );

    /**

     *  Get session service capabilities

     *  @see <MImpsPluginAccessHandler>

     */

    TPEngWVCspServicesTree2& ServiceCapabilities();

public: // MImpsAccessHandler2

    /**

     * Observer method for Login and Open event.

     * @see <impspurecli.h>

     */

    void HandleLoginL( TInt aId,

                       TImpsCspIdentifier& aCspId );

    /**

     * Observer method for Logout event.

     * @see <impspurecli.h>

     */

    void HandleLogoutL( TInt aId,

                        TImpsCspIdentifier& aCspId );

    /**

     * Observer method for CancelLogin event.

     * @see <impspurecli.h>

     */

    void HandleLoginCancelL( TInt aCancelledOpId,

                             TImpsCspIdentifier& aCspId );

    /**

     * Observer for NumberOfSessions and NumberOfSubSessions response

     * @see <impspurecli.h>

     */

    void HandleNbrSessionsL( TInt aId,

                             TInt aNbr,

                             TImpsCspIdentifier& aCspId );

public: // MImpsErrorHandler

    /**

     * Observer method for error messages.

     * @see <impspurecli.h>

     */

    void HandleErrorL( TInt aStatus,

                       TInt aOpId,

                       const TDesC* aDescription,

                       const CImpsDetailed* aDetailedRes,

                       TImpsCspIdentifier& aCspId );

public: // MImpsStatusHandler

    /**

     * Observer method for changes in service status.

     * @see <MImpsStatusHandler.h>

     */

    void HandleStatusChangeL( TImpsServiceStatus aStatus,

                              TImpsCspIdentifier& aCspId );

private: // new private functions

    /**

     *  Copy service tree

     *

     *  @since 3.0

     *  @param WV Engine service tree

     */

    void CopyServiceTree( TImpsServices& aFrom );

    /**

     *  Notify if new state

     *

     *  @since 3.0

     *  @param aNewState

     *  @param aEvent

     */

    void NotifyIfNewStateL( TPEngNWSessionSlotState aNewState,

                            TPEngNWSessionSlotEvent aEvent );

    /**

     *  Handle completion of the log in request

     *

     *  @since 3.0

     */

    void HandleLogInCompletionL();

protected: // construction

    /**

     * C++ constructor. protected

     */

    CImpsPluginAccessHandler();

    /**

     * Symbian Second phase constructor

     */

    void ConstructL( RImpsEng& aSessClient );

private: //Data

    enum TPEngOperation

        {

        EIdle           = 0,

        EDoingLogIn     = 1,

        EDoingLogOut    = 2,

        ECanceling      = 3

        };

    /// OWN: State of the session

    TPEngNWSessionSlotState     iSessStatus;

    /// OWN: Service tree of the session

    TPEngWVCspServicesTree2     iServices;

    /// OWN: TBool service tree fetched

    TBool                       iServiceFetched;

    /// REF: Session state observer

    RPointerArray<MPEngSessionStatusObserver> iObservers;

    /// OWN: Access client of WV Engine

    RImpsAccessClient2          iAccessClient;

    /// OWN: Operation Id from the WV Server

    TInt                        iOpId;

    /// REF: Request Status of the active request

    TRequestStatus*             iStatus;

    /// OWN: Active operation

    TPEngOperation              iOperation;

    };

#endif  //__IMPSPLUGINACCESSHANDLER_H__

// End of File