/*

* 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:  Defines the HTTP observer interface

*

*/

#ifndef WMDRMDLADEFAULTHTTPMANAGEROBSERVER_H

#define WMDRMDLADEFAULTHTTPMANAGEROBSERVER_H

// INCLUDES

#include <e32std.h>

#include <http/mhttpauthenticationcallback.h>

#include <http/mhttptransactioncallback.h>

/**

* MWmDrmDlaDefaltHttpManagerObserver

* Notification interface used to report HTTP progress.

*/

class MWmDrmDlaDefaltHttpManagerObserver

    {

    public:

        /**

         * Called if authentication is required.

         * @param aUsername - The username to be used for WWW authentication

         *                    client. The pointer should be NULL and the 

         *                    function will allocate new memory to hold the

         *                    username and return it

         * @param aPassword - The password to be used for WWW authentication

         *                    client. the pointer should be NULL and the

         *                    function will allocate new memory to hold the 

         *                    username and return it

         * @return true if the client has provided username and password, 

         *         false otherwise

         */

        virtual TBool OnGetUsernamePasswordL( HBufC8*& aUsername, 

                                              HBufC8*& aPassword ) = 0;

        /**

         * Called when server returns response headers.

         * @param aResponse - HTTP transaction response

         * @param aHeaders - response headers

         * @param aStringPool - reference to the string pool belonging

         *                      to this transaction

         * @param aHttpStatus - status code of the resonse header

         */

        virtual void OnResponseHeadersL( const RHTTPResponse& aResponse, 

                                         const RHTTPHeaders& aHeaders,

                                         const RStringPool& aStringPool, 

                                         TInt aHttpStatus ) = 0;

        /**

         * Called for each chunk of data returned from server.

         * @param aDataChunk - data chunk

         */

        virtual void OnResponseBodyDataL( const TPtrC8 aDataChunk ) = 0;

        /**

         * Called upon transaction has been completed.

         * @param aError - An error returned from the HTTP library

         */

        virtual void OnTransactionComplete( TInt aError ) = 0;

    };

#endif  // WMDRMDLADEFAULTHTTPMANAGEROBSERVER_H

// End of File