/*

* Copyright (c) 2002 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:  wvsapsettingstest class member functions

*

*/

// INCLUDE FILES

#include <Stiftestinterface.h>

#include "wvsapsettingstest.h"

#include <SettingServerClient.h>

// EXTERNAL DATA STRUCTURES

//extern  ?external_data;

// EXTERNAL FUNCTION PROTOTYPES

//extern ?external_function( ?arg_type,?arg_type );

// CONSTANTS

//const ?type ?constant_var = ?constant;

// MACROS

//#define ?macro ?macro_def

// LOCAL CONSTANTS AND MACROS

//const ?type ?constant_var = ?constant;

//#define ?macro_name ?macro_def

// MODULE DATA STRUCTURES

//enum ?declaration

//typedef ?declaration

// LOCAL FUNCTION PROTOTYPES

//?type ?function_name( ?arg_type, ?arg_type );

// FORWARD DECLARATIONS

//class ?FORWARD_CLASSNAME;

// ============================= LOCAL FUNCTIONS ===============================

// -----------------------------------------------------------------------------

// ?function_name ?description.

// ?description

// Returns: ?value_1: ?description

//          ?value_n: ?description_line1

//                    ?description_line2

// -----------------------------------------------------------------------------

//

/*

?type ?function_name(

    ?arg_type arg,  // ?description

    ?arg_type arg)  // ?description

    {

    ?code  // ?comment

    // ?comment

    ?code

    }

*/

// ============================ MEMBER FUNCTIONS ===============================

// -----------------------------------------------------------------------------

// Cwvsapsettingstest::Cwvsapsettingstest

// C++ default constructor can NOT contain any code, that

// might leave.

// -----------------------------------------------------------------------------

//

Cwvsapsettingstest::Cwvsapsettingstest()

    {

    }

// -----------------------------------------------------------------------------

// Cwvsapsettingstest::ConstructL

// Symbian 2nd phase constructor can leave.

//

// Note: If OOM test case uses STIF Logger, then STIF Logger must be created

// with static buffer size parameter (aStaticBufferSize). Otherwise Logger

// allocates memory from heap and therefore causes error situations with OOM

// testing. For more information about STIF Logger construction, see STIF Users

// Guide.

// -----------------------------------------------------------------------------

//

void Cwvsapsettingstest::ConstructL()

    {

    //Read logger settings to check whether test case name is to be

    //appended to log file name.

    RSettingServer settingServer;

    TInt ret = settingServer.Connect();

    if ( ret != KErrNone )

        {

        User::Leave( ret );

        }

    // Struct to StifLogger settigs.

    TLoggerSettings loggerSettings;

    // Parse StifLogger defaults from STIF initialization file.

    ret = settingServer.GetLoggerSettings( loggerSettings );

    if ( ret != KErrNone )

        {

        User::Leave( ret );

        }

    // Close Setting server session

    settingServer.Close();

    iAddTestCaseTitleToLogName = loggerSettings.iAddTestCaseTitle;

    iStdLog = CStifLogger::NewL( KwvsapsettingstestLogPath,

                                 KwvsapsettingstestLogFile );

    iLog = iStdLog;

    // Sample how to use logging

    _LIT( KLogStart, "wvsapsettingstest logging starts!" );

    iLog->Log( KLogStart );

    }

// -----------------------------------------------------------------------------

// Cwvsapsettingstest::NewL

// Two-phased constructor.

// -----------------------------------------------------------------------------

//

Cwvsapsettingstest* Cwvsapsettingstest::NewL()

    {

    Cwvsapsettingstest* self = new ( ELeave ) Cwvsapsettingstest;

    CleanupStack::PushL( self );

    self->ConstructL();

    CleanupStack::Pop();

    return self;

    }

// Destructor

Cwvsapsettingstest::~Cwvsapsettingstest()

    {

    //class variables

    /* delete iStore;

    iStore = NULL;

    delete iSAP;

    iSAP = NULL;

    delete iTempSAP;

    iTempSAP = NULL; */

    //Stif varaibles

    iLog = NULL;

    delete iStdLog;

    iStdLog = NULL;

    delete iTCLog;

    iTCLog = NULL;

    delete obstestitnf;

    obstestitnf = NULL;

    }

// -----------------------------------------------------------------------------

// Cwvsapsettingstest::InitL

// InitL is used to initialize the Test Module.

// -----------------------------------------------------------------------------

//

