/*

* All rights reserved.

* This component and the accompanying materials are made available

* which accompanies this distribution, and is available

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

*

*/

#ifndef M_SEN_SERVICE_CONSUMER_H

#define M_SEN_SERVICE_CONSUMER_H

const TUid KSenInterfaceUidFilesObserver            = { 0x101F9742 }; // MSenFilesObserver

const TUid KSenInterfaceUidAuthenticationProvider   = { 0x10282C6F }; // MSenAuthenticationProvider

// CLASS DECLARATION

/**

 * Callback interface for service consumers

 */

class MSenServiceConsumer

    {

    public: 

        // New functions

        /**

        * Callback, which is invoked when a message is received from invoked service.

        * Inside this method, it is guarenteed, that the TxnId() getter provided by

        * CSenServiceConnection class will return valid transaction ID. This allows 

        * one to map the ID of sent request, returned from CSenServiceConnection::SendL

        * with the response that is provided in this callback.

        * @param aMessage incoming message.

        */

        virtual void HandleMessageL(const TDesC8& aMessage) = 0;

        /**

        * Callback, which is invoked when an error message is received from invoked service.

        * Inside this method, it is guarenteed, that the TxnId() getter provided by

        * CSenServiceConnection class will return valid transaction ID. This allows 

        * one to map the ID of sent request, returned from CSenServiceConnection::SendL

        * with the response that is provided in this callback.

        * @param aErrorCode is the error code (negative number)

        * Error codes are some of the following:

        * KErrSenNotInitialized             Connection hasn't been initialized.

        * KErrConnectionInitializing        Connection is still initializing.

        * KErrSubmitting                    Submitting a message failed, 

        *                                   e.g. tried to send a NULL message.

        * KErrConnectionExpired             Connection has expired and needs to be

        *                                   renewed.

        * KErrSenSoapFault                  A SOAP fault occurred, aErrorMessage should 

        *                                   contain more detailed information.

        * KErrSenInternal                   Internal error in Web Services 

        *                                   framework

        * KErrUnknown                       An unexpected major error has occurred

        *                                   and cause is unknown.

        * Other possible error codes can be HTTP error codes or 

        * system-wide Symbian error codes.

        * @param aErrorMessage contains the error message data; with SOAP based services,

        * possibly a SOAP fault as XML.

        */

        virtual void HandleErrorL(const TInt aErrorCode, 

                                  const TDesC8& aErrorMessage) = 0;

        /**

        * This method is called when the status of the connection

        * to the service changes.

        * @param aStatus is connection state indicator, which

        * could be specified by the actual service invocation framework

        * implementation. The following status codes are possible for

        * any installed framework:

        * KSenConnectionStatusNew              Connection is being initialized, but not yet ready.

        * KSenConnectionStatusReady            Connection is ready to be used. For example, SubmitL()

        *                                      and SendL() methods (depending of framework) are in

        *                                      invocable state.

        * KSenConnectionStatusExpired          Connection is expired. Typically, a new connection

        *                                      needs next to be initialized in order to communicate

        *                                      with the underlying service behind this service

        *                                      connection.

        */

        virtual void SetStatus(const TInt aStatus) = 0;

    };

/**

 */

class MSenFilesObserver

    {

    public:

    /**

    * This method is called when new part of BLOB is sent or received.

    *

    * @param aTxnId Transaction ID.

    * @param aIncoming ETrue if it is incoming BLOB, EFalse if outgoing.

    * @param aMessage SOAP message for incoming messages with BLOBs.

    * @param aCid CID of current BLOB.

    * @param aProgress Count of sent/received BLOB bytes.

    */

    };

class MSenExtendedConsumerInterface

    {       

    public: 

	    inline virtual TAny* GetInterfaceByUid( TUid /* aUID */ ) { return NULL; };

#endif // M_SEN_SERVICE_CONSUMER_H

// End of File