/*

* Copyright (c) 2002-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:   Header file for COMASUPLProtocolManager2 implementation

*

*/

#ifndef C_COMASUPLPROTOCOLMANAGER2_H

#define C_COMASUPLPROTOCOLMANAGER2_H

#include <e32cmn.h> 

#include <etel.h> 

#include <etelmm.h> 

//#include "epos_csuplprotocolmanagerbase.h"   // interface

#include "epos_comasuplprotocolmanager.h"

#include "epos_msuplsettingsobserver.h"

#include "epos_msuplsessionobserver.h"

#include "epos_msuplpacketnotifier.h"

#include "epos_momasuplecomeventobserver.h"

#include "epos_comasuplsettingslauncher.h"

#include "epos_csuplsettingsinternal.h"

#include "epos_comasuplsession2.h"

#include "epos_comasuplasnbase.h"

class COMASuplTrace;

class CSuplCommunicationManager;

class RMobilePhone;

class RTelServer;

class COMASuplSettings;

class COMASuplPosHandlerBase;

class COMASuplSETSessionID;

class COMASuplSLPSessionID;

class COMASuplEcomEventWatcher;

class TSuplTerminalQop;

class CSuplSettings;

class COMASuplTimeoutTimer;

class COMASuplETelNotifier;

/**

 *  MOMASuplSessionObserver observer for session termination operation. 

 *  @lib eposomasuplprotocolhandler.lib

 *  @since S60 v3.1

 */

class MOMASuplSessionObserver

{

public:

		/**

		* TerminateSession

		* @since S60 v3.1u

		* @param aSession, session which is going to terminate

		* @param aErrorCode, error code for completion of request. 

		*/

		virtual void TerminateSession(CSuplSessionBase *aSession, TInt aErrorCode) = 0;

};

	/**

	*  An implementation of the COMASUPLProtocolManagerBase definition. 

	*  @lib eposomasuplprotocolhandler.lib

	*  @since S60 v3.1

	*/

