/** @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:  Describe a path element
*
*/


#ifndef C_CUPNPPATHELEMENT_H
#define C_CUPNPPATHELEMENT_H

//  INCLUDES
#include <e32base.h>

// CLASS DECLARATION
/**
*  Describe a path element
*
*  @since Series 60 3.1
*/
class CUpnpPathElement: public CBase
	{
	public:  // Constructors and destructor        
		/**
		* Two-phased constructor.
		*/
		static CUpnpPathElement* NewL();        
		/**
		* Destructor.
		*/
		virtual ~CUpnpPathElement();

	public: // New functions     
		/**
	    * Get value of parent id
	    * @since Series 60 3.1
	    * @return parent id
	    */      	   
		const TDesC8& ParentId() const;   
		/**
	    * Set value of parent id
	    * @since Series 60 3.1
	    * @param aParentId new value of parent id
	    */		             
		void SetParentIdL(const TDesC8& aParentId);
		/**
	    * Get value of id
	    * @since Series 60 3.1
	    * @return id value
	    */   		
		const TDesC8& Id() const;  
		/**
	    * Set value of id
	    * @since Series 60 3.1
	    * @param aId new value of id
	    */				      
		void SetIdL(const TDesC8& aId);
		/**
	    * Get value of name
	    * @since Series 60 3.1
	    * @return name
	    */   		
		const TDesC8& Name() const;   
		/**
	    * Set value of name
	    * @since Series 60 3.1
	    * @param aName new value of name
	    */			             
		void SetNameL(const TDesC8& aName);        
		
		/**
	    * Get value of ImportURI
	    * @since Series 60 3.2
	    * @return ImportURI
	    */      	   
		const TDesC8& ImportURI() const;   
		/**
	    * Set value of ImportURI
	    * @since Series 60 3.2
	    * @param aImportURI a new value of importURI
	    */		             
		void SetImportURIL(const TDesC8& aImportURI);        		
		
		/**
	    * Get value of original name
	    * @since Series 60 3.2
	    * @return OriginalName
	    */      	   
		const TDesC8& OriginalName() const; 
		  
		/**
	    * Set value of original name
	    * @since Series 60 3.2
	    * @param aIOriginalName a new value of original name
	    */		             
		void SetOriginalNameL(const TDesC8& aOriginalName);    
		
		/**
	    * Deletes value of original name
	    * @since Series 60 3.2	   
	    */		             
		void DeleteOriginalName();    
		
		/**
		Compares if two path elements have the same name and parent id.
		@param aFirst First message to compare.
		@param aSecond Second message to compare.
		@result ETrue if same session id, EFalse otherwise.
		**/
		static TBool MatchName(const CUpnpPathElement& aElement1, 
                            const CUpnpPathElement& aElement2);        
		/**
		Compares if two path elements have the same name, id and parent id.
		@param aFirst First message to compare.
		@param aSecond Second message to compare.
		@result ETrue if same session id, EFalse otherwise.
		**/                            
		static TBool MatchAll(const CUpnpPathElement& aElement1, 
                            const CUpnpPathElement& aElement2);                              

	private:
		/**
		* C++ default constructor.
		*/
		CUpnpPathElement();

		/**
		* Symbian 2nd phase constructor
		*/
		void ConstructL();
        
	private:
		// id attrbute of UPnP object
		HBufC8* iId;
		// parent id attrbute of UPnP object
		HBufC8* iParentId;
		// name path element, name is taken from title element, 
		// but if duplication occurs, name is followed by index string
		HBufC8* iName;   
		//hidden import URI
		HBufC8* iImportURI;
		//original name if change by creating resource   	
		HBufC8* iOriginalName;
	};

#endif      // C_CUPNPPATHELEMENT_H   
            
// End of File