/*
* Copyright (c) 2009-2010 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:
* MSRP Implementation
*
*/

#ifndef CMSRPMESSAGEIDHEADER_H
#define CMSRPMESSAGEIDHEADER_H

//  INCLUDES
#include "CMsrpHeaderBase.h"

// CLASS DECLARATION
/**
* @publishedAll
*
* Class provides functions for setting and getting MSRP "Message-ID" header field
*
* @lib msrpclient.lib
*/
class CMSRPMessageIdHeader : public CMSRPHeaderBase
	{
	public:	// Constructors and destructor

		/**
		* Creates a new instance of CMSRMessageIdHeader
		* @param aMessageId unique message identifier
		* @return a new instance of CMSRPMessageIdHeader
		*/
		IMPORT_C static CMSRPMessageIdHeader* NewL( const TDesC8& aMessageId );

		/**
		* Creates a new instance of CMSRPMessageIdHeader and puts it to CleanupStack
		* @param aMessageId unique message identifier
		* @return a new instance of CMSRPMessageIdHeader
		*/
		IMPORT_C static CMSRPMessageIdHeader* NewLC( const TDesC8& aMessageId );

		/**
		* Creates a new instance of CMSRMessageIdHeader
		* @return a new instance of CMSRPMessageIdHeader
		*/
		static CMSRPMessageIdHeader* NewL( );

		/**
		* Destructor, deletes the resources of CMSRPMessageIdHeader.
		*/
		IMPORT_C ~CMSRPMessageIdHeader();

	public: // New functions

		/**
		* Constructs an instance of a CMSRPMessageIdHeader from a RReadStream
		* @param aReadStream a stream containing the value of the
		*        externalized object (header name not included).
		* @return an instance of a CMSRPMessageIdHeader
		*/
		IMPORT_C static CMSRPMessageIdHeader*
			InternalizeValueL( RReadStream& aReadStream );

	public: // From CMSRPHeaderBase

		IMPORT_C void ExternalizeValueL( RWriteStream& aWriteStream ) const;

	protected: // From CMSRPHeaderBase

		RStringF Name() const;
		HBufC8* ToTextValueL() const;

	private: // Constructors

	    /**
	     * Constructor.
	     */
		CMSRPMessageIdHeader();

	    /**
	     * Two-phased constructor.
		 * @param aMessageId unique message identifier
	     */
        void ConstructL( const TDesC8& aMessageId );

	    /**
	     * Two-phased constructor.
	     */
        void ConstructL( );

	private: // new functions

	    /**
		* Internalize external object data
		* @param aReadStream a stream containing the value of the
		*        externalized object (header name not included).
		*/
		void DoInternalizeValueL( RReadStream& aReadStream );

  	private: // variables

		// value as a string
		HBufC8* iIdValue;

	};

#endif // CMSRPMESSAGEIDHEADER_H

// End of File