/** @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:  Resolve path(FS) into id (UPnP)

*

*/

#ifndef C_CUPNPRESOLVEHANDLER_H

#define C_CUPNPRESOLVEHANDLER_H

//  INCLUDES

#include <e32base.h>

#include "upnpresponsehandler.h"

#include "upnpresolverobserver.h"

// FORWARD DECLARATIONS

class CUpnpPathResolver;

class CUpnpAVCPManager;

// CLASS DECLARATION

/**

* Class responsible for translating path into id.

*

*  @since Series 60 3.1

*/

class CUpnpResolveHandler: public CBase, public MUpnpResponseHandler

	{	

	public:

		/**

		* Two-phased constructor.

		*

		* @param aAVCPManager manager

		* @param aResolver path resolver

		* @param aObserver observer to nofity

		*/		

		static CUpnpResolveHandler* NewL(CUpnpAVCPManager& aAVCPManager,

			CUpnpPathResolver& aResolver, MUpnpResolverObserver& aObserver);	

		/**

		* Destructor.

		*/			

		virtual ~CUpnpResolveHandler();

		/**

		* Request for tranlating given path in to id.

		* Method parses path into element and tries to match.

		* Inform use about result by observer,

		*

		* @param aPath path

		*/

		void ResolveL(const TDesC8& aPath);

	public:	// Method from observers	

		/**

		* From MUpnpResponseHandler returns session id.

		* It is also defined in MUpnpResponseHandler, MUpnpHttpResponseHandler

		* @since Series 60 3.1

		*/	

		TInt SessionId();

		/**

		* From MUpnpResponseHandler, it is notified when SOAP respone 

		* with relevant session id comes.

		* @param aErrorCode error code

		* @param aAction action with attached respone

		* @since Series 60 3.1

		*/	

		void InterpretL(TInt aErrorCode, CUpnpAction* aAction);

		/**

		* From MUpnpResponseHandler, it is notified when leave appears 

		* during InterpretL

		* @param aErrorCode error code

		* @since Series 60 3.1

		*/

		void RunError(TInt aErrorCode);

	private:

		/**

		* C++ default constructor.

		*/	

		CUpnpResolveHandler(CUpnpAVCPManager& aAVCPManager,

			CUpnpPathResolver& aResolver, MUpnpResolverObserver& aObserver);

		/**

		* Symbian 2nd phase constructor.

		*/					

		void ConstructL();

		/**

		* Check next element in path, if it is the last notify observer.

		* If matching elemrnt wasn't found inform observer.

		*

		* @param aSendAction indicate whether use browse action 

		*	if not found or inform used about error.

		*/		

		void CheckNextElementL(TBool aSendAction = ETrue);    

	private:

		// manager

  	CUpnpAVCPManager& iAVCPManager;	

  	// resolver instance

		CUpnpPathResolver& iResolver;

		// observer

		MUpnpResolverObserver& iObserver;

		// array of path elements

		RPointerArray<TPtrC8> iPathElements;	

		// session id of last send SOAP action

		TInt iSessionId; 	

		// original pathname

		HBufC8* iPath;

		// last matched object id

		HBufC8* iLastId;

		// index of path elements, last checked

		TInt iPathIndex;	

		// index used to no get whole browse result

		TInt iStartIndex;			

};

#endif // C_CUPNPRESOLVEHANDLER_H