--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/applayerprotocols/httptransportfw/httpmessage/thttpdataparser.h	Tue Feb 02 01:09:52 2010 +0200
@@ -0,0 +1,156 @@
+// 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 __THTTPDATAPARSER_H__
+#define __THTTPDATAPARSER_H__
+
+#include <e32std.h>
+
+class MHttpBufferSupplier;
+
+class THttpDataParser 
+/**
+	The THttpDataParser provides the functionality to parse a data buffer for
+	lines, as specified in RFC2616. This states in section 2.2 that the end of
+	line marker for all protocol elements (except the entity body) as the 
+	sequence CR LF.
+
+	Parsed lines are copied into a buffer supplied by an MHttpBufferSupplier
+	object. If there is not enough space for the line date, the data parser
+	asks the buffer supplier to resize the buffer to at least the required size.
+
+	When parsing a header field line values can be folded onto multiple lines
+	if the continuation line begins with one or more SPs or HTs. This is known
+	as LWS and can be replaced by a single SP without changing any of the 
+	semantics.
+
+	Also, some tolerence has been built-in for robustness. The data parser can
+	parse for lines were the end of line marker is just a LF - the leading CR
+	has been omitted. This tolerance is suggested in section 19.4 of RFC2616.
+	There is also tolerence to spurios CRs in the data.
+	@internalComponent
+	@see		MHttpBufferSupplier
+*/
+	{
+public:	// enums
+
+	enum TParseResult
+/**	
+	The TParseResult enumeration defines the possible result of a specified data
+	parsing request.
+*/
+		{
+		/** The requested parse for a line was successful.
+		*/
+		ELineParsed			=0,
+
+		/** The requested parse was not successful due to a lack of data.
+		*/
+		EPartialData,
+
+		/** The requested parse for an empty line was successful.
+		*/
+		EEmptyLine,
+
+		/** The requested parse for the specified data chunk was successful.
+		*/
+		EGotData
+		};
+
+public:	// methods
+
+	THttpDataParser(MHttpBufferSupplier& aBufferSupplier);
+
+	TParseResult GetLineL(TPtrC8& aLine);
+	TParseResult GetHeaderLineL(TPtrC8& aLine);
+	TParseResult GetData(TPtrC8& aData, TInt aMaxSize);
+
+	void SetData(const TDesC8& aData);
+	void UnparsedData(TPtrC8& aData);
+
+	void Reset();
+
+private:	// enums
+
+	enum TDataParserState
+/**	
+	The TDataParserState enumeration defines the state machine for the data 
+	parser when performing a requested line parse. This can be either a standard
+	line or a header value line.
+*/
+		{
+		/**	The data parser is idle. It ready to parse for another line or for
+			a data chunk.
+		*/
+		EIdle				= 0,
+
+		/**	The data parser has not found the start of a CRLF. More data is
+			required.
+		*/
+		EPendingMoreData,
+
+		/** The data parser has found a CR. The LF is the next expected character.
+		*/
+		EPendingLF,
+
+		/**	The data parser has found a CR at the start of its data buffer. This
+			indicates that an empty line has been found. The LF is the next
+			expected character.
+		*/
+		EPendingEmptyLine,
+
+		/**	The LF of non-empty line has been found. The next expected character
+			should not be a SP or a HT which would otherwise indicate LWS 
+			when searching for a header line. In the case of a standard line any
+			character is expected.
+		*/
+		EPendingFoundLine
+		};
+
+
+	enum TLineType
+/**	
+	The TLineType enumeration defines the type of line that the data parser has
+	been requested to parse. There are two types - a standard line and a header
+	line. The difference is that a header line is delimited by a CRLF that is not
+	followed by one or more SPs or HTs.
+*/
+		{
+		/**	This specifies a standard line - delimited by a CRLF.
+		*/
+		EStandardLine		= 0,
+
+		/**	This specifies a header line - delimited by a CRLF that is not
+			followed by one or more SPs or HTs.
+		*/
+		EHeaderLine
+		};
+
+private:	// methods
+
+	void AppendToBufferL(const TDesC8& aData);
+	TParseResult GetLineL(TPtrC8& aLine, TLineType aLineType);
+	TInt FindEOLMarker(TChar& aEOLMarker);
+
+private:	// attributes
+
+	MHttpBufferSupplier&	iBufferSupplier;
+	TDataParserState		iState;
+	TPtrC8					iData;
+	TPtr8					iLineBuffer;
+
+	};
+
+#endif	// __THTTPDATAPARSER_H__