os/ossrv/lowlevellibsandfws/apputils/tsrc/t_strings/StringPoolTransitionValidation.h
1 // Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
2 // All rights reserved.
3 // This component and the accompanying materials are made available
4 // under the terms of "Eclipse Public License v1.0"
5 // which accompanies this distribution, and is available
6 // at the URL "http://www.eclipse.org/legal/epl-v10.html".
8 // Initial Contributors:
9 // Nokia Corporation - initial contribution.
14 // The definitions of the transition classes upon the RStringPool class methods.
18 #ifndef __STRINGPOOLTRANSITIONVALIDATION_H__
19 #define __STRINGPOOLTRANSITIONVALIDATION_H__
21 #include "StringPoolTransitions.h"
23 // ______________________________________________________________________________
27 Comments : Provide all the TrueUnit Test's specific
28 validatation for the state of a transition before and after its execution.
29 on the RStringPool test class for a transition.
31 class TStringPool_True_TransitionValidator : public TTransitionValidator
35 @fn TStringPool_True_TransitionValidator(CUnitTestContext& aUTContext)
39 @param aUTContext The context within which this transition is executing
41 inline TStringPool_True_TransitionValidator(CUnitTestContext& aUTContext);
44 @fn ValidatePreConditions()
45 Intended Usage : Implemented by the developer to check the
46 end state of the transition behaviour.
47 Error Condition : Invalid pre-conditions
49 @return TBool ETrue if the pre-conditions were valid, EFalse otherwise.
50 @pre TStringPool_True_TransitionValidator is fully constructed.
51 @post No change to the iUTContext class.
53 virtual inline TBool ValidatePreConditions();
56 @fn ValidatePostConditions(TTestBedAsyncState aAsyncState)
57 Intended Usage : Implemented by the developer to check the
58 end state of the transition behaviour.
59 When overriding, if the transition calls an asynchronous function
60 ValidatePostConditions will be called twice. Firstly, after the
61 asynchronous function has been called and, secondly, after the
62 asynchronous request has completed. The parameter aAsyncState can
63 be used to distinguish between these two cases.
64 Error Condition : Invalid post-conditions.
66 @param aAsyncState EAsyncCalled if the async function has been just been called,
67 EAsyncCompleted if the function has completed.
68 @return TBool ETrue if the post-conditions were valid, EFalse otherwise.
69 @pre TStringPool_True_TransitionValidator is fully constructed.
70 @post No change to the iUTContext class.
72 virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState);
73 }; // TStringPool_True_TransitionValidator
75 // ______________________________________________________________________________
79 Comments : Provide all the FalseUnit Test's specific
80 validatation for the state of a transition before and after its execution.
81 on the RStringPool test class for a transition.
83 class TStringPool_False_TransitionValidator : public TTransitionValidator
87 @fn TStringPool_False_TransitionValidator(CUnitTestContext& aUTContext)
91 @param aUTContext The context within which this transition is executing
93 inline TStringPool_False_TransitionValidator(CUnitTestContext& aUTContext);
96 @fn ValidatePreConditions()
97 Intended Usage : Implemented by the developer to check the
98 end state of the transition behaviour.
99 Error Condition : Invalid pre-conditions
101 @return TBool ETrue if the pre-conditions were valid, EFalse otherwise.
102 @pre TStringPool_False_TransitionValidator is fully constructed.
103 @post No change to the iUTContext class.
105 virtual inline TBool ValidatePreConditions();
108 @fn ValidatePostConditions(TTestBedAsyncState aAsyncState)
109 Intended Usage : Implemented by the developer to check the
110 end state of the transition behaviour.
111 When overriding, if the transition calls an asynchronous function
112 ValidatePostConditions will be called twice. Firstly, after the
113 asynchronous function has been called and, secondly, after the
114 asynchronous request has completed. The parameter aAsyncState can
115 be used to distinguish between these two cases.
116 Error Condition : Invalid post-conditions.
118 @param aAsyncState EAsyncCalled if the async function has been just been called,
119 EAsyncCompleted if the function has completed.
120 @return TBool ETrue if the post-conditions were valid, EFalse otherwise.
121 @pre TStringPool_False_TransitionValidator is fully constructed.
122 @post No change to the iUTContext class.
124 virtual inline TBool ValidatePostConditions(TTestBedAsyncState aAsyncState);
125 }; // TStringPool_False_TransitionValidator
127 #include "StringPoolTransitionValidation.inl"
129 #endif // __STRINGPOOLTRANSITIONVALIDATION_H__