TInt Cwvsapsettingstest::InitL(

    TFileName& /*aIniFile*/,

    TBool /*aFirstTime*/ )

    {

    return KErrNone;

    }

// -----------------------------------------------------------------------------

// Cwvsapsettingstest::GetTestCasesL

// GetTestCases is used to inquire test cases from the Test Module. Test

// cases are stored to array of test cases. The Test Framework will be

// the owner of the data in the RPointerArray after GetTestCases return

// and it does the memory deallocation.

// -----------------------------------------------------------------------------

//

TInt Cwvsapsettingstest::GetTestCasesL(

    const TFileName& /*aConfig*/,

    RPointerArray<TTestCaseInfo>& aTestCases )

    {

    // Loop through all test cases and create new

    // TTestCaseInfo items and append items to aTestCase array

    for ( TInt i = 0; Case( i ).iMethod != NULL; i++ )

        {

        // Allocate new TTestCaseInfo from heap for a testcase definition.

        TTestCaseInfo* newCase = new( ELeave ) TTestCaseInfo();

        // PushL TTestCaseInfo to CleanupStack.

        CleanupStack::PushL( newCase );

        // Set number for the testcase.

        // When the testcase is run, this comes as a parameter to RunTestCaseL.

        newCase->iCaseNumber = i;

        // Set title for the test case. This is shown in UI to user.

        newCase->iTitle.Copy( Case( i ).iCaseName );

        // Append TTestCaseInfo to the testcase array. After appended

        // successfully the TTestCaseInfo object is owned (and freed)

        // by the TestServer.

        User::LeaveIfError( aTestCases.Append ( newCase ) );

        // Pop TTestCaseInfo from the CleanupStack.

        CleanupStack::Pop( newCase );

        }

    return KErrNone;

    }

// -----------------------------------------------------------------------------

// Cwvsapsettingstest::RunTestCaseL

// RunTestCaseL is used to run an individual test case specified

// by aTestCase. Test cases that can be run may be requested from

// Test Module by GetTestCases method before calling RunTestCase.

// -----------------------------------------------------------------------------

//

TInt Cwvsapsettingstest::RunTestCaseL(

    const TInt aCaseNumber,

    const TFileName& /*aConfig*/,

    TTestResult& aResult )

    {

    // Return value

    TInt execStatus = KErrNone;

    TestModuleIf().SetBehavior( CTestModuleIf::ETestLeaksHandles );

    // Get the pointer to test case function

    TCaseInfo tmp = Case ( aCaseNumber );

    _LIT( KLogStartTC, "Starting testcase [%S]" );

    iLog->Log( KLogStartTC, &tmp.iCaseName );

    // Check that case number was valid

    if ( tmp.iMethod != NULL )

        {

        //Open new log file with test case title in file name

        if ( iAddTestCaseTitleToLogName )

            {

            //Delete test case logger if exists

            if ( iTCLog )

                {

                delete iTCLog;

                iTCLog = NULL;

                }

            TFileName logFileName;

            TName title;

            TestModuleIf().GetTestCaseTitleL( title );

            logFileName.Format( KwvsapsettingstestLogFileWithTitle, &title );

            iTCLog = CStifLogger::NewL( KwvsapsettingstestLogPath,

                                        logFileName );

            iLog = iTCLog;

            }

        // Valid case was found, call it via function pointer

        iMethod = tmp.iMethod;

        //execStatus  = ( this->*iMethod )( aResult );

        TRAPD( err, execStatus  = ( this->*iMethod )( aResult ) );

        if ( iAddTestCaseTitleToLogName )

            {

            //Restore standard log and destroy test case logger

            iLog = iStdLog;

            delete iTCLog; //Close test case log

            iTCLog = NULL;

            }

        User::LeaveIfError( err );

        }

    else

        {

        // Valid case was not found, return error.

        execStatus = KErrNotFound;

        }

    // Return case execution status (not the result of the case execution)

    return execStatus;

    }

// -----------------------------------------------------------------------------

// Cwvsapsettingstest::OOMTestQueryL

// Used to check if a particular test case should be run in OOM conditions and

// which memory allocations should fail.

// -----------------------------------------------------------------------------

//

