diff -r 000000000000 -r e4d67989cc36 lowlevellibsandfws/pluginfw/Framework/LoadManagerTest/LoadManagerTransitionValidation.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/lowlevellibsandfws/pluginfw/Framework/LoadManagerTest/LoadManagerTransitionValidation.h Tue Feb 02 02:01:42 2010 +0200 @@ -0,0 +1,286 @@ +// 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 definition of the validation classes for CLoadManager testing. +// +// + +#ifndef __LOADMANAGERTRANSITIONVALIDATION_H__ +#define __LOADMANAGERTRANSITIONVALIDATION_H__ + +#include "LoadManagerTransitions.h" + + +// ______________________________________________________________________________ +// +/** + @internalComponent + Comments : Provide all the CtorUnit Test's specific + validatation for the state of a transition before and after its execution. + on the CLoadManager test class for a transition. + */ +class TLoadManager_Ctor_TransitionValidator : public TTransitionValidator + { +public: + /** + @fn TLoadManager_Ctor_TransitionValidator(CUnitTestContext& aUTContext) + Intended Usage : Default constructor + @leave KErrNoMemory + @since 7.0 + @param aUTContext The context within which this transition is executing + */ + inline TLoadManager_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 TLoadManager_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 TLoadManager_Ctor_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState); + }; // TLoadManager_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 CLoadManager test class for a transition. + */ +class TLoadManager_Dtor_TransitionValidator : public TTransitionValidator + { +public: + /** + @fn TLoadManager_Dtor_TransitionValidator(CUnitTestContext& aUTContext) + Intended Usage : Default constructor. + @leave KErrNoMemory + @since 7.0 + @param aUTContext The context within which this transition is executing + */ + inline TLoadManager_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 TLoadManager_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 TLoadManager_Dtor_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState); + }; // TLoadManager_Dtor_TransitionValidator + +// ______________________________________________________________________________ +// +/** + @internalComponent + Comments : Provide all the InstantiationMethodUnit Test's specific + validatation for the state of a transition before and after its execution. + on the CLoadManager test class for a transition. + */ +class TLoadManager_InstantiationMethod_TransitionValidator : public TTransitionValidator + { +public: + /** + @fn TLoadManager_InstantiationMethod_TransitionValidator(CUnitTestContext& aUTContext) + Intended Usage : Default constructor + @leave KErrNoMemory + @since 7.0 + @param aUTContext The context within which this transition is executing + */ + inline TLoadManager_InstantiationMethod_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 TLoadManager_InstantiationMethod_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 TLoadManager_InstantiationMethod_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState); + }; // TLoadManager_InstantiationMethod_TransitionValidator + +// ______________________________________________________________________________ +// +/** + @internalComponent + Comments : Provide all the InstantiationMethodUnit Test's specific + validatation for the state of a transition before and after its execution. + on the CLoadManager test class for a transition. + */ +class TLoadManager_InstantiationFailure_TransitionValidator : public TTransitionValidator + { +public: + /** + @fn TLoadManager_InstantiationFailure_TransitionValidator(CUnitTestContext& aUTContext) + Intended Usage : + @leave KErrNoMemory + @since 7.0 + @param aUTContext The context within which this transition is executing + */ + inline TLoadManager_InstantiationFailure_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 TLoadManager_InstantiationFailure_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 TLoadManager_InstantiationFailure_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState); + }; // TLoadManager_InstantiationFailure_TransitionValidator + +// ______________________________________________________________________________ +// +/** + @internalComponent + Comments : Provide all the DestroyThisUnit Test's specific + validatation for the state of a transition before and after its execution. + on the CLoadManager test class for a transition. + */ +class TLoadManager_DestroyThis_TransitionValidator : public TTransitionValidator + { +public: + /** + @fn TLoadManager_DestroyThis_TransitionValidator(CUnitTestContext& aUTContext) + Intended Usage : Default constructor + @leave KErrNoMemory + @since 7.0 + @param aUTContext The context within which this transition is executing + */ + inline TLoadManager_DestroyThis_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 TLoadManager_DestroyThis_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 TLoadManager_DestroyThis_TransitionValidator is fully constructed. + @post No change to the iUTContext class. + */ + virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState); + }; // TLoadManager_DestroyThis_TransitionValidator + +#include "LoadManagerTransitionValidation.inl" + +#endif // __LOADMANAGERTRANSITIONVALIDATION_H__