/** @file
* Copyright (c) 2005-2006 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:  Observers which receive notifications about responses of SOAP actions and HTTP requests
*
*/


#ifndef C_CUPNPRESPONSEHANDLER_H
#define C_CUPNPRESPONSEHANDLER_H

// FORWARD DECLARATIONS
class CUpnpAction;
class CUpnpHttpMessage;

// CLASS DECLARATION
/**
*  This observer class has to be implemented to receive notification 
*  about response on SOAP action.
*	 The observer is used by CUpnpAVCPManager, it use session id 
*  (taken from SessionId method) for match incoming response with corresponding
*  handler instance. After notify handler, handler is removed from 
*  registered handlers.
*
*  @see CUpnpAVCPManager
*  @since Series 60 3.1
*/
class MUpnpResponseHandler
	{
	public: // New functions 
		/**
		* This callback function is notified when Soap respone
		* with relevant session id (@see SessionId) comes.
		* @param aErrorCode error code
		* @param aMessage response message
		* @since Series 60 3.1
		*/		
		virtual void InterpretL(TInt aErrorCode, CUpnpAction* aAction) = 0;
		/**
		* Function returns session id that identifies on which response handler is waiting
		*
		* @return session id
		*/		
		virtual TInt SessionId() = 0;
		/**
		* This callback function is notified when leave appears during execution of InterpretL
		* @param aErrorCode error code of leave
		*/		
		virtual void RunError(TInt aErrorCode) = 0;
		

	};

/**
*  This observer class has to be implemented to receive notification 
*  about response on HTTP requests.
*	 The observer is used by CUpnpAVCPManager, it use session id 
*  (taken from SessionId method) for match incoming response with corresponding
*  handler instance. After notify handler, handler is not removed from 
*  registered handlers. Handler instance has to use unregister itself.
*
*  @see CUpnpAVCPManager
*  @since Series 60 3.1
*/
class MUpnpHttpResponseHandler
	{
	public: // New functions
		/**
		* This callback function is notified when HTTP respone
		* with relevant session id (@see SessionId) comes.
		* @param aErrorCode error code
		* @param aMessage response message
		* @since Series 60 3.1
		*/	
		virtual void InterpretL(TInt aErrorCode, CUpnpHttpMessage* aAction) = 0;
		/**
		* Function returns session id that identifies on which response handler is waiting
		*
		* @return session id
		*/
		virtual TInt SessionId() = 0;
		/**
		* This callback function is notified when leave appears during execution of InterpretL
		* @param aErrorCode error code of leave
		*/		
		virtual void RunError(TInt aErrorCode) = 0;		
	};
#endif // C_CUPNPRESPONSEHANDLER_H