diff -r 000000000000 -r bde4ae8d615e os/ossrv/lowlevellibsandfws/pluginfw/Test_Bed/TestControllerTest/TestControllerTransitionValidation.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/os/ossrv/lowlevellibsandfws/pluginfw/Test_Bed/TestControllerTest/TestControllerTransitionValidation.h Fri Jun 15 03:10:57 2012 +0200 @@ -0,0 +1,398 @@ +// Copyright (c) 1997-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: +// The definitions of the transition classes upon the CTestController class methods. +// +// + +#ifndef __TESTCONTROLLERTRANSITIONVALIDATION_H__ +#define __TESTCONTROLLERTRANSITIONVALIDATION_H__ + +#include "TestControllerTransitions.h" + +// ______________________________________________________________________________ +// +/** + @internalComponent + + Comments : Provide all the CtorUnit Test's specific + validatation for the state of a transition before and after its execution. + on the CTestController test class for a transition. + */ +class TTestController_Ctor_TransitionValidator : public TTransitionValidator + { +public: + /** + @fn TTestController_Ctor_TransitionValidator(CUnitTestContext& aUTContext) + Intended Usage : Default constructor + @leave KErrNoMemory + @since 7.0 + @param aUTContext The context within which this transition is executing + */ + inline TTestController_Ctor_TransitionValidator(CUnitTestContext& aUTContext); + + /** + @fn ValidatePreConditions() + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + Error Condition : Invalid pre-conditions + @since 7.0 + @return TBool ETrue if the pre-conditions were valid, EFalse otherwise. + @pre TTestController_Ctor_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePreConditions(); + + /** + @fn ValidatePostConditions(TTestBedAsyncState aAsyncState) + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + When overriding, if the transition calls an asynchronous function + ValidatePostConditions will be called twice. Firstly, after the + asynchronous function has been called and, secondly, after the + asynchronous request has completed. The parameter aAsyncState can + be used to distinguish between these two cases. + Error Condition : Invalid post-conditions. + @since 7.0 + @param aAsyncState EAsyncCalled if the async function has been just been called, + EAsyncCompleted if the function has completed. + @return TBool ETrue if the post-conditions were valid, EFalse otherwise. + @pre TTestController_Ctor_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState); + }; // TTestController_Ctor_TransitionValidator + +// ______________________________________________________________________________ +// +/** + @internalComponent + + Comments : Provide all the DtorUnit Test's specific + validatation for the state of a transition before and after its execution. + on the CTestController test class for a transition. + */ +class TTestController_Dtor_TransitionValidator : public TTransitionValidator + { +public: + /** + @fn TTestController_Dtor_TransitionValidator(CUnitTestContext& aUTContext) + Intended Usage : + @leave KErrNoMemory + @since 7.0 + @param aUTContext The context within which this transition is executing + */ + inline TTestController_Dtor_TransitionValidator(CUnitTestContext& aUTContext); + + /** + @fn ValidatePreConditions() + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + Error Condition : Invalid pre-conditions + @since 7.0 + @return TBool ETrue if the pre-conditions were valid, EFalse otherwise. + @pre TTestController_Dtor_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePreConditions(); + + /** + @fn ValidatePostConditions(TTestBedAsyncState aAsyncState) + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + When overriding, if the transition calls an asynchronous function + ValidatePostConditions will be called twice. Firstly, after the + asynchronous function has been called and, secondly, after the + asynchronous request has completed. The parameter aAsyncState can + be used to distinguish between these two cases. + Error Condition : Invalid post-conditions. + @since 7.0 + @param aAsyncState EAsyncCalled if the async function has been just been called, + EAsyncCompleted if the function has completed. + @return TBool ETrue if the post-conditions were valid, EFalse otherwise. + @pre TTestController_Dtor_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState); + }; // TTestController_Dtor_TransitionValidator + +// ______________________________________________________________________________ +// +/** + @internalComponent + + Comments : Provide all the ScanDriveUnit Test's specific + validatation for the state of a transition before and after its execution. + on the CTestController test class for a transition. + */ +class TTestController_ScanDrive_TransitionValidator : public TTransitionValidator + { +public: + /** + @fn TTestController_ScanDrive_TransitionValidator(CUnitTestContext& aUTContext) + Intended Usage : + @leave KErrNoMemory + @since 7.0 + @param aUTContext The context within which this transition is executing + */ + inline TTestController_ScanDrive_TransitionValidator(CUnitTestContext& aUTContext); + + /** + @fn ValidatePreConditions() + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + Error Condition : Invalid pre-conditions + @since 7.0 + @return TBool ETrue if the pre-conditions were valid, EFalse otherwise. + @pre TTestController_ScanDrive_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePreConditions(); + + /** + @fn ValidatePostConditions(TTestBedAsyncState aAsyncState) + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + When overriding, if the transition calls an asynchronous function + ValidatePostConditions will be called twice. Firstly, after the + asynchronous function has been called and, secondly, after the + asynchronous request has completed. The parameter aAsyncState can + be used to distinguish between these two cases. + Error Condition : Invalid post-conditions. + @since 7.0 + @param aAsyncState EAsyncCalled if the async function has been just been called, + EAsyncCompleted if the function has completed. + @return TBool ETrue if the post-conditions were valid, EFalse otherwise. + @pre TTestController_ScanDrive_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState); + }; // TTestController_ScanDrive_TransitionValidator + +// ______________________________________________________________________________ +// +/** + @internalComponent + + Comments : Provide all the DiscoverTestsUnit Test's specific + validatation for the state of a transition before and after its execution. + on the CTestController test class for a transition. + */ +class TTestController_DiscoverTests_TransitionValidator : public TTransitionValidator + { +public: + /** + @fn TTestController_DiscoverTests_TransitionValidator(CUnitTestContext& aUTContext) + Intended Usage : + @leave KErrNoMemory + @since 7.0 + @param aUTContext The context within which this transition is executing + */ + inline TTestController_DiscoverTests_TransitionValidator(CUnitTestContext& aUTContext); + + /** + @fn ValidatePreConditions() + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + Error Condition : Invalid pre-conditions + @since 7.0 + @return TBool ETrue if the pre-conditions were valid, EFalse otherwise. + @pre TTestController_DiscoverTests_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePreConditions(); + + /** + @fn ValidatePostConditions(TTestBedAsyncState aAsyncState) + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + When overriding, if the transition calls an asynchronous function + ValidatePostConditions will be called twice. Firstly, after the + asynchronous function has been called and, secondly, after the + asynchronous request has completed. The parameter aAsyncState can + be used to distinguish between these two cases. + Error Condition : Invalid post-conditions. + @since 7.0 + @param aAsyncState EAsyncCalled if the async function has been just been called, + EAsyncCompleted if the function has completed. + @return TBool ETrue if the post-conditions were valid, EFalse otherwise. + @pre TTestController_DiscoverTests_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState); + }; // TTestController_DiscoverTests_TransitionValidator + +// ______________________________________________________________________________ +// +/** + @internalComponent + + Comments : Provide all the FindComponentsUnit Test's specific + validatation for the state of a transition before and after its execution. + on the CTestController test class for a transition. + */ +class TTestController_FindComponents_TransitionValidator : public TTransitionValidator + { +public: + /** + @fn TTestController_FindComponents_TransitionValidator(CUnitTestContext& aUTContext) + Intended Usage : + @leave KErrNoMemory + @since 7.0 + @param aUTContext The context within which this transition is executing + */ + inline TTestController_FindComponents_TransitionValidator(CUnitTestContext& aUTContext); + + /** + @fn ValidatePreConditions() + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + Error Condition : Invalid pre-conditions + @since 7.0 + @return TBool ETrue if the pre-conditions were valid, EFalse otherwise. + @pre TTestController_FindComponents_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePreConditions(); + + /** + @fn ValidatePostConditions(TTestBedAsyncState aAsyncState) + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + When overriding, if the transition calls an asynchronous function + ValidatePostConditions will be called twice. Firstly, after the + asynchronous function has been called and, secondly, after the + asynchronous request has completed. The parameter aAsyncState can + be used to distinguish between these two cases. + Error Condition : Invalid post-conditions. + @since 7.0 + @param aAsyncState EAsyncCalled if the async function has been just been called, + EAsyncCompleted if the function has completed. + @return TBool ETrue if the post-conditions were valid, EFalse otherwise. + @pre TTestController_FindComponents_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState); + }; // TTestController_FindComponents_TransitionValidator + +// ______________________________________________________________________________ +// +/** + @internalComponent + + Comments : Provide all the GetUnitTestsUnit Test's specific + validatation for the state of a transition before and after its execution. + on the CTestController test class for a transition. + */ +class TTestController_GetUnitTests_TransitionValidator : public TTransitionValidator + { +public: + /** + @fn TTestController_GetUnitTests_TransitionValidator(CUnitTestContext& aUTContext) + Intended Usage : + @leave KErrNoMemory + @since 7.0 + @param aUTContext The context within which this transition is executing + */ + inline TTestController_GetUnitTests_TransitionValidator(CUnitTestContext& aUTContext); + + /** + @fn ValidatePreConditions() + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + Error Condition : Invalid pre-conditions + @since 7.0 + @return TBool ETrue if the pre-conditions were valid, EFalse otherwise. + @pre TTestController_GetUnitTests_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePreConditions(); + + /** + @fn ValidatePostConditions(TTestBedAsyncState aAsyncState) + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + When overriding, if the transition calls an asynchronous function + ValidatePostConditions will be called twice. Firstly, after the + asynchronous function has been called and, secondly, after the + asynchronous request has completed. The parameter aAsyncState can + be used to distinguish between these two cases. + Error Condition : Invalid post-conditions. + @since 7.0 + @param aAsyncState EAsyncCalled if the async function has been just been called, + EAsyncCompleted if the function has completed. + @return TBool ETrue if the post-conditions were valid, EFalse otherwise. + @pre TTestController_GetUnitTests_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState); + }; // TTestController_GetUnitTests_TransitionValidator + +// ______________________________________________________________________________ +// +/** + @internalComponent + + Comments : Provide all the StartUnit Test's specific + validatation for the state of a transition before and after its execution. + on the CTestController test class for a transition. + */ +class TTestController_Start_TransitionValidator : public TTransitionValidator + { +public: + /** + @fn TTestController_Start_TransitionValidator(CUnitTestContext& aUTContext) + Intended Usage : + @leave KErrNoMemory + @since 7.0 + @param aUTContext The context within which this transition is executing + */ + inline TTestController_Start_TransitionValidator(CUnitTestContext& aUTContext); + + /** + @fn ValidatePreConditions() + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + Error Condition : Invalid pre-conditions + @since 7.0 + @return TBool ETrue if the pre-conditions were valid, EFalse otherwise. + @pre TTestController_Start_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePreConditions(); + + /** + @fn ValidatePostConditions(TTestBedAsyncState aAsyncState) + Intended Usage : Implemented by the developer to check the + end state of the transition behaviour. + When overriding, if the transition calls an asynchronous function + ValidatePostConditions will be called twice. Firstly, after the + asynchronous function has been called and, secondly, after the + asynchronous request has completed. The parameter aAsyncState can + be used to distinguish between these two cases. + Error Condition : Invalid post-conditions. + @since 7.0 + @param aAsyncState EAsyncCalled if the async function has been just been called, + EAsyncCompleted if the function has completed. + @return TBool ETrue if the post-conditions were valid, EFalse otherwise. + @pre TTestController_Start_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState); + }; // TTestController_Start_TransitionValidator + + +#include "TestControllerTransitionValidation.inl" + +#endif // __TESTCONTROLLERTRANSITIONVALIDATION_H__ +