TBool Cwvsapsettingstest::OOMTestQueryL(

    const TFileName& /* aTestCaseFile */,

    const TInt aCaseNumber,

    TOOMFailureType& /* aFailureType */,

    TInt& aFirstMemFailure,

    TInt& aLastMemFailure )

    {

    _LIT( KLogOOMTestQueryL, "Cwvsapsettingstest::OOMTestQueryL" );

    iLog->Log( KLogOOMTestQueryL );

    aFirstMemFailure = Case( aCaseNumber ).iFirstMemoryAllocation;

    aLastMemFailure = Case( aCaseNumber ).iLastMemoryAllocation;

    return Case( aCaseNumber ).iIsOOMTest;

    }

// -----------------------------------------------------------------------------

// Cwvsapsettingstest::OOMTestInitializeL

// Used to perform the test environment setup for a particular OOM test case.

// Test Modules may use the initialization file to read parameters for Test

// Module initialization but they can also have their own configure file or

// some other routine to initialize themselves.

//

// NOTE: User may add implementation for OOM test environment initialization.

// Usually no implementation is required.

// -----------------------------------------------------------------------------

//

void Cwvsapsettingstest::OOMTestInitializeL(

    const TFileName& /* aTestCaseFile */,

    const TInt /* aCaseNumber */ )

    {

    }

// -----------------------------------------------------------------------------

// Cwvsapsettingstest::OOMHandleWarningL

// In some cases the heap memory allocation should be skipped, either due to

// problems in the OS code or components used by the code being tested, or even

// inside the tested components which are implemented this way on purpose (by

// design), so it is important to give the tester a way to bypass allocation

// failures.

//

// NOTE: User may add implementation for OOM test warning handling. Usually no

// implementation is required.

// -----------------------------------------------------------------------------

//

void Cwvsapsettingstest::OOMHandleWarningL(

    const TFileName& /* aTestCaseFile */,

    const TInt /* aCaseNumber */,

    TInt& /* aFailNextValue */ )

    {

    }

// -----------------------------------------------------------------------------

// Cwvsapsettingstest::OOMTestFinalizeL

// Used to perform the test environment cleanup for a particular OOM test case.

//

// NOTE: User may add implementation for OOM test environment finalization.

// Usually no implementation is required.

// -----------------------------------------------------------------------------

//

void Cwvsapsettingstest::OOMTestFinalizeL(

    const TFileName& /* aTestCaseFile */,

    const TInt /* aCaseNumber */ )

    {

    }

// ========================== OTHER EXPORTED FUNCTIONS =========================

// -----------------------------------------------------------------------------

// LibEntryL is a polymorphic Dll entry point

// Returns: CTestModuleBase*: Pointer to Test Module object

// -----------------------------------------------------------------------------

//

EXPORT_C CTestModuleBase* LibEntryL()

    {

    return Cwvsapsettingstest::NewL();

    }

// -----------------------------------------------------------------------------

// SetRequirements handles test module parameters(implements evolution

// version 1 for test module's heap and stack sizes configuring).

// Returns: TInt: Symbian error code.

// -----------------------------------------------------------------------------

//

EXPORT_C TInt SetRequirements( CTestModuleParam*& /*aTestModuleParam*/,

                               TUint32& /*aParameterValid*/ )

    {

    /* --------------------------------- NOTE ---------------------------------

    USER PANICS occurs in test thread creation when:

    1) "The panic occurs when the value of the stack size is negative."

    2) "The panic occurs if the minimum heap size specified is less

       than KMinHeapSize".

       KMinHeapSize: "Functions that require a new heap to be allocated will

       either panic, or will reset the required heap size to this value if

       a smaller heap size is specified".

    3) "The panic occurs if the minimum heap size specified is greater than

       the maximum size to which the heap can grow".

    Other:

    1) Make sure that your hardware or Symbian OS is supporting given sizes.

       e.g. Hardware might support only sizes that are divisible by four.

    ------------------------------- NOTE end ------------------------------- */

    // Normally STIF uses default heap and stack sizes for test thread, see:

    // KTestThreadMinHeap, KTestThreadMinHeap and KStackSize.

    // If needed heap and stack sizes can be configured here by user. Remove

    // comments and define sizes.

    /*

        aParameterValid = KStifTestModuleParameterChanged;

        CTestModuleParamVer01* param = CTestModuleParamVer01::NewL();

        // Stack size

        param->iTestThreadStackSize= 16384; // 16K stack

        // Heap sizes

        param->iTestThreadMinHeap = 4096;   // 4K heap min

        param->iTestThreadMaxHeap = 1048576;// 1M heap max

        aTestModuleParam = param;

    */

    return KErrNone;

    }

//  End of File