// Copyright (c) 2003-2009 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:
//

#ifndef __THTTPDATACOMPOSER_H__
#define __THTTPDATACOMPOSER_H__

#include <e32std.h>

class MHttpBufferSupplier;


class THttpDataComposer
/**	
	The THttpDataComposer class allows tokens to be added to a data buffer.
	A token can be followed by a specified delimiter. The data buffer can be
	released at any time, allowing a fresh set of data to composed. Resetting
	the composer results in the data buffer being deleted.

	An MHttpBufferSupplier object owns the data buffer into which the tokens
	are placed. If there is not enough space for the tokens, the data composer
	asks the buffer supplier to resize the buffer to at least the required size.
	@internalComponent
	@see		MHttpBufferSupplier
*/
	{
public:	// enums

	enum TDelimiterType
/**	
	The TDelimiterType enumeration defines the types of delimiter that can be 
	specified to follow a token.
	
*/
		{
		/**	Specifies that no delimiter should follow.
		*/
		ENone		=0,

		/**	The token should be followed by a Space character.
		*/
		ESpace,

		/** The token should be followed by a Colon and then a Space character.
		*/
		EColonSpace,

		/** The token should be followed by a Carriage Return and then a Line
			Feed character.
		*/
		ECRLF
		};

public:	// methods

	THttpDataComposer(MHttpBufferSupplier& aBufferSupplier);

	void AddTokenL(const TDesC8& aToken, TDelimiterType aDelimiter);
	void Release();
	void Reset();

private:	// attributes

	MHttpBufferSupplier&	iBufferSupplier;
	TPtr8					iBuffer;
	TInt					iRequiredLength;

	};

#endif	// __THTTPDATACOMPOSER_H__