/*

* 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 SUPL Communication Manager

*

*/

#ifndef C_CSUPLCOMMUNICATIONMANAGER_H

#define C_CSUPLCOMMUNICATIONMANAGER_H

#include <e32std.h>

#include <es_sock.h>

#include "epos_msuplpacketnotifier.h"

// CONSTANTS

//const ?type ?constant_var = ?constant;

const TInt KMaxSessionPerConn = 1;

// Forward Declaration

class CSuplConnection;

class MSuplPacketReceiver;

class CSuplConnTrace;

// CLASS DECLARATION

/**

*  CSuplCommunicationManager is the Singleton that provides SUPL Connection 

*  to be used by Protocol Handler

*  

*  This provides the methods to create and destroy for SUPL Connection

*  Provides method to handle incoming packets from the network

*  

*

*  @lib EPosSuplProtocolHandlerPlugin.dll

*  @since Series 60 3.1M //e.g. Series 60 3.0

*/

class CSuplCommunicationManager : public CBase, public MSuplPacketNotifier

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        /**

        * Destructor.

        */

        IMPORT_C virtual ~CSuplCommunicationManager();

    public: // New functions

        /**

        * Initialize.

        * @since Series 60 3.1M

        * @param None

        * @return TInt. If sucessful, returns KErrNone. 

        * For unsuccessful cases, it returns a System wide

        * error code

        */

        IMPORT_C TInt Initialize();

        /**

        * CreateConnection.

        * @since Series 60 3.1M

        * @param aHostAddress HostAddress with which connection has to

        * be established

        * @return CSuplConnection *

        */

        IMPORT_C CSuplConnection *CreateConnectionL(const TDesC &aHostAddress, 

        											const TUint aPort,

        											const TInt aIAPId);

        //---------------------------------------ADDITIONAL CREATECONNECTIONL METHOD(TAKES TLS ALSO)-----------------------------

        IMPORT_C CSuplConnection *CreateConnectionL(const TDesC &aHostAddress, 

        											TBool aTls, 

        											TBool aPskTls, 

        											const TUint aPort,

                                                    const TInt aIAPId);

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

        /**

        * DestroyConnection.

        * @since Series 60 3.1M

        * @param CSuplConnection *

        * @return none

        */

        IMPORT_C TInt DestroyConnection(CSuplConnection *aConnection);

        /**

        * SetPacketReceiver.

        * @since Series 60 3.1M

        * @param MSuplPacketReceiver

        * @return none

        */

        IMPORT_C void SetPacketReceiver(MSuplPacketReceiver *aReceiver);

    public: // Functions from base classes

         /**

        * From MSuplPacketNotifier - To handle received packets fromk the

        * Network.

        * @since Series 60 3.1U

        * @param aPacket - The packet received from the network

        * @return None

 		*/

        void HandlePacket(const TDesC8 &aPacket, TUint aPortNo);

        /**

        * From MSuplPacketNotifier - To handle any errors while trying to

        * read packets from the network

        * @since Series 60 3.1U

        * @param aError - The Error value 

        * @return None

 		*/        

        void HandlePacketError (const TInt aError);

    protected:  // New functions

        /**

        * FindConnection.

        * @since Series 60 3.1M

        * @param aHostAddress

        * @param aPort

        * @return CSuplConnection *

        */

        CSuplConnection *FindConnection( const TDesC &aHostAddress, const TUint aPort );

        /**

        * FindConnection.

        * @since Series 60 3.1M

        * @param aConnection

        * @return TInt

        */

        TInt FindConnection( const CSuplConnection *aConnection );

        /**

        * RemoveConnection.

        * @since Series 60 3.1M

        * @param CSuplConnection *

        * @return none

        */

        void RemoveConnection(TInt aIndex);

        /**

        * DestroyAllConnections.

        * @since Series 60 3.1M

        * @param none

        * @return none

        */

        void DestroyAllConnections();

    protected:  // Functions from base classes

        /**

        * From ?base_class ?member_description

        */

        //?type ?member_function();

    private:

        /**

        * C++ default constructor.

        */

        /**

        * By default Symbian 2nd phase constructor is private.

        */

        void ConstructL();

    public:     // Data

    protected:  // Data

    private:    // Data

        // A Pointer Array holding the CSuplConnection pointers

        RPointerArray<CSuplConnection> iConnArray;

        // RSocketServ 

        RSocketServ iSocketServ;

        // If Connected ??

        TBool iServerConnected;

        // Packet Receiver

        MSuplPacketReceiver *iPktReceiver;

        // Trace Log

        CSuplConnTrace* iTrace;

    };

#endif      // C_CSUPLCOMMUNICATIONMANAGER_H   

// End of File