/*

* Copyright (c) 2009 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:  Receiver of UDP datagrams

*

*/

#ifndef C_IKEV2RECEIVER_H

#define C_IKEV2RECEIVER_H

#include <e32base.h>

#include <in_sock.h>

// FORWARD DECLARATIONS

class MIkeDataInterface;

class ThdrISAKMP;

/**

 *  IKEv2 receiver callback interface.

 *  Callback interface which is used by CIkev2Receiver object to notify

 *  about received IKE message.

 * 

 *  @lib internal (ikev2lib.lib)

  */

NONSHARABLE_CLASS(MIkev2ReceiverCallback)

    {

public:        

    /**

     * Notifies about received IKE message.

     *

     * @param aIkeMsg IKE message

     * @param aSrcAddr Source IP address/port

     * @param aLocalPort Local port

     */

    virtual void IkeMsgReceived( const ThdrISAKMP& aIkeMsg,

                                 const TInetAddr& aSrcAddr,

                                 TInt aLocalPort ) = 0;

    /**

     * Notifies about receive error.

     * @param aStatus Error value

     */

    virtual void ReceiveError( TInt aError ) = 0;    

    };

/**

 *  IKEv2 receiver.

 *  Active object provides functionality for receiving UDP datagrams.

 *

 *  @lib internal (ikev2lib.lib)

  */

NONSHARABLE_CLASS(CIkev2Receiver) : public CActive

    {

public:

    /**

     * Two-phased constructor.

     * @param aDataInterface IKE data interface

     * @param aCallback Callback interface

     */

    static CIkev2Receiver* NewL( MIkeDataInterface& aDataInterface,

                                 MIkev2ReceiverCallback& aCallback );

    /**

    * Destructor.

    */

    ~CIkev2Receiver();

    /**

    * Starts receiving.

    */

    void StartReceive();

    /**

    * Stops receiving.

    */

    void StopReceive();

private:

    CIkev2Receiver( MIkeDataInterface& aDataInterface,

                    MIkev2ReceiverCallback& aCallback );

    void ConstructL();

    /**

     * Receives UDP data.

     */    

    void DoReceive();

// from base class CActive            

    /**

     * From CActive

     * Handles completion of receive.

     */    

    void RunL();

    /**

     * From CActive

     * Handles cancellation of receive.

     */    

    void DoCancel();

private: // data

    /**

     * UDP data.

     * Own.

     */

    HBufC8*                     iUdpData;

    /**

     * Source IP address/port.

     * Own.

     */

    TInetAddr                   iSrcAddr;

    /**

     * Local port.

     * Own.

     */

    TInt                        iLocalPort;

    /**

     * Informs if data is received.

     * Own.

     */

    TBool                       iReceivingData;

    /**

     * IKE data interface.

     * Not own.

     */

    MIkeDataInterface&          iDataInterface;

    /**

     * Callback interface.

     * Not own.

     */

    MIkev2ReceiverCallback&     iCallback;

    };

#endif // C_Ikev2Receiver_H