--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/applayerprotocols/httpexamples/header_examples.cpp	Tue Feb 02 01:09:52 2010 +0200
@@ -0,0 +1,120 @@
+// Copyright (c) 2001-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:
+//
+
+#include <http.h>
+
+// eg.s of Header usage.
+//
+
+// Throughout:  iStrTb is a handle to the HTTP string table;
+//  i.e.   RStringPool iStrTb;
+//
+// Strings are represented as handles to HTTP strings;
+//  i.e.   RStringF str;
+//
+// String table lookup (i.e. getting the string handle from some descriptor) is done as so:
+//
+//  RStringF str = iStrTb.OpenFStringL(_L8("my string"));
+//
+// Strings which are 'very well known' (e.g. those in the HTTP RFC) and therefore certainly expected to be in ROM
+// can be converted to HTTP string handles using enumerations:
+//
+//  RStringF str = iStrTb.String(HTTP::EAccept,RHTTPSession::GetTable()); // guaranteed to give the same handle as:
+//  RHttpString str = iStrTb.OpenFStringL(_L8("KHttpAccept"));
+
+
+
+// 1. Client API creation of simple headers
+//	  
+//    Accept: text/html
+//	  Expires: Mon, 15 Jan 2001 10:30:25 GMT
+//	  Location: http://www.symbian.com/
+//	  Max-Forwards: 3
+//
+void Example1(RHTTPRequest aReq)
+	{
+	RHTTPHeaders hdr = aReq.GetHeaderCollection();
+
+	RStringF textHtml = iStrTb.OpenFStringL(_L8("text/html"));
+	THTTPHdrVal accVal(textHtml);
+	hdr.SetFieldL(iStrTb.String(HTTP::EAccept,RHTTPSession::GetTable()), accVal);
+	textHtml.Close();
+
+	TDateTime dateVal(2001, EJanuary, 14, 10, 30, 25, 0);
+	THTTPHdrVal expVal(dateVal);
+	hdr.SetFieldL(iStrTb.String(HTTP::EExpires,RHTTPSession::GetTable()), expVal);
+
+	RStringF symbUrl = iStrTb.OpenFStringL(_L8("http://www.symbian.com/"));
+	THTTPHdrVal locVal(symbUrl);
+	hdr.SetFieldL(iStrTb.String(HTTP::ELocation,RHTTPSession::GetTable()), locVal);
+	symbUrl.Close();
+
+	THTTPHdrVal maxFwdsVal(3);
+	hdr.SetFieldL(iStrTb.String(HTTP::EMaxForwards,RHTTPSession::GetTable()), maxFwdsVal);
+	}
+
+
+// 2. Client API creation of headers with several parts
+//
+//	  Accept-Charset: us-ascii, utf-8
+//	  Accept-Language: en-gb. fr
+//
+void Example2(RHTTPRequest aReq)
+	{
+	RHTTPHeaders hdr = aReq.GetHeaderCollection();
+
+	RStringF usAscii = iStrTb.OpenFStringL(_L8("us-ascii"));
+	RStringF utf8    = iStrTb.OpenFStringL(_L8("utf-8"));
+	THTTPHdrVal accChSetVal(usAscii);
+	hdr.SetFieldL(iStrTb.String(HTTP::EAcceptCharset,RHTTPSession::GetTable()), accChSetVal); // sets the first part
+	accChSetVal.SetStrutf8);
+	hdr.SetFieldL(iStrTb.String(HTTP::EAcceptCharset,RHTTPSession::GetTable()), accChSetVal); // adds an additional part
+	usAscii.Close();
+	utf8.Close();
+
+	RStringF enGb = iStrTb.OpenFStringL(_L8("en-gb"));
+	RStringF fr   = iStrTb.OpenFStringL(_L8("fr"));
+	THTTPHdrVal accLangVal(enGb);
+	hdr.SetFieldL(iStrTb.String(HTTP::EAcceptLanguage,RHTTPSession::GetTable()), accLangVal);
+	accLangVal.SetStrfr);
+	hdr.SetFieldL(iStrTb.String(HTTP::EAcceptLanguage,RHTTPSession::GetTable()), accLangVal);
+	enGb.Close();
+	fr.Close();
+	}
+
+
+// 3. Client API creation of headers with parameters
+//
+//	  Accept: text/html; q=0.8, text/plain; q=0.2, */*
+//
+void Example3(RHTTPRequest aReq)
+	{
+	RHTTPHeaders hdr = aReq.GetHeaderCollection();
+
+	RStringF textHtml  = iStrTb.OpenFStringL(_L8("text/html"));
+	RStringF textPlain = iStrTb.OpenFStringL(_L8("text/plain"));
+	RStringF anyAny	  = iStrTb.OpenFStringL(_L8("*/*"));
+	THTTPHdrVal accVal(textHtml);
+	THTTPHdrVal q(THTTPHdrVal::TQConv(0.8));
+	hdr.SetFieldL(iStrTb.String(HTTP::EAccept,RHTTPSession::GetTable()), accVal, iStrTb.String(HTTP::EQ,RHTTPSession::GetTable()), q);
+	accVal.SetStrtextPlain);
+	q.SetInt(THTTPHdrVal::TQConv(0.2));
+	hdr.SetFieldL(iStrTb.String(HTTP::EAccept,RHTTPSession::GetTable()), accVal, iStrTb.String(HTTP::EQ,RHTTPSession::GetTable()), q);
+	accVal.SetStranyAny);
+	hdr.SetFieldL(iStrTb.String(HTTP::EAccept,RHTTPSession::GetTable()), accVal);
+	textHtml.Close();
+	textPlain.Close();
+	anyAny.Close();
+	}