class COMASUPLProtocolManager2 : public COMASUPLProtocolManager,

								public MOMASuplSessionObserver,

								public MSuplSettingsObserver,

								public MOMASuplTimeOutNotifier,

                				public MOMASuplETelNotifierObserver,

                				public MSuplSessionObserver

    {

public:

	/**

	* NewL, Create instance of concrete implementation. 

	* @since S60 v3.1u		

	* @param      None

	* @return    Instance of this class.

	*/

   IMPORT_C static COMASUPLProtocolManager2* NewL();

	/**

	* ~COMASUPLProtocolManager2

	* @since S60 v3.1u		

	* @param      None

	* @return     None

	*/

  IMPORT_C  ~COMASUPLProtocolManager2();

	/**

	* CreateNewSessionL, Creates new SuplSession instance

	* @since S60 v3.1u

	* @param      aRequestType, used for differentiation between SET & NET cases

	* @return     Instance of CSuplSessionBase.

	*/

  IMPORT_C virtual CSuplSessionBase* CreateNewSessionL( 

										CSUPLProtocolManagerBase::TSuplReqType aRequestType, 

										TInt aIpcSessionId,

										RSuplTerminalSubSession::TSuplServiceType aSuplService);

	/**

	* RunSessionL, Starts the SUPL Sesssion for Terminal Initiated Location Request

	* @since S60 v3.1

	* @param       aSuplSession , session object on which processing will start

	* @param       aStatus, 	  On completion, sets status of the request

	* @param       aAllowedCapabilities , Allowed capabilities of SET

	* @Param:      aQop,  specifies the quality of position

	* @param       aRequestID , Request ID of Session

	* @return      None

	*/

  IMPORT_C  virtual void  RunSessionL(CSuplSessionBase *const aSuplSession,TRequestStatus& aStatus, const TDesC& aHslpAddress, TBool aFallBack, TBool aFirstReq,

  										TInt aAllowedCapabilities,TSuplTerminalQop& aQop, TInt aRequestID = 0);

	/**

	* RunSessionL, Starts the SUPL Sesssion for Terminal Initiated Location Request

	* @since S60 v3.1

	* @param       aSuplSession , session object on which processing will start

	* @param       aStatus, 	  On completion, sets status of the request

	* @param       aAllowedCapabilities , Allowed capabilities of SET

	* @param       aRequestID , Request ID of Session

	* @return      None

	*/

  IMPORT_C  virtual void  RunSessionL(CSuplSessionBase *const aSuplSession,TRequestStatus& aStatus,const TDesC& aHslpAddress, TBool aFallBack,

  										TBool aFirstReq, TInt aAllowedCapabilities, TInt aRequestID = 0);

	/**

	* HandleSuplMessage, Handles session in NET initiated case

	* @since S60 v3.1

	* @param       aSuplSession , session object on which processing will start

	* @param       aStatus, 	  On completion, sets status of the request

	* @param       aMessage,	message to be decoded.

	* @return      None

	*/

  IMPORT_C  virtual void  HandleSuplMessageL(CSuplSessionBase *const aSuplSession,TRequestStatus& aStatus,HBufC8* aMessage);

	/**

	* DestroySession, Destroys the specified Supl Session instance

	* @since S60 v3.1u

	* @param      aSuplSession , session object which has to delete

	* @return     TInt,returns KErrNone if deleted successfully else KErrArgument  

	*/

  IMPORT_C  TInt  DestroySession(CSuplSessionBase* aSuplSession);	

	/**

	* InitializeL, Does the asynchonous initilization. 

	* @since S60 v3.1u

	* @param      aCommManager,Communication Manager

	* @param      aInitilizationRequestStatus, TRequestStatus for asynchronous initilization operation

	* @return     None

	*/

  IMPORT_C  void InitializeL(CSuplCommunicationManager* aCommManager,TRequestStatus& aInitilizationRequestStatus);

     /**

     * Function:     CancelInitialize, 

     * @Description: Does the cancellation of asynchonous initilization. 

     * @Param:       None

     * @Returns:     None

     */

  IMPORT_C  void CancelInitialize();

	/**

	* Function:     DeInitialize, 

	* @since S60 v3.1u

	* @Description: Does the de-initilization. 

	* @Param:       aDeInitRequestStatus,for asynchronous de-initilization of protocol manager

	* @Returns:     None

	*/

  IMPORT_C void DeInitialize(TRequestStatus& aDeInitRequestStatus);

	/**

	* Function:     CancelDeInitialize, 

	* @since S60 v3.1u

	* @Description: Does the cancellation of asynchonous de-initilization. 

	* @Param:       None

	* @Returns:     None

	*/

  IMPORT_C void CancelDeInitialize();

	/**

	* HandleSuplPackets,Process Supl message which are comming from SLP

	* @since S60 v3.1u

	* @param       aPacket, message packet

	* @return      None

	*/

              IMPORT_C void HandlePacket(const TDesC8& aPacket, TUint aPortNum);

	/**

	* HandlePacketError,Process Supl message receiving Errors 

	* @since S60 v3.1u

	* @param      aError, the Error Code

	* @return     None

	*/

  IMPORT_C virtual void HandlePacketError(TInt aError);

	/**

	* CancelRunSession,Cancels an in-progress Terminal Initiated Location Request

	* @param       aSession, The session on which the request has to be cancelled

	* @return      None

	*/

  IMPORT_C void CancelRunSession(CSuplSessionBase* aSuplSession);

	/**

	* Function:     RunPeriodicTriggerSessionL, 

	* @since S60 v5.2

	* @Description: Starts processing on session

	*

	* @Param:       aSuplSession , session object on which processing will start

	* @Param:       aStatus, On return, the status of the request

	* @Param:       aPTrigger, specifies the periodic trigger session

	* @Param:       aFallBack, enables the SUPL's Multiple-SLP Fallback Mechanism

	* @Param:       aAllowedCapabilities , Allowed capabilities of SET

	* @Param:       aRequestID , Request ID of Session

	*

	* @Returns:     None

	*/

  IMPORT_C virtual void RunSuplTriggerSessionL(

  					 CSuplSessionBase *const aSuplSession,

  					 TRequestStatus& aStatus,

  					 TSuplTerminalPeriodicTrigger& aPTrigger,

  					 const TDesC& aHslpAddress, 

  					 TBool aFallBack,

  					 TInt aAllowedCapabilities,

  					 TInt aRequestID = 0);

	/**

	* Function:     NotifyTriggerFiredL 

	* @since S60 v5.2

	* @Description: Notifies the position fix trigger

	*

	* @Param:       aSuplSession , session object on which processing will start

	* @Param:       aStatus, On return, the status of the request

	* @Param:       aFireInfo, On return, the position fix in defined interval

	*

	* @Returns:     None

	*/

  IMPORT_C virtual void NotifyTriggerFiredL(

    				 CSuplSessionBase *const aSuplSession,

  					 TRequestStatus& aStatus, 

        			 TSuplTriggerFireInfo& aFireInfo);

	/**

	* CancelPeriodicTriggerSession,Cancels an in-progress Terminal Initiated 

	* Periodic Trigger Session Location Request

	*

	* @param       aSession, The session on which the request has to be cancelled

	* @return      None

	*/

  IMPORT_C virtual void CancelSuplTriggerSession(CSuplSessionBase* aSuplSession);

  IMPORT_C   COMASuplSession* FindSessionOnPortNum(TUint aPortNum) const ;

public : // From base class, MOMASuplSessionObserver

	/**

	* TerminateSession,Terminate the SUPL Session specified by the paramerter

	* @since S60 v3.1u

	* @param       aSession, the SUPL Session to be terminated

	* @param       aErrorCode,error code by which session completes

	* @return      None

	*/

	virtual void TerminateSession(CSuplSessionBase *aSession, TInt aErrorCode);

	void UpdateAllSubSessnsInSameSession(TInt aIpcSessionId);

	void SettingsChanged();

public: //From base class MSuplSettingsObserver

	/**

	* HandleSuplSettingsChangeL,Observeed function, gets called.

	* @since S60 v3.1

	* @param       aEvent,TSuplSettingsEventType, type of event.

	* @return      None

	*/

    virtual void HandleSuplSettingsChangeL(TSuplSettingsEventType aEvent,TInt aSlpId);                 

public:  // From base class MSuplSessionObserver

	/**

	* HandleSuplSessionChangeL,Observeed function, gets called.

	* @since S60 v5.2

	* @param       aEvent,TSuplSettingsEventType, type of event.

	* @return      None

	*/

	void HandleSuplSessionChangeL(MSuplSessionObserver::TSuplSessionEventType aEvent,TInt64 aSessionId);

	/**

	* Handles Pos handler unload event

	* @since S60 v3.1u

	* @param       None

	* @param       None

	* @return      None

	*/

	void PlugInUninstalled();  

private: // Construction

	/**

	* COMASUPLProtocolManager2,Perform the first phase of two phase construction

	* @since S60 v3.1u

	* @param       None

	* @return      None

	*/

	COMASUPLProtocolManager2();

	/**

	* ConstructL,Perform the second phase construction of a COMASUPLProtocolManager2 object.

	* @since S60 v3.1u

	* @param       None

	* @return      None

	*/

	void ConstructL();

	/**

	* CreateNewSessionL,An overloaded version that takes the COMASuplSession::TOMASuplReqType

	*     			This additional method is required to take of invalid session ID

	* @since S60 v3.1u

	* @param       None

	* @return      None

	*/

	//virtual 

	CSuplSessionBase* CreateNewSessionL(

						COMASuplSession::TOMASuplReqType aRequestType, 

						TInt aIpcSessionId,

						RSuplTerminalSubSession::TSuplServiceType aSuplService

	);

private : //For internal use only       

	/**

	* CompleteInitilization,Completes TRequestStatus used for initilization.

	* @since S60 v3.1u

	* @param       aError, error code by which we are going to complete TRequestStatus.

	* @return      None

	*/

	void CompleteInitilization(TInt aError);  														

	/**

	* CheckForSessionCount, Check Max session count,if its reaches to max then resets to Zero.

	* @since S60 v3.1u     

	* @param      None

	* @return     None

	*/

	void CheckForSessionCount();

	/**

	* ConnectToETelL, Connects to Telephony server & RMobilePhone

	* @since S60 v3.1u     

	* @param      None, 

	* @return     TInt, returns system wide error code

	*/

	TInt  ConnectToETelL();

	/**

	* DeleteAllSessions, Deletes all sessions,if any session is remaining in array

	* @since S60 v3.1u     

	* @param      None, 

	* @return     None

	*/

	void DeleteAllSessions();	

	/**

	* HandleOMASuplPackets, Handles OMA Packets,passes to approriate session

	* @since S60 v3.1u     

	* @param      aPacket, Packet received from gateway...(i.e. thro' Communication Manager)

	* @return     None

	*/

	void HandleOMASuplPacketsL(const TDesC8& aPacket, TUint aPortNum);

	/**

	* FindSession,finds session in sessions array,using decoded message 

	* @since S60 v3.1u     

	* @param      aRetrivedSessionID,Session which has to be find in sessions array. 

	* @return     CSuplSessionBase*, session which found in sessions array,if any.

	*/

    COMASuplSession* FindSession(COMASuplSessionID* aRetrivedSessionID,TBool& aInvalidSLPId, TBool& aInvalidSETId) const;

	/**

	*  GetSETSessionID, Retrives SET ID from COMASuplSessionID

	* @since S60 v3.1u

	* @param       aOMAsuplSessionID,Session ID. 

	* @return      COMASuplSETSessionID, SET ID retrived from aOMAsuplSessionID.

	*/

	COMASuplSETSessionID* GetSETSessionID(COMASuplSessionID* aOMAsuplSessionID) const;

	/**

	* GetSLPSessionID, Retrives SLP ID from COMASuplSessionID

	* @since S60 v3.1u     

	* @param      aOMAsuplSessionID,Session ID. 

	* @return     COMASuplSLPSessionID, SLP ID retrived from aOMAsuplSessionID.

	*/

	COMASuplSLPSessionID* GetSLPSessionID(COMASuplSessionID* aOMAsuplSessionID) const;

	/**

	* CompareSETSessionID, Compares two SET ID of two Sessions.

	* @since S60 v3.1u     

	* @param      aSuplSETID, SET Session ID. 

	* @param      aRetrivedSuplSETID, SET Session ID. 

	* @return     TBool, if SET Session id matches returns ETrue else EFalse

	*/

	TBool CompareSETSessionID(COMASuplSETSessionID* aSuplSETID,

							  COMASuplSETSessionID* aRetrivedSuplSETID) const;

    /**

     * CompareSLPSessionID, Compares two SLP ID of two Sessions.

     * @since S60 v3.1u          

     * @param      aSuplSLPID, SLP Session ID. 

     * @param      aRetrivedSuplSLPID, SLP Session ID. 

     * @return     TBool, if matches returns ETrue else EFalse

     */

	TBool CompareSLPSessionID(COMASuplSLPSessionID* aSuplSLPID,

							 COMASuplSLPSessionID* aRetrivedSuplSLPID) const;	

    /**

     * ProcessInvalidSessionL, Processes invalid session, if any comes

     * @since S60 v3.1u          

     * @param      aRetrivedSessionID,SessionID of SuplSession. 

     * @return     None.

     */

	void ProcessInvalidSessionL(COMASuplAsnMessageBase* aDecodedMsg);

    /**

     * ReadOMASuplSettingsL, Reads OMA Supl Configuration.

     * @since S60 v3.1u          

     * @param      None. 

     * @return     None.

     */

	void ReadOMASuplSettingsL();

    /**

     * ReadOMASuplConfigurationL, Reads OMA Supl Configuration.

     * @since S60 v3.1u          

     * @param      None. 

     * @return     None.

     */

	void ReadOMASuplConfigurationL();

    /**

     * ResetBufferingParameters, 

     * @since S60 v3.1          

     * @param      None. 

     * @return     None

     */

	void ResetBufferingParameters();

	// For Logging purpose

	void LogPacket(const TDesC8& aPacket,COMASuplAsnMessageBase* decodedAsn);

	void LogAvailableSessions( COMASuplSETSessionID* aSuplSETID,COMASuplSLPSessionID* aSuplSLPID,TInt aTotalCount) const;

	void LogReceivedSessionIdL(COMASuplSessionID* aRetrivedSessionID);

	void PrintHex(const TDesC8& aBuffer,TInt aLine);

	TInt GetNetworkModeL();

	/**

	* LoadOMASUPLPluginsL, Loads supl protocolhandler plugins

	* @since 		S60 v9.2TB

	* @param      	None

	* @return     	None

	*/

	void LoadOMASUPLPluginsL();

protected:	//From MCompleteInitilization

    /**

     * InitilizationCompletedL, Gets called after initilization gets completed with error or without error.

     * @since S60 v3.1u          

     * @param      aError,Error code if any happen while initilization.

     * @return     None.

     */

	void InitilizationCompletedL(TInt aError);