/*

* Copyright (c) 2002-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:   Implementation of HotSpot Server Session

*

*/

#ifndef HOTSPOTSESSION_H

#define HOTSPOTSESSION_H

//  INCLUDES

#include "hssclientplugin.h"

#include <e32base.h>

#include <e32svr.h>

#include <wlanmgmtclient.h> 

#include <wlanmgmtinterface.h>

#include <wlanmgmtcommon.h>

#include <commdb.h>

#include "hssnotif.h"

#include "hssiapsettingshandler.h"

#include "hssclientinterface.h"

#include "hsslogintimerobserver.h"

#include "hsslogouttimerobserver.h"

// FORWARD DECLARATIONS

class CHotSpotServer;

class CWlanMgmtClient;

class HssNotifications;

class CSessionNotification;

class CHssLoginTimer;

class CHssLogoutTimer;

// CLASS DECLARATION

/**

* Server side counterpart for client's Session classes.

* Each connection has own session in server.

* @lib HotSpotServer.exe

* @since Series 60 3.0

*/

                                       public MHssLoginTimerObserver,

                                       public MHssLogoutTimerObserver,

                                       public MWlanMgmtNotifications

	{

    public:

        /**

        * Two-phased constructor.

        */

        static CHotSpotSession* NewL( CHotSpotServer& aServer );

        /**

        * Destructor.

        */

        ~CHotSpotSession();

        /**

        * Struct for notifications.

        */

        struct TNotification

            {

            TInt id;

            TBuf8<KHssMaxNotificationLength> data;

            };

    public: // Functions from base classes

        /**

        * From CSession called when a client asks for service

        * @param aMessage the message

        * @return None

        */

        void ServiceL( const RMessage2& aMessage );

        /**

        * Called by ServiceL when a client asks for service

        * @param aMessage the message

        * @return None

        */

        void DispatchMessageL( const RMessage2& aMessage );

        /**

        * From MHssLoginTimerObserver. Called when time used for Login(..)

        * has run out for client.

        * @return None

        */

        void LoginTimeout();

         /**

        * From MHssLogoutTimerObserver. Called when time used for Logout(..)

        * has run out for client.

        * @return None

        */

        void LogoutTimeout();

        /**

        * From MWlanMgmtNotifications

        * @since Series 60 3.0

        * @param aNewState State of WLAN

        * @return None

        */

        virtual void ConnectionStateChanged( TWlanConnectionMode aNewState );

    public: // New functions

        /**

        * Methods for handling passthrough notifications

        */

        void HandleCancelNotifications( const RMessage2& aMessage );

        void AddNotification( TInt aNotification, TDes8& aData );

        void HandleOrderNotifications( const RMessage2& aMessage );

        void HandleNotification();

    private:

        /**

        * C++ default constructor.

        */

        CHotSpotSession( CHotSpotServer& aServer );

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL();	

        /**

        * Starts client register procedures

        * @param aMessage, RMessage from client side

        * @return None

        */

        /**

        * Starts client unregister procedures

        * @param aMessage, RMessage from client side

        * @return None

        */

        /**

        * Starts login procedures

        * @param aIapId, IAP id

        * @param aNetId, Network id

        * @return KErrNone, if successful, otherwice one of system wide errorcodes.

        */

          /**

        * Starts Join procedures

        * @param aIapId, IAP id

        * @return KErrNone, if successful, otherwice one of system wide errorcodes.

        */

        TInt ProcessStartL( const TUint aIapId );

        /**

        * Starts Configure & reJoin procedures

        * @param aIapId, IAP id

        * @return KErrNone, if successful, otherwice one of system wide errorcodes.

        */

        TInt ProcessStartAgain( const TUint aIapId );

        /**

        * Sends WLAN association status to client

        * @param aIapId, IAP id

        * @param aResult, ETrue is successful, otherwise EFalse

        * @return KErrNone, if successful, otherwice one of system wide errorcodes.

        */

        TInt ProcessAssociationStatus( const TUint aIapId, TBool aResult );        

        /**

        * Starts CloseConnection procedures

        * @param aIapId, IAP id

        * @return KErrNone, if successful, otherwice one of system wide errorcodes.

        */

        TInt ProcessCloseL( const TUint aIapId );

        /**

        * Creates client instance through ECom

        * @param aUid, ECom implementation UID of client

        * @return KErrNone, if successful, otherwice one of system wide errorcodes.

        */

        TInt CreateClient( const TUid aUid, TDesC8& aUidText );

        /**

        * Makes server shutdown processes (agent change and IAP removals)

        * @param aMessage, Message for completing request

        */

        void ProcessServerShutdown( const RMessage2& aMessage );

        /**

        * Removes brackets from the UID

        * @param aUid, UID of the client

        */

        void ModifyClientUid( TDes& aUid );

        /**

        * Convert descriptor to TUid and saves it to member variable

        * @param aUid, UID of the client

        */

        void ConvertTBufToTUid( TDes& aUid );

    private:    // Data

        /** 

        * List of pending (not sent) notifications. 

        */

        RArray<TNotification> iPendingNotifications;

        /** 

        * The request from the client pending for a notification. 

        */

        RMessagePtr2 iPendingNotificationRequest;

        /** 

        * Is there a pending request from the client. 

        */

        TBool iIsNotificationRequestPending;

	    /**

        * Handle to server

        */	

        CHotSpotServer& iServer;    

        /**

        * Instance of 3rd party client (ECom)

        * Own

        */

        CHssClientPlugin* iClient;

        /**

        * Handle to MHssSrvNotifications

        */

		MHssSrvNotifications *iSrvNotifications;

        /** 

        * Handle to remove notification. 

        */

        CSessionNotification* iNotificationHandle;

	    /**

        * RMessage instance

        */	

	    RMessage2 iMessage;

	    /**

        * IAP id in use

        */	

	    TInt iIapId;

	    /**

        * Network Id in use

        */

	    TInt iNetId;

        /**

        * handle to WlanMgmtClient

        */

    	CWlanMgmtClient *iMgtClient;

        /**

        * handle to HssNotifications

        */

 	    HssNotifications *iNotifications;

        /**

        * Handler for changing IAP settings

        * Own

        */

        CHssIapSettingsHandler* iIapSettingsHandler;

        /**

        * Timer used for client Login procedure

        * Own

        */       

        CHssLoginTimer* iLoginTimer;

        /**

        * Timer used for client Logout procedure

        * Own

        */       

        CHssLogoutTimer* iLogoutTimer;

        /**

        * Flag for notification sending

        */       

		TBool iAllowNotifications;

        /**

        * Client UID of this session

        */

        TUid iClientUid;

        /**

        * Flag for indicate if extended HSFW API is used

        */

        TBool iHotspotExtension;

	};

#endif