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 CComponentInfo class methods. sl@0: // sl@0: // sl@0: sl@0: #ifndef __COMPONENTINFOTRANSITIONS_H__ sl@0: #define __COMPONENTINFOTRANSITIONS_H__ sl@0: sl@0: #include "TestUtilities.h" sl@0: #include "StateAccessor.h" sl@0: #include "LeakTestTransition.h" sl@0: #include sl@0: #include "ComponentInfo.h" sl@0: #include "ComponentInfoStateAccessor.h" sl@0: #include sl@0: sl@0: // Global function typedef declaration of function provided by a test module of the component sl@0: // under test and is used as an entry point to kick start test bed. Provided as argument to CTestController. sl@0: typedef CComponentTester* (*ComponentTesterInitialiserLC)(CDataLogger&, MComponentTestObserver&); sl@0: sl@0: #define CTransitionType CLeakTestTransition sl@0: sl@0: // ______________________________________________________________________________ sl@0: // sl@0: /** sl@0: @internalComponent sl@0: sl@0: Comments : Provide all the CComponentInfo specific sl@0: parameters and behaviour on the CComponentInfo sl@0: test class for a transition. sl@0: */ sl@0: class CComponentInfo_UnitTestContext : public CUnitTestContext sl@0: { sl@0: public: sl@0: /** sl@0: @fn CComponentInfo_UnitTestContext(CDataLogger& aDataLogger, sl@0: MStateAccessor& aStateAccessor, sl@0: MTransitionObserver& aObserver) sl@0: Intended Usage : Default constructor. sl@0: Error Condition : None. sl@0: @since 7.0 sl@0: @param aDataLogger The output logging object. sl@0: @param aObserver The observer of this UnitTest's Transitions. sl@0: @param aStateAccessor WhiteBox state access to the CComponentInfo class under test. sl@0: @pre None. sl@0: @post CComponentInfo_UnitTestContext is fully constructed, and initialised. sl@0: */ sl@0: inline CComponentInfo_UnitTestContext(CDataLogger& aDataLogger, sl@0: MStateAccessor& aStateAccessor, sl@0: MTransitionObserver& aObserver); sl@0: sl@0: /** sl@0: @fn ~CComponentInfo_UnitTestContext() sl@0: Intended Usage : Default Destructor sl@0: @since 7.0 sl@0: @pre CComponentInfo_UnitTestContext is fully constructed. sl@0: @post CComponentInfo_UnitTestContext is fully destroyed sl@0: */ sl@0: virtual inline ~CComponentInfo_UnitTestContext(); sl@0: sl@0: /** The instance of the class under test */ sl@0: CComponentInfo* iComponentInfo; sl@0: /** The directory entry for a dll */ sl@0: ComponentTesterInitialiserLC iEntryFunc; sl@0: /** A TEntry to check that the correct directory for the test component is found */ sl@0: ComponentTesterInitialiserLC iEntryFuncPostCheck; sl@0: /** The array of unit tests for the component under test */ sl@0: RPointerArray* iTestInfoArray; sl@0: /** Used to check that the correct list of unit tests is found for a particular component */ sl@0: const RPointerArray* iTestInfoArrayPostCheck; sl@0: /** Flag indicating whether we have passed ownership of iEntry & iTestInfoArray sl@0: to the CComponentInfo */ sl@0: TBool iOwnParams; sl@0: }; // CComponentInfo_UnitTestContext sl@0: sl@0: // ______________________________________________________________________________ sl@0: // sl@0: /** sl@0: @internalComponent sl@0: sl@0: Comments : Transition test of the CComponentInfo::NewL method. sl@0: */ sl@0: class CComponentInfo_NewL_Transition : public CTransitionType sl@0: { sl@0: public: sl@0: /** sl@0: @fn CComponentInfo_NewL_Transition(CUnitTestContext& aUTContext, sl@0: TTransitionValidator& aValidator) sl@0: Intended Usage : Standard c'tor method. sl@0: Error Condition : None. sl@0: @since 7.0 sl@0: @param aUTContext The context this transition is operating in. sl@0: @param aValidator Used for checking the pre & post conditions of the test object. sl@0: @pre None. sl@0: @post CComponentInfo_NewL_Transition is fully constructed. sl@0: */ sl@0: CComponentInfo_NewL_Transition(CUnitTestContext& aUTContext, sl@0: TTransitionValidator& aValidator); sl@0: /** sl@0: @fn TransitMethodL() sl@0: Intended Usage : To execute the CComponentInfo::NewL method for the test harness. sl@0: Error Condition : Leaves with an error code. sl@0: @leave KErrNoMemory, (@see CComponentInfo::NewL) sl@0: @since 7.0 sl@0: @return None sl@0: @pre CComponentInfo_NewL_Transition is fully constructed. sl@0: @post No change in the CComponentInfo_NewL_Transition apart sl@0: from iComponentInfo, which may have changed state. sl@0: (@see CComponentInfo::NewL post-condition) for iComponentInfo's new state. sl@0: */ sl@0: inline void TransitMethodL(); sl@0: sl@0: /** sl@0: @fn Context() const sl@0: Intended Usage : To provide access to the unit test context cast to the correct type. sl@0: Error Condition : None. sl@0: @since 7.0 sl@0: @return The unit test context cast to a CComponentInfo_UnitTestContext sl@0: @pre iUTContext is a valid CComponentInfo_UnitTestContext. sl@0: @post No change in the CComponentInfo_NewL_Transition sl@0: */ sl@0: inline CComponentInfo_UnitTestContext& Context() const; sl@0: }; // CComponentInfo_NewL_Transition sl@0: sl@0: // ______________________________________________________________________________ sl@0: // sl@0: /** sl@0: @internalComponent sl@0: sl@0: Comments : Transition test of the CComponentInfo::Dtor method. sl@0: */ sl@0: class CComponentInfo_Dtor_Transition : public CTransition sl@0: { sl@0: public: sl@0: /** sl@0: @fn CComponentInfo_Dtor_Transition(CUnitTestContext& aUTContext, sl@0: TTransitionValidator& aValidator) sl@0: Intended Usage : Standard c'tor method. sl@0: Error Condition : None. sl@0: @since 7.0 sl@0: @param aUTContext The context this transition is operating in. sl@0: @param aValidator Used for checking the pre & post conditions of the test object. sl@0: @pre None. sl@0: @post CComponentInfo_Dtor_Transition is fully constructed. sl@0: */ sl@0: CComponentInfo_Dtor_Transition(CUnitTestContext& aUTContext, sl@0: TTransitionValidator& aValidator); sl@0: /** sl@0: @fn TransitMethodL() sl@0: Intended Usage : To execute the CComponentInfo::Dtor method for the test harness. sl@0: Error Condition : Leaves with an error code. sl@0: @leave KErrNoMemory, (@see CComponentInfo::Dtor) sl@0: @since 7.0 sl@0: @return None sl@0: @pre CComponentInfo_Dtor_Transition is fully constructed. sl@0: @post No change in the CComponentInfo_Dtor_Transition apart sl@0: from iComponentInfo, which may have changed state. sl@0: (@see CComponentInfo::Dtor post-condition) for iComponentInfo's new state. sl@0: */ sl@0: inline void TransitMethodL(); sl@0: sl@0: /** sl@0: @fn Context() const sl@0: Intended Usage : To provide access to the unit test context cast to the correct type. sl@0: Error Condition : None. sl@0: @since 7.0 sl@0: @return The unit test context cast to a CComponentInfo_UnitTestContext sl@0: @pre iUTContext is a valid CComponentInfo_UnitTestContext. sl@0: @post No change in the CComponentInfo_Dtor_Transition sl@0: */ sl@0: inline CComponentInfo_UnitTestContext& Context() const; sl@0: }; // CComponentInfo_Dtor_Transition sl@0: sl@0: // ______________________________________________________________________________ sl@0: // sl@0: /** sl@0: @internalComponent sl@0: sl@0: Comments : Transition test of the CComponentInfo::Entry method. sl@0: */ sl@0: class CComponentInfo_Entry_Transition : public CTransition sl@0: { sl@0: public: sl@0: /** sl@0: @fn CComponentInfo_Entry_Transition(CUnitTestContext& aUTContext, sl@0: TTransitionValidator& aValidator) sl@0: Intended Usage : Standard c'tor method. sl@0: Error Condition : None. sl@0: @since 7.0 sl@0: @param aUTContext The context this transition is operating in. sl@0: @param aValidator Used for checking the pre & post conditions of the test object. sl@0: @pre None. sl@0: @post CComponentInfo_Entry_Transition is fully constructed. sl@0: */ sl@0: CComponentInfo_Entry_Transition(CUnitTestContext& aUTContext, sl@0: TTransitionValidator& aValidator); sl@0: /** sl@0: @fn TransitMethodL() sl@0: Intended Usage : To execute the CComponentInfo::Entry method for the test harness. sl@0: Error Condition : Leaves with an error code. sl@0: @leave KErrNoMemory, (@see CComponentInfo::Entry) sl@0: @since 7.0 sl@0: @return None sl@0: @pre CComponentInfo_Entry_Transition is fully constructed. sl@0: @post No change in the CComponentInfo_Entry_Transition apart sl@0: from iComponentInfo, which may have changed state. sl@0: (@see CComponentInfo::Entry post-condition) for iComponentInfo's new state. sl@0: */ sl@0: inline void TransitMethodL(); sl@0: sl@0: /** sl@0: @fn Context() const sl@0: Intended Usage : To provide access to the unit test context cast to the correct type. sl@0: Error Condition : None. sl@0: @since 7.0 sl@0: @return The unit test context cast to a CComponentInfo_UnitTestContext sl@0: @pre iUTContext is a valid CComponentInfo_UnitTestContext. sl@0: @post No change in the CComponentInfo_Entry_Transition sl@0: */ sl@0: inline CComponentInfo_UnitTestContext& Context() const; sl@0: }; // CComponentInfo_Entry_Transition sl@0: sl@0: // ______________________________________________________________________________ sl@0: // sl@0: /** sl@0: @internalComponent sl@0: sl@0: Comments : Transition test of the CComponentInfo::UnitTestsInfo method. sl@0: */ sl@0: class CComponentInfo_UnitTestsInfo_Transition : public CTransition sl@0: { sl@0: public: sl@0: /** sl@0: @fn CComponentInfo_UnitTestsInfo_Transition(CUnitTestContext& aUTContext, sl@0: TTransitionValidator& aValidator) sl@0: Intended Usage : Standard c'tor method. sl@0: Error Condition : None. sl@0: @since 7.0 sl@0: @param aUTContext The context this transition is operating in. sl@0: @param aValidator Used for checking the pre & post conditions of the test object. sl@0: @pre None. sl@0: @post CComponentInfo_UnitTestsInfo_Transition is fully constructed. sl@0: */ sl@0: CComponentInfo_UnitTestsInfo_Transition(CUnitTestContext& aUTContext, sl@0: TTransitionValidator& aValidator); sl@0: /** sl@0: @fn TransitMethodL() sl@0: Intended Usage : To execute the CComponentInfo::UnitTestsInfo method for the test harness. sl@0: Error Condition : Leaves with an error code. sl@0: @leave KErrNoMemory, (@see CComponentInfo::UnitTestsInfo) sl@0: @since 7.0 sl@0: @return None sl@0: @pre CComponentInfo_UnitTestsInfo_Transition is fully constructed. sl@0: @post No change in the CComponentInfo_UnitTestsInfo_Transition apart sl@0: from iComponentInfo, which may have changed state. sl@0: (@see CComponentInfo::UnitTestsInfo post-condition) for iComponentInfo's new state. sl@0: */ sl@0: inline void TransitMethodL(); sl@0: sl@0: /** sl@0: @fn Context() const sl@0: Intended Usage : To provide access to the unit test context cast to the correct type. sl@0: Error Condition : None. sl@0: @since 7.0 sl@0: @return The unit test context cast to a CComponentInfo_UnitTestContext sl@0: @pre iUTContext is a valid CComponentInfo_UnitTestContext. sl@0: @post No change in the CComponentInfo_UnitTestsInfo_Transition sl@0: */ sl@0: inline CComponentInfo_UnitTestContext& Context() const; sl@0: }; // CComponentInfo_UnitTestsInfo_Transition sl@0: sl@0: sl@0: // Add additional Transition class definitions here... sl@0: sl@0: #include "ComponentInfoTransitions.inl" sl@0: sl@0: #include "ComponentInfoUnitTestContext.inl" sl@0: sl@0: #endif // __COMPONENTINFOTRANSITIONS_H__ sl@0: