/** @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:  Class comunicates with MSs

*

*/

#ifndef C_CUPNPAVCPMANAGER_H

#define C_CUPNPAVCPMANAGER_H

// INCLUDES

#include "upnpavcontrolpoint.h"

// FORWARD DECLARATIONS

class MUpnpResponseHandler;

class MUpnpHttpResponseHandler;

class CUpnpPathResolver;

class CUpnpAVCPEngineSession;

// CLASS DECLARATION

/**

* Class implements (derive CUpnpAVControlPoint).

* It provides way to send SOAP action, HTTP request, 

* receive notification about responses also support eventing phase.

* Additionally class keeps path resolvers for each MS (if it is needed).

*

*  @since Series 60 3.1

*/

class CUpnpAVCPManager : public CUpnpAVControlPoint

	{	

	public:

		/**

		* Two-phased constructor.

		*/		

		static CUpnpAVCPManager* NewL();

		/**

		* Destructor.

		*/		        

		~CUpnpAVCPManager();

 		/**

		* Get unique command id

		* 

		* @return command id

		*/		

		TInt NewCommandId();

 		/**

 		* Register a observer for receive notification about SOAP responses

 		*

 		* @param aHandler class implemented observer

 		*/

		void RegisterForAction(MUpnpResponseHandler& aHandler);

 		/**

 		* Register a observer for receive notification about HTTP responses

 		*

 		* @param aHandler class implemented observer

 		*/        

		void RegisterForHttp(MUpnpHttpResponseHandler& aHandler);        

 		/**

 		* Unregister a observer for receive notification about HTTP responses

 		*

 		* @param aHandler class implemented observer

 		*/        

		void UnregisterForHttp(MUpnpHttpResponseHandler& aHandler);                

	    /**

	    * Return path resolver.

	    * If path resolver was created, return instance, otherwise create a new one, 

	    * subsribe for events.

	    * Parameter aSession is used for managing life time of resolver. 

	    * if all session used resolver has been closed, resolver is doestoyed.

	    *

	    * @param aUUID UDN of MS

	    * aSession server-side session

	    */            

		CUpnpPathResolver& PathResolverL(const TDesC8& aUUID, CUpnpAVCPEngineSession* aSession);

	    /**

	    * Perform cleanup after closing server-side session.

	    * it checks whether it was the last session used resolver and

	    * destroy resolver if it was true.

	    */    

		void CleanupSessionL( CUpnpAVCPEngineSession* aSession);        

	private: 	// Method from CUpnpAVControlPoint

		/**

		* From CUpnpAVControlPoint handles HTTP messages.

		* @since Series 60 2.0

		* @param aMessage Incoming HTTP message.

		*/

		void HttpResponseReceivedL(CUpnpHttpMessage* aMessage);

		/**

		* From CUpnpAVControlPoint handles actions' responses.

		* @since Series 60 2.0

		* @param aMessage Incoming HTTP message.

		*/

		void ActionResponseReceivedL(CUpnpAction* aAction);        

		/**

		* From CUpnpAVControlPoint handles events (as a response for SUBSCRIBE).

		* @since Series 60 2.0

		* @param aMessage Incoming HTTP message.

		*/        

		void StateUpdatedL(CUpnpService*  aService);

		/**

		* From CUpnpAVControlPoint handles UPnP device discoveries.

		* @since Series 60 2.0

		* @param aDevice Device that is discovered.

		*/

		void DeviceDiscoveredL(CUpnpDevice* aDevice);

		/**

		* From CUpnpAVControlPoint handles UPnP device disappears.

		* @since Series 60 2.0

		* @param aDevice Device that disappeared.

		*/

		void DeviceDisappearedL(CUpnpDevice* aDevice);

	private:

		/**

		* C++ default constructor.

		*/	

		CUpnpAVCPManager(MUpnpAVControlPointObserver* aObserver);

		/**

		* Symbian 2nd phase constructor.

		*/		        

		void ConstructL();       

    /**

    * Return index of action handler for specific session id

    * 

    * @return index if found, else KErrNotFound

    */    

		TInt HandlerBySessionId(TInt aSessionId);

    /**

    * Return index of HTTP handler for specific session id

    * 

    * @return index if found, else KErrNotFound

    */            

		TInt HttpHandlerBySessionId(TInt aSessionId);   

	private: // Data

		// last command id

		TInt iLastCommandId;

		// array of observers registered for SOAP action

		RPointerArray<MUpnpResponseHandler> iPendingHandlers;

		// array of observer registered for HTTP response

		RPointerArray<MUpnpHttpResponseHandler> iHttpPendingHandlers;

		// array of path resolvers

		RPointerArray<CUpnpPathResolver> iPathResolvers;

    };

#endif  //C_CUPNPAVCPMANAGER_H