// 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 unit tests for the CRegistrar class
//
//
#ifndef __REGISTRARUNITTESTS_H__
#define __REGISTRARUNITTESTS_H__
#include "RegistrarTransitionValidation.h"
#include "RegistrarObserver.h"
// ______________________________________________________________________________
//
/**
@internalComponent
Comments : Unit Test for CreateAndDestroy on CRegistrar, the class under test.
*/
class CRegistrar_CreateAndDestroy_UnitTest : public CUnitTest, private MRegistrarObserver
{
public:
/**
@fn NewL(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver)
Intended Usage : Standard two-phase construction which leaves nothing on the
cleanup stack.
Error Condition : Leaves with the error code.
@leave KErrNoMemory
@since 7.0
@param aDataLogger The output logging object.
@param aObserver The observer of this UnitTest.
@return CRegistrar_CreateAndDestroy_UnitTest* The constructed object.
@pre None.
@post CRegistrar_CreateAndDestroy_UnitTest is fully constructed, and initialised.
*/
static CRegistrar_CreateAndDestroy_UnitTest* NewL(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver);
/**
@fn RunError(TInt aError)
Intended Usage : Intercept the panic caused by a RunL leave,
to restore the CRegistrar_CreateAndDestroy_UnitTest
object to a sensible state.
(called by the Active Scheduler immediately before the Panic).
Error Condition : @see CUnitTest::RunError().
@since 7.0
@return TInt KErrNone if cleanup successful, otherwise
@see CUnitTest::RunError()
@pre CRegistrar_CreateAndDestroy_UnitTest is fully constructed, and initialised.
@post The object has been restored to a sensible state.
*/
inline TInt RunError(TInt aError);
/**
@fn ~CRegistrar_CreateAndDestroy_UnitTest()
Intended Usage : Standard Destructor.
Error Condition : None.
@since 7.0
@pre CRegistrar_CreateAndDestroy_UnitTest is fully constructed.
@post CRegistrar_CreateAndDestroy_UnitTest is fully destroyed.
*/
~CRegistrar_CreateAndDestroy_UnitTest();
/**
@fn PrepareUnitTestL()
Intended Usage : Called by test framework just before test is run to allow
any test preparation to take place.
Error Condition :
@since 7.0
@pre CRegistrar_CreateAndDestroy_UnitTest is fully constructed.
@post This unit test is ready to run.
*/
void PrepareUnitTestL();
private:
/**
@fn CRegistrar_CreateAndDestroy_UnitTest(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver)
Intended Usage : Default constructor.
Error Condition : None.
@since 7.0
@param aDataLogger The output logging object.
@param aObserver The observer of this UnitTest.
@param aStateAccessor WhiteBox state access to the CRegistrar class.
@pre None.
@post CRegistrar_CreateAndDestroy_UnitTest is fully constructed.
*/
inline CRegistrar_CreateAndDestroy_UnitTest(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver);
/**
@fn void ConstructL()
Intended Usage : Second phase of safe two phase construction,
to complete the object initialisation.
Error Condition : Leaves with an error code.
@leave KErrNoMemory, and @see CUnitTest::BaseNewL().
@since 7.0
@return None
@pre CRegistrar_CreateAndDestroy_UnitTest is fully constructed.
@post CRegistrar_CreateAndDestroy_UnitTest is fully initialised.
*/
void ConstructL();
void Notification(TInt aNotificationCode);
/**
The context of the Unit Test.
i.e The CRegistrar class tested by this UnitTest's transitions.
*/
CRegistrar_UnitTestContext* iUTContext;
TRegistrar_StateAccessor* iStateAccessor;
/** Registry data which is required for constructing a CRegistrar */
CRegistryData* iRegistryData;
/** C'tor transition validator */
TRegistrar_Ctor_TransitionValidator* iCtorValidator;
/** D'tor transition validator */
TRegistrar_Dtor_TransitionValidator* iDtorValidator;
}; // CRegistrar_CreateAndDestroy_UnitTest
// ______________________________________________________________________________
//
/**
@internalComponent
Comments : Unit Test for BeginComplete on CRegistrar, the class under test.
*/
class CRegistrar_BeginComplete_UnitTest : public CUnitTest, private MRegistrarObserver
{
public:
/**
@fn NewL(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver)
Intended Usage : Standard two-phase construction which leaves nothing on the
cleanup stack.
Error Condition : Leaves with the error code.
@leave KErrNoMemory
@since 7.0
@param aDataLogger The output logging object.
@param aObserver The observer of this UnitTest.
@return CRegistrar_BeginComplete_UnitTest* The constructed object.
@pre None.
@post CRegistrar_BeginComplete_UnitTest is fully constructed, and initialised.
*/
static CRegistrar_BeginComplete_UnitTest* NewL(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver);
/**
@fn RunError(TInt aError)
Intended Usage : Intercept the panic caused by a RunL leave,
to restore the CRegistrar_BeginComplete_UnitTest
object to a sensible state.
(called by the Active Scheduler immediately before the Panic).
Error Condition : @see CUnitTest::RunError().
@since 7.0
@return TInt KErrNone if cleanup successful, otherwise
@see CUnitTest::RunError()
@pre CRegistrar_BeginComplete_UnitTest is fully constructed, and initialised.
@post The object has been restored to a sensible state.
*/
inline TInt RunError(TInt aError);
/**
@fn ~CRegistrar_BeginComplete_UnitTest()
Intended Usage : Standard Destructor.
Error Condition : None.
@since 7.0
@pre CRegistrar_BeginComplete_UnitTest is fully constructed.
@post CRegistrar_BeginComplete_UnitTest is fully destroyed.
*/
~CRegistrar_BeginComplete_UnitTest();
private:
/**
@fn CRegistrar_BeginComplete_UnitTest(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver)
Intended Usage : Default constructor.
Error Condition : None.
@since 7.0
@param aDataLogger The output logging object.
@param aObserver The observer of this UnitTest.
@param aStateAccessor WhiteBox state access to the CRegistrar class.
@pre None.
@post CRegistrar_BeginComplete_UnitTest is fully constructed.
*/
inline CRegistrar_BeginComplete_UnitTest(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver);
/**
@fn void ConstructL()
Intended Usage : Second phase of safe two phase construction,
to complete the object initialisation.
Error Condition : Leaves with an error code.
@leave KErrNoMemory, and @see CUnitTest::BaseNewL().
@since 7.0
@return None
@pre CRegistrar_BeginComplete_UnitTest is fully constructed.
@post CRegistrar_BeginComplete_UnitTest is fully initialised.
*/
void ConstructL();
void Notification(TInt aNotificationCode);
/**
The context of the Unit Test.
i.e The CRegistrar class tested by this UnitTest's transitions.
*/
CRegistrar_UnitTestContext* iUTContext;
TRegistrar_StateAccessor* iStateAccessor;
/** Registry data which is required for constructing a CRegistrar */
CRegistryData* iRegistryData;
// C'tor, d'tor, and default transition validators
TRegistrar_Ctor_TransitionValidator* iCtorValidator;
TRegistrar_Default_TransitionValidator* iDefaultValidator;
TRegistrar_Dtor_TransitionValidator* iDtorValidator;
}; // CRegistrar_BeginComplete_UnitTest
// ______________________________________________________________________________
//
/**
@internalComponent
Comments : Unit Test for RegisterDiscovery on CRegistrar, the class under test.
*/
class CRegistrar_RegisterDiscovery_UnitTest : public CUnitTest, private MRegistrarObserver
{
public:
/**
@fn NewL(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver)
Intended Usage : Standard two-phase construction which leaves nothing on the
cleanup stack.
Error Condition : Leaves with the error code.
@leave KErrNoMemory
@since 7.0
@param aDataLogger The output logging object.
@param aObserver The observer of this UnitTest.
@return CRegistrar_RegisterDiscovery_UnitTest* The constructed object.
@pre None.
@post CRegistrar_RegisterDiscovery_UnitTest is fully constructed, and initialised.
*/
static CRegistrar_RegisterDiscovery_UnitTest* NewL(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver);
/**
@fn RunError(TInt aError)
Intended Usage : Intercept the panic caused by a RunL leave,
to restore the CRegistrar_RegisterDiscovery_UnitTest
object to a sensible state.
(called by the Active Scheduler immediately before the Panic).
Error Condition : @see CUnitTest::RunError().
@since 7.0
@return TInt KErrNone if cleanup successful, otherwise
@see CUnitTest::RunError()
@pre CRegistrar_RegisterDiscovery_UnitTest is fully constructed, and initialised.
@post The object has been restored to a sensible state.
*/
inline TInt RunError(TInt aError);
/**
@fn ~CRegistrar_RegisterDiscovery_UnitTest()
Intended Usage : Standard Destructor.
Error Condition : None.
@since 7.0
@pre CRegistrar_RegisterDiscovery_UnitTest is fully constructed.
@post CRegistrar_RegisterDiscovery_UnitTest is fully destroyed.
*/
~CRegistrar_RegisterDiscovery_UnitTest();
private:
/**
@fn CRegistrar_RegisterDiscovery_UnitTest(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver)
Intended Usage : Default constructor.
Error Condition : None.
@since 7.0
@param aDataLogger The output logging object.
@param aObserver The observer of this UnitTest.
@param aStateAccessor WhiteBox state access to the CRegistrar class.
@pre None.
@post CRegistrar_RegisterDiscovery_UnitTest is fully constructed.
*/
inline CRegistrar_RegisterDiscovery_UnitTest(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver);
/**
@fn void ConstructL()
Intended Usage : Second phase of safe two phase construction,
to complete the object initialisation.
Error Condition : Leaves with an error code.
@leave KErrNoMemory, and @see CUnitTest::BaseNewL().
@since 7.0
@return None
@pre CRegistrar_RegisterDiscovery_UnitTest is fully constructed.
@post CRegistrar_RegisterDiscovery_UnitTest is fully initialised.
*/
void ConstructL();
void Notification(TInt aNotificationCode);
/**
The context of the Unit Test.
i.e The CRegistrar class tested by this UnitTest's transitions.
*/
CRegistrar_UnitTestContext* iUTContext;
TRegistrar_StateAccessor* iStateAccessor;
/** Registry data which is required for constructing a CRegistrar */
CRegistryData* iRegistryData;
// C'tor, d'tor, and method transition validators
TRegistrar_Ctor_TransitionValidator* iCtorValidator;
TRegistrar_RegisterDiscoveryL_TransitionValidator* iRegisterDiscoveryValidator;
TRegistrar_Dtor_TransitionValidator* iDtorValidator;
}; // CRegistrar_RegisterDiscovery_UnitTest
// ______________________________________________________________________________
//
/**
@internalComponent
Comments : Unit Test for RegisterDiscovery on CRegistrar, the class under test.
*/
class CRegistrar_RegisterTwice_UnitTest : public CUnitTest, private MRegistrarObserver
{
public:
/**
@fn NewL(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver)
Intended Usage : Standard two-phase construction which leaves nothing on the
cleanup stack.
Error Condition : Leaves with the error code.
@leave KErrNoMemory
@since 7.0
@param aDataLogger The output logging object.
@param aObserver The observer of this UnitTest.
@return CRegistrar_RegisterTwice_UnitTest* The constructed object.
@pre None.
@post CRegistrar_RegisterTwice_UnitTest is fully constructed, and initialised.
*/
static CRegistrar_RegisterTwice_UnitTest* NewL(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver);
/**
@fn RunError(TInt aError)
Intended Usage : Intercept the panic caused by a RunL leave,
to restore the CRegistrar_RegisterTwice_UnitTest
object to a sensible state.
(called by the Active Scheduler immediately before the Panic).
Error Condition : @see CUnitTest::RunError().
@since 7.0
@return TInt KErrNone if cleanup successful, otherwise
@see CUnitTest::RunError()
@pre CRegistrar_RegisterTwice_UnitTest is fully constructed, and initialised.
@post The object has been restored to a sensible state.
*/
inline TInt RunError(TInt aError);
/**
@fn ~CRegistrar_RegisterTwice_UnitTest()
Intended Usage : Standard Destructor.
Error Condition : None.
@since 7.0
@pre CRegistrar_RegisterTwice_UnitTest is fully constructed.
@post CRegistrar_RegisterTwice_UnitTest is fully destroyed.
*/
~CRegistrar_RegisterTwice_UnitTest();
private:
/**
@fn CRegistrar_RegisterTwice_UnitTest(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver)
Intended Usage : Default constructor.
Error Condition : None.
@since 7.0
@param aDataLogger The output logging object.
@param aObserver The observer of this UnitTest.
@param aStateAccessor WhiteBox state access to the CRegistrar class.
@pre None.
@post CRegistrar_RegisterTwice_UnitTest is fully constructed.
*/
inline CRegistrar_RegisterTwice_UnitTest(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver);
/**
@fn void ConstructL()
Intended Usage : Second phase of safe two phase construction,
to complete the object initialisation.
Error Condition : Leaves with an error code.
@leave KErrNoMemory, and @see CUnitTest::BaseNewL().
@since 7.0
@return None
@pre CRegistrar_RegisterTwice_UnitTest is fully constructed.
@post CRegistrar_RegisterTwice_UnitTest is fully initialised.
*/
void ConstructL();
void Notification(TInt aNotificationCode);
/**
The context of the Unit Test.
i.e The CRegistrar class tested by this UnitTest's transitions.
*/
CRegistrar_UnitTestContext* iUTContext;
TRegistrar_StateAccessor* iStateAccessor;
/** Registry data which is required for constructing a CRegistrar */
CRegistryData* iRegistryData;
// C'tor, d'tor, and method transition validators
TRegistrar_Ctor_TransitionValidator* iCtorValidator;
TRegistrar_RegisterDiscoveryL_TransitionValidator* iRegisterDiscoveryValidator;
TRegistrar_Default_TransitionValidator* iDefaultValidator;
TRegistrar_Dtor_TransitionValidator* iDtorValidator;
}; // CRegistrar_RegisterTwice_UnitTest
// ______________________________________________________________________________
//
/**
@internalComponent
Comments : Unit Test for RegisterDiscovery on CRegistrar, the class under test.
*/
class CRegistrar_UseWhileDiscovering_UnitTest : public CUnitTest, private MRegistrarObserver
{
public:
/**
@fn NewL(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver)
Intended Usage : Standard two-phase construction which leaves nothing on the
cleanup stack.
Error Condition : Leaves with the error code.
@leave KErrNoMemory
@since 7.0
@param aDataLogger The output logging object.
@param aObserver The observer of this UnitTest.
@return CRegistrar_UseWhileDiscovering_UnitTest* The constructed object.
@pre None.
@post CRegistrar_UseWhileDiscovering_UnitTest is fully constructed, and initialised.
*/
static CRegistrar_UseWhileDiscovering_UnitTest* NewL(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver);
/**
@fn RunError(TInt aError)
Intended Usage : Intercept the panic caused by a RunL leave,
to restore the CRegistrar_UseWhileDiscovering_UnitTest
object to a sensible state.
(called by the Active Scheduler immediately before the Panic).
Error Condition : @see CUnitTest::RunError().
@since 7.0
@return TInt KErrNone if cleanup successful, otherwise
@see CUnitTest::RunError()
@pre CRegistrar_UseWhileDiscovering_UnitTest is fully constructed, and initialised.
@post The object has been restored to a sensible state.
*/
inline TInt RunError(TInt aError);
/**
@fn ~CRegistrar_UseWhileDiscovering_UnitTest()
Intended Usage : Standard Destructor.
Error Condition : None.
@since 7.0
@pre CRegistrar_UseWhileDiscovering_UnitTest is fully constructed.
@post CRegistrar_UseWhileDiscovering_UnitTest is fully destroyed.
*/
~CRegistrar_UseWhileDiscovering_UnitTest();
private:
/**
@fn CRegistrar_UseWhileDiscovering_UnitTest(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver)
Intended Usage : Default constructor.
Error Condition : None.
@since 7.0
@param aDataLogger The output logging object.
@param aObserver The observer of this UnitTest.
@param aStateAccessor WhiteBox state access to the CRegistrar class.
@pre None.
@post CRegistrar_UseWhileDiscovering_UnitTest is fully constructed.
*/
inline CRegistrar_UseWhileDiscovering_UnitTest(CDataLogger& aDataLogger,
MUnitTestObserver& aObserver);
/**
@fn void ConstructL()
Intended Usage : Second phase of safe two phase construction,
to complete the object initialisation.
Error Condition : Leaves with an error code.
@leave KErrNoMemory, and @see CUnitTest::BaseNewL().
@since 7.0
@return None
@pre CRegistrar_UseWhileDiscovering_UnitTest is fully constructed.
@post CRegistrar_UseWhileDiscovering_UnitTest is fully initialised.
*/
void ConstructL();
void Notification(TInt aNotificationCode);
/**
The context of the Unit Test.
i.e The CRegistrar class tested by this UnitTest's transitions.
*/
CRegistrar_UnitTestContext* iUTContext;
TRegistrar_StateAccessor* iStateAccessor;
/** Registry data which is required for constructing a CRegistrar */
CRegistryData* iRegistryData;
// C'tor, d'tor, and method transition validators
TRegistrar_Ctor_TransitionValidator* iCtorValidator;
TRegistrar_CheckRegWhileDiscovering_TransitionValidator* iCheckRegValidator;
TRegistrar_Dtor_TransitionValidator* iDtorValidator;
}; // CRegistrar_UseWhileDiscovering_UnitTest
#include "RegistrarUnitTests.inl"
#endif // __REGISTRARUNITTESTS_H__