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: // This file contains the definition of the sl@0: // class CSuicideInterfaceUnitTest sl@0: // sl@0: // sl@0: sl@0: #ifndef __SUICIDEUNITTEST_H__ sl@0: #define __SUICIDEUNITTEST_H__ sl@0: sl@0: #include sl@0: sl@0: #include sl@0: #include "SuicideStateAccessors.h" sl@0: #include "SuicideTransitions.h" sl@0: #include "SuicideTransitionValidation.h" sl@0: sl@0: // ______________________________________________________________________________ sl@0: // sl@0: /** sl@0: @internalComponent sl@0: sl@0: Comments : UnitTest CreateAndDestroy on the CExampleInterface test class. sl@0: */ sl@0: class CSuicideInterfaceCreateAndDestroyUnitTest : public CUnitTest sl@0: { sl@0: public: sl@0: /** sl@0: @fn NewL(CDataLogger& aDataLogger, sl@0: MUnitTestObserver& aObserver) sl@0: Intended Usage : Standard two-phase construction which leaves nothing on the sl@0: cleanup stack. sl@0: Error Condition : Leaves with the error code. sl@0: @leave KErrNoMemory sl@0: @since 7.0 sl@0: @param aDataLogger The output logging object. sl@0: @param aObserver The observer of this UnitTest. sl@0: @param aStateAccessor WhiteBox state access to the CExampleInterface class. sl@0: @return CSuicideInterfaceCreateAndDestroyUnitTest* The constructed object. sl@0: @pre None. sl@0: @post CSuicideInterfaceCreateAndDestroyUnitTest is fully constructed, and initialised. sl@0: */ sl@0: static CSuicideInterfaceCreateAndDestroyUnitTest* NewL(CDataLogger& aDataLogger, sl@0: MUnitTestObserver& aObserver); sl@0: sl@0: /** sl@0: @fn RunError(TInt aError) sl@0: Intended Usage : Intercept the panic caused by a RunL leave, sl@0: to restore the CSuicideInterfaceCreateAndDestroyUnitTest sl@0: object to a sensible state. sl@0: (called by the Active Scheduler immediately before the Panic). sl@0: Error Condition : @see CUnitTest::RunError(). sl@0: @since 7.0 sl@0: @return TInt KErrNone if cleanup successful, otherwise sl@0: @see CUnitTest::RunError() sl@0: @pre CSuicideInterfaceCreateAndDestroyUnitTest is fully constructed, and initialised. sl@0: @post The object has been restored to a sensible state. sl@0: */ sl@0: inline TInt RunError(TInt aError); sl@0: sl@0: /** sl@0: @fn ~CSuicideInterfaceCreateAndDestroyUnitTest() sl@0: Intended Usage : Standard Destructor. sl@0: Error Condition : None. sl@0: @since 7.0 sl@0: @pre CSuicideInterfaceCreateAndDestroyUnitTest is fully constructed. sl@0: @post CSuicideInterfaceCreateAndDestroyUnitTest is fully destroyed. sl@0: */ sl@0: inline ~CSuicideInterfaceCreateAndDestroyUnitTest(); sl@0: sl@0: private: sl@0: /** sl@0: @fn CSuicideInterfaceCreateAndDestroyUnitTest(CDataLogger& aDataLogger, sl@0: MUnitTestObserver& 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. sl@0: @param aStateAccessor WhiteBox state access to the CExampleInterface class. sl@0: @pre None. sl@0: @post CSuicideInterfaceCreateAndDestroyUnitTest is fully constructed. sl@0: */ sl@0: inline CSuicideInterfaceCreateAndDestroyUnitTest(CDataLogger& aDataLogger, sl@0: MUnitTestObserver& aObserver); sl@0: sl@0: /** sl@0: @fn void ConstructL() sl@0: Intended Usage : Second phase of safe two phase construction, sl@0: to complete the object initialisation. sl@0: Error Condition : Leaves with an error code. sl@0: @leave KErrNoMemory, and @see CUnitTest::BaseNewL(). sl@0: @since 7.0 sl@0: @return None sl@0: @pre CSuicideInterfaceCreateAndDestroyUnitTest is fully constructed. sl@0: @post CSuicideInterfaceCreateAndDestroyUnitTest is fully initialised. sl@0: */ sl@0: inline void ConstructL(); sl@0: sl@0: /** sl@0: The context of the Unit Test. sl@0: i.e The CExampleInterface class tested by this UintTest's transitions. sl@0: */ sl@0: CSuicideInterface_UnitTestContext* iUTContext; sl@0: TSuicideInterface_Ctor_TransitionValidator* iCtorValidator; sl@0: TSuicideInterface_Dtor_TransitionValidator* iDtorValidator; sl@0: TSuicideInterface_StateAccessor* iStateAccessor; sl@0: REComSession* iEComSession; sl@0: }; sl@0: sl@0: // ______________________________________________________________________________ sl@0: // sl@0: /** sl@0: @internalComponent sl@0: sl@0: Comments : UnitTest of the CExampleInterface test class. sl@0: */ sl@0: class CSuicideInterfaceFireAndForgetUnitTest : public CUnitTest sl@0: { sl@0: public: sl@0: /** sl@0: @fn NewL(CDataLogger& aDataLogger, sl@0: MUnitTestObserver& aObserver) sl@0: Intended Usage : Standard two-phase construction which leaves nothing on the sl@0: cleanup stack sl@0: Error Condition : Leaves with the error code. sl@0: @leave KErrNoMemory sl@0: @since 7.0 sl@0: @param aDataLogger The output logging object. sl@0: @param aObserver The observer of this UnitTest. sl@0: @param aStateAccessor The WhiteBox state access for the CExampleInterface class. sl@0: @return CSuicideInterfaceFireAndForgetUnitTest* The constructed object. sl@0: @pre None sl@0: @post CSuicideInterfaceFireAndForgetUnitTest is fully constructed, and initialised. sl@0: */ sl@0: static CSuicideInterfaceFireAndForgetUnitTest* NewL(CDataLogger& aDataLogger, sl@0: MUnitTestObserver& aObserver); sl@0: sl@0: /** sl@0: @fn RunError(TInt aError) sl@0: Intended Usage : Trap on the RunL leave, called by the Active Scheduler. sl@0: Error Condition : @see CUnitTest::RunError() sl@0: @since 7.0 sl@0: @return TInt KErrNone if cleanup successful, otherwise @see CUnitTest::RunError() sl@0: @pre CSuicideInterfaceFireAndForgetUnitTest is fully constructed, and initialised. sl@0: @post The object has been restored to a sensible state. sl@0: */ sl@0: inline TInt RunError(TInt aError); sl@0: sl@0: /** sl@0: @fn ~CSuicideInterfaceFireAndForgetUnitTest() sl@0: Intended Usage : Standard Destructor sl@0: Error Condition : None. sl@0: @since 7.0 sl@0: @pre CSuicideInterfaceFireAndForgetUnitTest is fully constructed. sl@0: @post CSuicideInterfaceFireAndForgetUnitTest is fully destroyed. sl@0: */ sl@0: inline ~CSuicideInterfaceFireAndForgetUnitTest(); sl@0: sl@0: private: sl@0: /** sl@0: @fn CSuicideInterfaceFireAndForgetUnitTest(CDataLogger& aDataLogger, sl@0: MUnitTestObserver& 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. sl@0: @param aStateAccessor The WhiteBox state access for the CExampleInterface class. sl@0: @pre None sl@0: @post CSuicideInterfaceFireAndForgetUnitTest is fully constructed. sl@0: */ sl@0: inline CSuicideInterfaceFireAndForgetUnitTest(CDataLogger& aDataLogger, sl@0: MUnitTestObserver& aObserver); sl@0: sl@0: /** sl@0: @fn void ConstructL() sl@0: Intended Usage : Second phase of safe two phase construction, sl@0: to complete the object initialisation. sl@0: Error Condition : Leaves with an error code. sl@0: @leave KErrNoMemory, and @see CUnitTest::BaseNewL(). sl@0: @since 7.0 sl@0: @return None sl@0: @pre CSuicideInterfaceFireAndForgetUnitTest is fully constructed. sl@0: @post CSuicideInterfaceFireAndForgetUnitTest is fully initialised. sl@0: */ sl@0: inline void ConstructL(); sl@0: sl@0: /** The context of the Unit Test i.e a ClassName class */ sl@0: CSuicideInterface_UnitTestContext* iUTContext; sl@0: TSuicideInterface_Ctor_TransitionValidator* iCtorValidator; sl@0: TSuicideInterface_FireAndForget_TransitionValidator* iFireAndForgetValidator; sl@0: TSuicideInterface_StateAccessor* iStateAccessor; sl@0: REComSession* iEComSession; sl@0: }; sl@0: sl@0: #endif // __SUICIDEUNITTEST_H__