/** @file
* Copyright (c) 2008 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:  Declares the CUpnpHttpClientEngine class
*
*/


#ifndef __UPNPHTTPCLIENTENGINE_H__
#define __UPNPHTTPCLIENTENGINE_H__

// INCLUDES
#include <http/rhttpsession.h>
#include <es_sock.h>
#include "upnphttpmessagesenderowner.h"
#include "upnpconnectionmanagerproxy.h"

// FORWARD DECLARATIONS
class CUpnpHttpTransaction;
class CUpnpHttpMessageSender;

// CLASS DECLARATION

/**
* MUpnpHttpClientObserver
* CUpnpHttpClientEngine passes end of transaction event with this interface.
* An instance of this class must be provided for construction of CUpnpHttpClientEngine.
*/
class MUpnpHttpClientObserver
    {
    public:
        virtual void ClientResponseRecivedLD( CUpnpHttpTransaction& aEndedTransaction ) = 0;
    };

/**
* CUpnpHTTPClientEngine
* Provides simple interface to HTTP Client API.
*/
NONSHARABLE_CLASS( CUpnpHttpClientEngine ): public CBase, public MUpnpHttpMessageSenderOwner
    {
    public:
        /**
        * Create a CUpnpHttpClientEngine object.
        * @param  iObserver:
        * @return A pointer to the created instance of CWebClientEngine
        */
        IMPORT_C static CUpnpHttpClientEngine* NewL(
            MUpnpHttpClientObserver& aObserver, TInt aActiveIap );

        /**
        * Create a CUpnpHttpClientEngine object and leave it on cleanup stack.
        * @param  iObserver:
        * @return A pointer to the created instance of CWebClientEngine
        */
        IMPORT_C static CUpnpHttpClientEngine* NewLC(
            MUpnpHttpClientObserver& aObserver, TInt aActiveIap );

        /**
        * Destroy the object
        */
        IMPORT_C ~CUpnpHttpClientEngine();

        IMPORT_C void SendL( CUpnpHttpTransaction& aTransaction );
        
        /*IMPORT_C*/ void Cancel( CUpnpHttpTransaction& aTransaction );
private:
        TInt Find( CUpnpHttpTransaction& aTransaction );


private://from MUpnpHttpMessageSenderOwner

        /*
         * Destroyes sender and removes it from senders list.
         */
        virtual void SenderFinishedLD( CUpnpHttpMessageSender* aSenderToRelease );

private:

        /**
        * Perform the second phase construction of a CWebClientEngine object.
        */
        void ConstructL( TInt aActiveIap );

        /**
        * Perform the first phase of two phase construction.
        * @param iObserver:
        */
        CUpnpHttpClientEngine( MUpnpHttpClientObserver& iObserver );

    private: 
        RHTTPSession            	iSession;
        MUpnpHttpClientObserver&    iObserver;

        RSocketServ iSocketServ;
        CUpnpConnectionManagerProxy* iConnectionManagerProxy;

        RPointerArray<CUpnpHttpMessageSender> iSenders;
    };

#endif // __UPNPHTTPCLIENTENGINE_H__

//  End of File