/** @file
* Copyright (c) 2005-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:  defines CUpnpConnManagerSession
*
*/

#ifndef C_CUPNPCONNMANAGERSESSION_H
#define C_CUPNPCONNMANAGERSESSION_H

#include <e32base.h>
#include "upnpconnmanagercommon.h" 
#include "upnpconnectionmanagernetworkevent.h"

class CUpnpConnectionManager;
class CUpnpConnManagerEngine;

/**
 * An instance of class CUpnpConnManagerSession is created for each client
 * @since S60 5.0
 */
class CUpnpConnManagerSession : public CSession2
    {

public: // New methods

    /**
     * Create a CUpnpConnManagerSession object using two phase construction,
     * and return a pointer to the created object
     * @param aEngine the message handler engine
     * @result pointer to new session
     */
    static CUpnpConnManagerSession* NewL( CUpnpConnManagerEngine& aEngine );

    /**
     * Create a CUpnpConnManagerSession object using two phase construction,
     * and return a pointer to the created object
     * (leaving a pointer to the object on the cleanup stack)
     * @param anEngine the message handler engine
     * @result pointer to new session
     */
    static CUpnpConnManagerSession* NewLC( CUpnpConnManagerEngine& aEngine );

    /**
     * Destroy the object and release all memory objects
     */
    virtual ~CUpnpConnManagerSession();

public: // From CSession

    /**
     * Called after a service request from client; from class CSession
     * @param aMessage message from client (containing requested operation and any data)
     */
    void ServiceL( const RMessage2& aMessage );
            
    /**
     * Cancels subscription for network events
     */ 
    void CancelSubscription();
    
    /**
     * Called when WLan Lost occurs or someone stops the connection
     */ 
    void WLanLostOccuredL();
    
    /**
     * Called when interface IP Address has changed
     * @param new address
     */ 
    void AddressChangeOccuredL( TInetAddr& aAddr );
    
    /**
     * Returns value of iSessionUseConnection variable
     */ 
    TBool SessionUseConnection();

    /**
     * Called when connection was closed by server
     */ 
    void ConnectionClosedL();

private: // New methods

    /**
     * Perform the first phase of two phase construction
     * @param aServer the message handler server
     * @param aEngine the message handler engine
     */
    CUpnpConnManagerSession( CUpnpConnManagerEngine& aEngine );

    /**
     * Causes the client thread to panic
     * @param panic code
     */
    void PanicClient( const RMessage2& aMessage, TInt aPanic ) const;

private:

    // Events service functions
    TInt EventEnsureStartRConnectionL( const RMessage2& aMessage );
    void EventIsRConnectionStartedL( const RMessage2& aMessage );
    void EventSubscribeToNetworkEventL( const RMessage2& aMessage );
    void EventCancelSubscribeToNetworkEvent( );        
    void EventActiveIapL( const RMessage2& aMessage );               
    void EventLocalAddressL( const RMessage2& aMessage );
    
    // Conpletions of NetworkEvent events
    void WLanLostCompleteL();
    void AddressChangeCompleteL();
    void ConnectionClosedCompleteL();

private:

    /* @var iEngine Reference to the message handler engine */
    CUpnpConnManagerEngine& iConnEngine;
    
    /* @var iSubsriberMessage subscriber's message */
    RMessage2 iSubscriberMessage;
    
    /* @var iLastEvent the last network event */
    TUpnpConnectionManagerNetworkEvent iLastEvent;

    /* @var iSessionUseConnection Indicates if session called EnsureStart() */
    TBool iSessionUseConnection;
    
    };

#endif // C_CUPNPCONNMANAHERSESSION_H