// 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();

	}