applayerprotocols/httptransportfw/httpmessage/thttpdatacomposer.h
changeset 0 b16258d2340f
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/applayerprotocols/httptransportfw/httpmessage/thttpdatacomposer.h	Tue Feb 02 01:09:52 2010 +0200
@@ -0,0 +1,81 @@
+// 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__