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