// Copyright (c) 2008-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:

//

/**

 @file

 @publishedPartner

 @released

*/

#ifndef REXPLICITHTTPSESSION_H_

#define REXPLICITHTTPSESSION_H_

#include <http.h>

#include <es_sock.h>

/**

RExplicitHTTPSession is a wrapper around the RHTTPSession. 

This handle provides features which allows the application to prompt the user only once 

for the selection of an IAP during muliple connections within a session.

@publishedPartner

@released

*/

class RExplicitHTTPSession

	{

public:

    IMPORT_C RExplicitHTTPSession();

    IMPORT_C void OpenL(const TUriC8& aUri, TUint32 aIapNumber = 0, TBool aStartConnection = ETrue);

    IMPORT_C void Close();

    IMPORT_C void StartConnection(TRequestStatus& aStatus);

    IMPORT_C void CancelStart();

    IMPORT_C RHTTPSession& HTTPSession();

    inline RHTTPSession& operator()();

private:

    void BindConnectionL(TUint32 aIap, TBool aStartConnection);

    // Returns ETrue if there is a proxy to use for the given scheme; 

    // aProxyServer gets set

    TBool UseProxyL(const TDesC8& aScheme, HBufC8*& aProxyServer);

private:

    RSocketServ iSocketServ;

    RConnection iConnection;

    RHTTPSession iHTTPSession;

    TUint32 iIap;

    };

// inline methods

inline RHTTPSession& RExplicitHTTPSession::operator()()

    {

    return HTTPSession();

    }

#endif /*REXPLICITHTTPSESSION_H_*/