applayerprotocols/httptransportfw/Test/T_HttpPipeliningTest/CPipeliningTestCase.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 11 May 2010 16:43:01 +0300
branchRCL_3
changeset 11 8f055b80aa5b
parent 0 b16258d2340f
permissions -rw-r--r--
Revision: 201017 Kit: 201019

// 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 __CPIPELININGTESTCASE_H__
#define __CPIPELININGTESTCASE_H__

#include <e32base.h>
#include <http.h>

#include "MPipeliningTestCase.h"

/*
The CPipeliningTestCase is a simple class to inherit from MPipeliningTestCase to provide
default implementations for some of the functions required by MPipeliningTestCase. Many
methods in this class are sometimes not really required so this is class has been
introduced to provide some default implementations. All these methods are virtual so that
any of them can be overriden with new implementations.
*/
class CPipeliningTestCase : public CBase,
							public MPipeliningTestCase
	{
public:	
	~CPipeliningTestCase();
	
	

	/*
	This method should return the number of transactions on a giving connection index. Most
	test will only require a single connection so this method should return the same value 
	as MPipeliningTestCase::TotalTransactionCount() so this method will simply call that.
	*/
	virtual TInt TransactionCount(TInt aConnectionIndex) const;

	/*
	This method allows the test case to set an option into how the transactions are
	submitted. If this method returns ETrue, the transaction will be batched where they are
	all opened first and then submitted all together, or else return EFalse so transactions
	are submitted as they are opened. Most test cases will require that transaction are
	batched so the default implementation is to return ETrue.
	*/
	virtual TBool BatchTransactions() const;

	/*
	When the client receives a transaction event, the error code can be checked to verify
	what (if any) error code is expected. The transaction is supplied so that the test case
	can identify the transaction by Id(). Most test cases will not expect an error code so
	the default implementation is to simply return KErrNone.
	*/
	virtual TInt ExpectedError(RHTTPTransaction aTrans);

	/*
	This method should return the number of connections that is expected to open with the
	test server in the test case. If the test server is not being used (ie. transactions are
	going to 'real' servers) then this should return 0. For simplicity, the default
	implementation is to return 0.
	*/
	virtual TInt ConnectionCount() const;
	
	/*
	This method should return the number of expected connections opened with real servers. 
	This information is stored by the protocol handler in debug mode only and checked.
	
	When using the test server this should return the same as ConnectionCount()
	*/
	TInt RealExpectedConnectionCount() const;

	/*
	This method will indicate whether to enable batching (request buffering). Most pipelining
	test cases do not require batching to be enabled so the default implementation is to return
	EFalse.
	*/
	virtual TBool EnableBatching() const;
	
	void ProcessHeadersL(RHTTPTransaction aTrans);
	
	virtual TBool TransportHandlerPriority() const;

	
protected:
	CPipeliningTestCase();

	};
	
#endif // __CPIPELININGTESTCASE_H__