sl@0: // Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // The definitions of the transition classes upon the CComponentTester class methods.
sl@0: // 
sl@0: //
sl@0: 
sl@0: #ifndef __COMPONENTTESTERTRANSITIONVALIDATION_H__
sl@0: #define __COMPONENTTESTERTRANSITIONVALIDATION_H__
sl@0: 
sl@0: #include "ComponentTesterTransitions.h"
sl@0: 
sl@0: // ______________________________________________________________________________
sl@0: //
sl@0: /**
sl@0: 	@internalComponent
sl@0: 
sl@0: 	Comments : Provide all the CtorUnit Test's specific
sl@0: 	validatation for the state of a transition before and after its execution.
sl@0: 	on the CComponentTester test class for a transition.
sl@0:  */
sl@0: class TComponentTester_Ctor_TransitionValidator : public TTransitionValidator
sl@0: 	{
sl@0: public:
sl@0: 	/**
sl@0: 		@fn				TComponentTester_Ctor_TransitionValidator(CUnitTestContext& aUTContext)
sl@0: 		Intended Usage	:	
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			7.0
sl@0: 		@param			aUTContext The context within which this transition is executing
sl@0: 	 */
sl@0: 	inline TComponentTester_Ctor_TransitionValidator(CUnitTestContext& aUTContext);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePreConditions()
sl@0: 		Intended Usage	: Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 		Error Condition	: Invalid pre-conditions
sl@0: 		@since			7.0
sl@0: 		@return			TBool ETrue if the pre-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_Ctor_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePreConditions();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePostConditions(TTestBedAsyncState aAsyncState)
sl@0: 		Intended Usage	:	Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 						When overriding, if the transition calls an asynchronous function
sl@0: 						ValidatePostConditions will be called twice. Firstly, after the
sl@0: 						asynchronous function has been called and, secondly, after the 
sl@0: 						asynchronous request has completed. The parameter aAsyncState can
sl@0: 						be used to distinguish between these two cases.
sl@0: 		Error Condition	: Invalid post-conditions.
sl@0: 		@since			7.0
sl@0: 		@param			aAsyncState EAsyncCalled if the async function has been just been called,
sl@0: 						EAsyncCompleted if the function has completed.
sl@0: 		@return			TBool ETrue if the post-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_Ctor_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState);
sl@0: 	};	// TComponentTester_Ctor_TransitionValidator
sl@0: 
sl@0: // ______________________________________________________________________________
sl@0: //
sl@0: /**
sl@0: 	@internalComponent
sl@0: 
sl@0: 	Comments : Provide all the DtorUnit Test's specific
sl@0: 	validatation for the state of a transition before and after its execution.
sl@0: 	on the CComponentTester test class for a transition.
sl@0:  */
sl@0: class TComponentTester_Dtor_TransitionValidator : public TTransitionValidator
sl@0: 	{
sl@0: public:
sl@0: 	/**
sl@0: 		@fn				TComponentTester_Dtor_TransitionValidator(CUnitTestContext& aUTContext)
sl@0: 		Intended Usage	:	
sl@0: 		@leave			KErrNoMemory
sl@0: 		@since			7.0
sl@0: 		@param			aUTContext The context within which this transition is executing
sl@0: 	 */
sl@0: 	inline TComponentTester_Dtor_TransitionValidator(CUnitTestContext& aUTContext);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePreConditions()
sl@0: 		Intended Usage	: Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 		Error Condition	: Invalid pre-conditions
sl@0: 		@since			7.0
sl@0: 		@return			TBool ETrue if the pre-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_Dtor_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePreConditions();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePostConditions(TTestBedAsyncState aAsyncState)
sl@0: 		Intended Usage	:	Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 						When overriding, if the transition calls an asynchronous function
sl@0: 						ValidatePostConditions will be called twice. Firstly, after the
sl@0: 						asynchronous function has been called and, secondly, after the 
sl@0: 						asynchronous request has completed. The parameter aAsyncState can
sl@0: 						be used to distinguish between these two cases.
sl@0: 		Error Condition	: Invalid post-conditions.
sl@0: 		@since			7.0
sl@0: 		@param			aAsyncState EAsyncCalled if the async function has been just been called,
sl@0: 						EAsyncCompleted if the function has completed.
sl@0: 		@return			TBool ETrue if the post-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_Dtor_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState);
sl@0: 	};	// TComponentTester_Dtor_TransitionValidator
sl@0: 
sl@0: // ______________________________________________________________________________
sl@0: //
sl@0: /**
sl@0: 	@internalComponent
sl@0: 
sl@0: 	Comments : Provide all the TransitionSetsUnit Test's specific
sl@0: 	validatation for the state of a transition before and after its execution.
sl@0: 	on the CComponentTester test class for a transition.
sl@0:  */
sl@0: class TComponentTester_TransitionSets_TransitionValidator : public TTransitionValidator
sl@0: 	{
sl@0: public:
sl@0: 	/**
sl@0: 		@fn				TComponentTester_TransitionSets_TransitionValidator(CUnitTestContext& aUTContext)
sl@0: 		Intended Usage	:	
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			7.0
sl@0: 		@param			aUTContext The context within which this transition is executing
sl@0: 	 */
sl@0: 	inline TComponentTester_TransitionSets_TransitionValidator(CUnitTestContext& aUTContext);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePreConditions()
sl@0: 		Intended Usage	: Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 		Error Condition	: Invalid pre-conditions
sl@0: 		@since			7.0
sl@0: 		@return			TBool ETrue if the pre-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_TransitionSet_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePreConditions();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePostConditions(TTestBedAsyncState aAsyncState)
sl@0: 		Intended Usage	:	Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 						When overriding, if the transition calls an asynchronous function
sl@0: 						ValidatePostConditions will be called twice. Firstly, after the
sl@0: 						asynchronous function has been called and, secondly, after the 
sl@0: 						asynchronous request has completed. The parameter aAsyncState can
sl@0: 						be used to distinguish between these two cases.
sl@0: 		Error Condition	: Invalid post-conditions.
sl@0: 		@since			7.0
sl@0: 		@param			aAsyncState EAsyncCalled if the async function has been just been called,
sl@0: 						EAsyncCompleted if the function has completed.
sl@0: 		@return			TBool ETrue if the post-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_TransitionSet_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState);
sl@0: 	};	// TComponentTester_TransitionSets_TransitionValidator
sl@0: 
sl@0: // ______________________________________________________________________________
sl@0: //
sl@0: /**
sl@0: 	@internalComponent
sl@0: 
sl@0: 	Comments : Provide all the AddUnitTestUnit Test's specific
sl@0: 	validatation for the state of a transition before and after its execution.
sl@0: 	on the CComponentTester test class for a transition.
sl@0:  */
sl@0: class TComponentTester_AddUnitTest_TransitionValidator : public TTransitionValidator
sl@0: 	{
sl@0: public:
sl@0: 	/**
sl@0: 		@fn				TComponentTester_AddUnitTest_TransitionValidator(CUnitTestContext& aUTContext)
sl@0: 		Intended Usage	:	
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			7.0
sl@0: 		@param			aUTContext The context within which this transition is executing
sl@0: 	 */
sl@0: 	inline TComponentTester_AddUnitTest_TransitionValidator(CUnitTestContext& aUTContext);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePreConditions()
sl@0: 		Intended Usage	: Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 		Error Condition	: Invalid pre-conditions
sl@0: 		@since			7.0
sl@0: 		@return			TBool ETrue if the pre-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_AddUnitTest_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePreConditions();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePostConditions(TTestBedAsyncState aAsyncState)
sl@0: 		Intended Usage	:	Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 						When overriding, if the transition calls an asynchronous function
sl@0: 						ValidatePostConditions will be called twice. Firstly, after the
sl@0: 						asynchronous function has been called and, secondly, after the 
sl@0: 						asynchronous request has completed. The parameter aAsyncState can
sl@0: 						be used to distinguish between these two cases.
sl@0: 		Error Condition	: Invalid post-conditions.
sl@0: 		@since			7.0
sl@0: 		@param			aAsyncState EAsyncCalled if the async function has been just been called,
sl@0: 						EAsyncCompleted if the function has completed.
sl@0: 		@return			TBool ETrue if the post-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_AddUnitTest_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState);
sl@0: 	};	// TComponentTester_AddUnitTest_TransitionValidator
sl@0: 
sl@0: // ______________________________________________________________________________
sl@0: //
sl@0: /**
sl@0: 	@internalComponent
sl@0: 
sl@0: 	Comments : Provide all the AddParamUnitTestUnit Test's specific
sl@0: 	validatation for the state of a transition before and after its execution.
sl@0: 	on the CComponentTester test class for a transition.
sl@0:  */
sl@0: class TComponentTester_AddParamUnitTest_TransitionValidator : public TTransitionValidator
sl@0: 	{
sl@0: public:
sl@0: 	/**
sl@0: 		@fn				TComponentTester_AddParamUnitTest_TransitionValidator(CUnitTestContext& aUTContext)
sl@0: 		Intended Usage	:	
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			7.0
sl@0: 		@param			aUTContext The context within which this transition is executing
sl@0: 	 */
sl@0: 	inline TComponentTester_AddParamUnitTest_TransitionValidator(CUnitTestContext& aUTContext);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePreConditions()
sl@0: 		Intended Usage	: Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 		Error Condition	: Invalid pre-conditions
sl@0: 		@since			7.0
sl@0: 		@return			TBool ETrue if the pre-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_AddParamUnitTest_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePreConditions();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePostConditions(TTestBedAsyncState aAsyncState)
sl@0: 		Intended Usage	:	Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 						When overriding, if the transition calls an asynchronous function
sl@0: 						ValidatePostConditions will be called twice. Firstly, after the
sl@0: 						asynchronous function has been called and, secondly, after the 
sl@0: 						asynchronous request has completed. The parameter aAsyncState can
sl@0: 						be used to distinguish between these two cases.
sl@0: 		Error Condition	: Invalid post-conditions.
sl@0: 		@since			7.0
sl@0: 		@param			aAsyncState EAsyncCalled if the async function has been just been called,
sl@0: 						EAsyncCompleted if the function has completed.
sl@0: 		@return			TBool ETrue if the post-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_AddParamUnitTest_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState);
sl@0: 	};	// TComponentTester_AddParamUnitTest_TransitionValidator
sl@0: 
sl@0: // ______________________________________________________________________________
sl@0: //
sl@0: /**
sl@0: 	@internalComponent
sl@0: 	
sl@0: 	Comments : Provide all the TestComponentUnit Test's specific
sl@0: 	validatation for the state of a transition before and after its execution.
sl@0: 	on the CComponentTester test class for a transition.
sl@0:  */
sl@0: class TComponentTester_TestComponent_TransitionValidator : public TTransitionValidator
sl@0: 	{
sl@0: public:
sl@0: 	/**
sl@0: 		@fn				TComponentTester_TestComponent_TransitionValidator(CUnitTestContext& aUTContext)
sl@0: 		Intended Usage	:	
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			7.0
sl@0: 		@param			aUTContext The context within which this transition is executing
sl@0: 	 */
sl@0: 	inline TComponentTester_TestComponent_TransitionValidator(CUnitTestContext& aUTContext);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePreConditions()
sl@0: 		Intended Usage	: Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 		Error Condition	: Invalid pre-conditions
sl@0: 		@since			7.0
sl@0: 		@return			TBool ETrue if the pre-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_TestComponent_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePreConditions();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePostConditions(TTestBedAsyncState aAsyncState)
sl@0: 		Intended Usage	:	Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 						When overriding, if the transition calls an asynchronous function
sl@0: 						ValidatePostConditions will be called twice. Firstly, after the
sl@0: 						asynchronous function has been called and, secondly, after the 
sl@0: 						asynchronous request has completed. The parameter aAsyncState can
sl@0: 						be used to distinguish between these two cases.
sl@0: 		Error Condition	: Invalid post-conditions.
sl@0: 		@since			7.0
sl@0: 		@param			aAsyncState EAsyncCalled if the async function has been just been called,
sl@0: 						EAsyncCompleted if the function has completed.
sl@0: 		@return			TBool ETrue if the post-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_TestComponent_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState);
sl@0: 	};	// TComponentTester_TestComponent_TransitionValidator
sl@0: 
sl@0: // ______________________________________________________________________________
sl@0: //
sl@0: /**
sl@0: 	@internalComponent
sl@0: 
sl@0: 	Comments : Provide all the RunUnit Test's specific
sl@0: 	validatation for the state of a transition before and after its execution.
sl@0: 	on the CComponentTester test class for a transition.
sl@0:  */
sl@0: class TComponentTester_Run_TransitionValidator : public TTransitionValidator
sl@0: 	{
sl@0: public:
sl@0: 	/**
sl@0: 		@fn				TComponentTester_Run_TransitionValidator(CUnitTestContext& aUTContext)
sl@0: 		Intended Usage	:	
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			7.0
sl@0: 		@param			aUTContext The context within which this transition is executing
sl@0: 	 */
sl@0: 	inline TComponentTester_Run_TransitionValidator(CUnitTestContext& aUTContext);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePreConditions()
sl@0: 		Intended Usage	: Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 		Error Condition	: Invalid pre-conditions
sl@0: 		@since			7.0
sl@0: 		@return			TBool ETrue if the pre-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_Run_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePreConditions();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePostConditions(TTestBedAsyncState aAsyncState)
sl@0: 		Intended Usage	:	Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 						When overriding, if the transition calls an asynchronous function
sl@0: 						ValidatePostConditions will be called twice. Firstly, after the
sl@0: 						asynchronous function has been called and, secondly, after the 
sl@0: 						asynchronous request has completed. The parameter aAsyncState can
sl@0: 						be used to distinguish between these two cases.
sl@0: 		Error Condition	: Invalid post-conditions.
sl@0: 		@since			7.0
sl@0: 		@param			aAsyncState EAsyncCalled if the async function has been just been called,
sl@0: 						EAsyncCompleted if the function has completed.
sl@0: 		@return			TBool ETrue if the post-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_Run_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState);
sl@0: 	};	// TComponentTester_Run_TransitionValidator
sl@0: 
sl@0: // ______________________________________________________________________________
sl@0: //
sl@0: /**
sl@0: 	@internalComponent
sl@0: 
sl@0: 	Comments : Provide all the CompleteUnit Test's specific
sl@0: 	validatation for the state of a transition before and after its execution.
sl@0: 	on the CComponentTester test class for a transition.
sl@0:  */
sl@0: class TComponentTester_Complete_TransitionValidator : public TTransitionValidator
sl@0: 	{
sl@0: public:
sl@0: 	/**
sl@0: 		@fn				TComponentTester_Complete_TransitionValidator(CUnitTestContext& aUTContext)
sl@0: 		Intended Usage	: Default contructor.
sl@0: 		@leave  		KErrNoMemory
sl@0: 		@since			7.0
sl@0: 		@param			aUTContext The context within which this transition is executing
sl@0: 	 */
sl@0: 	inline TComponentTester_Complete_TransitionValidator(CUnitTestContext& aUTContext);
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePreConditions()
sl@0: 		Intended Usage	: Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 		Error Condition	: Invalid pre-conditions
sl@0: 		@since			7.0
sl@0: 		@return			TBool ETrue if the pre-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_Complete_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePreConditions();
sl@0: 
sl@0: 	/**
sl@0: 		@fn				ValidatePostConditions(TTestBedAsyncState aAsyncState)
sl@0: 		Intended Usage	:	Implemented by the developer to check the
sl@0: 						end state of the transition behaviour.
sl@0: 						When overriding, if the transition calls an asynchronous function
sl@0: 						ValidatePostConditions will be called twice. Firstly, after the
sl@0: 						asynchronous function has been called and, secondly, after the 
sl@0: 						asynchronous request has completed. The parameter aAsyncState can
sl@0: 						be used to distinguish between these two cases.
sl@0: 		Error Condition	: Invalid post-conditions.
sl@0: 		@since			7.0
sl@0: 		@param			aAsyncState EAsyncCalled if the async function has been just been called,
sl@0: 						EAsyncCompleted if the function has completed.
sl@0: 		@return			TBool ETrue if the post-conditions were valid, EFalse otherwise.
sl@0: 		@pre 			TComponentTester_Complete_TransitionValidator is fully constructed.
sl@0: 		@post			No change to the iUTContext class.
sl@0: 	*/
sl@0: 	virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState);
sl@0: 	};	// TComponentTester_Complete_TransitionValidator
sl@0: 
sl@0: 
sl@0: #include "ComponentTesterTransitionValidation.inl"
sl@0: 
sl@0: #endif // __COMPONENTTESTERTRANSITIONVALIDATION_H__
sl@0: