diff -r 000000000000 -r ff3b6d0fd310 phoneclientserver/dialutils/tsrc/public/basic/DialUtilsTests/src/DialUtilsTestsCases.cpp --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/phoneclientserver/dialutils/tsrc/public/basic/DialUtilsTests/src/DialUtilsTestsCases.cpp Tue Feb 02 01:11:09 2010 +0200 @@ -0,0 +1,390 @@ +/* +* 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: Implementation of CDialUtilsTests class. +* +*/ + + + +// INCLUDE FILES +#include +#include "DialUtilsTests.h" + +#include + +// EXTERNAL DATA STRUCTURES +//extern ?external_data; + +// EXTERNAL FUNCTION PROTOTYPES +//extern ?external_function( ?arg_type,?arg_type ); + +// CONSTANTS +//const ?type ?constant_var = ?constant; +// Ordinal of NewL in DialUtils. +const TInt KPhoneDialUtilsNewLOrdinal = 1; + +const TInt KPhoneTelephoneNumberLength = 100; // 48 -> 100 + +_LIT(KPhoneNumber1, "111"); + +// The library to be loaded. +_LIT( KDialUtilsLoadLib, "DialUtils.dll" ); +// 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 =============================== + +// ----------------------------------------------------------------------------- +// CDialUtilsTests::Case +// Returns a test case by number. +// +// This function contains an array of all available test cases +// i.e pair of case name and test function. If case specified by parameter +// aCaseNumber is found from array, then that item is returned. +// +// The reason for this rather complicated function is to specify all the +// test cases only in one place. It is not necessary to understand how +// function pointers to class member functions works when adding new test +// cases. See function body for instructions how to add new test case. +// ----------------------------------------------------------------------------- +// +const TCaseInfo CDialUtilsTests::Case ( + const TInt aCaseNumber ) const + { + + /** + * To add new test cases, implement new test case function and add new + * line to KCases array specify the name of the case and the function + * doing the test case + * In practice, do following + * 1) Make copy of existing test case function and change its name + * and functionality. Note that the function must be added to + * DialUtilsTests.cpp file and to DialUtilsTests.h + * header file. + * + * 2) Add entry to following KCases array either by using: + * + * 2.1: FUNCENTRY or ENTRY macro + * ENTRY macro takes two parameters: test case name and test case + * function name. + * + * FUNCENTRY macro takes only test case function name as a parameter and + * uses that as a test case name and test case function name. + * + * Or + * + * 2.2: OOM_FUNCENTRY or OOM_ENTRY macro. Note that these macros are used + * only with OOM (Out-Of-Memory) testing! + * + * OOM_ENTRY macro takes five parameters: test case name, test case + * function name, TBool which specifies is method supposed to be run using + * OOM conditions, TInt value for first heap memory allocation failure and + * TInt value for last heap memory allocation failure. + * + * OOM_FUNCENTRY macro takes test case function name as a parameter and uses + * that as a test case name, TBool which specifies is method supposed to be + * run using OOM conditions, TInt value for first heap memory allocation + * failure and TInt value for last heap memory allocation failure. + */ + + static TCaseInfoInternal const KCases[] = + { + // To add new test cases, add new items to this array + + // NOTE: When compiled to GCCE, there must be Classname:: + // declaration in front of the method name, e.g. + // CDialUtilsTests::PrintTest. Otherwise the compiler + // gives errors. + + //FUNCENTRY( CDialUtilsTests::PrintTest ), + //ENTRY( "Loop test", CDialUtilsTests::LoopTest ), + ENTRY( "CDialUtilsApiLD", Create ), + ENTRY( "CheckNumber", CheckNumber ), + // Example how to use OOM functionality + //OOM_ENTRY( "Loop test with OOM", CDialUtilsTests::LoopTest, ETrue, 2, 3), + //OOM_FUNCENTRY( CDialUtilsTests::PrintTest, ETrue, 1, 3 ), + }; + + // Verify that case number is valid + if( (TUint) aCaseNumber >= sizeof( KCases ) / + sizeof( TCaseInfoInternal ) ) + { + // Invalid case, construct empty object + TCaseInfo null( (const TText*) L"" ); + null.iMethod = NULL; + null.iIsOOMTest = EFalse; + null.iFirstMemoryAllocation = 0; + null.iLastMemoryAllocation = 0; + return null; + } + + // Construct TCaseInfo object and return it + TCaseInfo tmp ( KCases[ aCaseNumber ].iCaseName ); + tmp.iMethod = KCases[ aCaseNumber ].iMethod; + tmp.iIsOOMTest = KCases[ aCaseNumber ].iIsOOMTest; + tmp.iFirstMemoryAllocation = KCases[ aCaseNumber ].iFirstMemoryAllocation; + tmp.iLastMemoryAllocation = KCases[ aCaseNumber ].iLastMemoryAllocation; + return tmp; + + } + +// ----------------------------------------------------------------------------- +// CDialUtilsTests::PrintTest +// Simple printing to UI test. +// ----------------------------------------------------------------------------- +// +TInt CDialUtilsTests::PrintTest( + TTestResult& aResult ) + { + /* Simple print test */ + _LIT( KPrintTest, "PrintTest" ); + _LIT( KEnter, "Enter" ); + _LIT( KOnGoing, "On-going" ); + _LIT( KExit, "Exit" ); + + TestModuleIf().Printf( 0, KPrintTest, KEnter ); + + TestModuleIf().Printf( 1, KPrintTest, KOnGoing ); + + TestModuleIf().Printf( 0, KPrintTest, KExit ); + + // Test case passed + + // Sets test case result and description(Maximum size is KStifMaxResultDes) + _LIT( KDescription, "PrintTest passed" ); + aResult.SetResult( KErrNone, KDescription ); + + // Case was executed + return KErrNone; + + } + +// ----------------------------------------------------------------------------- +// CDialUtilsTests::LoopTest +// Another printing to UI test. +// ----------------------------------------------------------------------------- +// +TInt CDialUtilsTests::LoopTest( TTestResult& aResult ) + { + + /* Simple print and wait loop */ + _LIT( KState, "State" ); + _LIT( KLooping, "Looping" ); + + TestModuleIf().Printf( 0, KState, KLooping ); + + _LIT( KRunning, "Running" ); + _LIT( KLoop, "%d" ); + for( TInt i=0; i<10; i++) + { + TestModuleIf().Printf( 1, KRunning, KLoop, i); + User::After( 1000000 ); + } + + _LIT( KFinished, "Finished" ); + TestModuleIf().Printf( 0, KState, KFinished ); + + // Test case passed + + // Sets test case result and description(Maximum size is KStifMaxResultDes) + _LIT( KDescription, "LoopTest passed" ); + aResult.SetResult( KErrNone, KDescription ); + + // Case was executed + return KErrNone; + + } + +// ----------------------------------------------------------------------------- +// CDialUtilsTests::Create +// ----------------------------------------------------------------------------- +// +TInt CDialUtilsTests::Create( TTestResult& aResult ) + { + __UHEAP_MARK; + + //Owned DialUtilities library. + CDialUtilsApi* dialUtils; + + // Library loader. + RLibrary iLibrary; + + TInt error = iLibrary.Load( KDialUtilsLoadLib ); + + if ( !error ) + { + // Call function CreateDialUtilsFactoryL() + TInt res = iLibrary.Lookup( KPhoneDialUtilsNewLOrdinal )(); + + CDialUtilsFactory * dialUtilsFactory = + reinterpret_cast< CDialUtilsFactory * >( res ); + + if ( res ) + { + dialUtils = dialUtilsFactory->CDialUtilsApiLD(); + } + + if ( dialUtils ) + { + delete dialUtils; + iLibrary.Close(); + } + + } + __UHEAP_MARKEND; + + + // Sets test case result and description(Maximum size is KStifMaxResultDes) + _LIT( KDescription, "Create done" ); + aResult.SetResult( KErrNone, KDescription ); + + // Case was executed + return KErrNone; + + } + +// ----------------------------------------------------------------------------- +// CDialUtilsTests::CheckNumber +// ----------------------------------------------------------------------------- +// +TInt CDialUtilsTests::CheckNumber( TTestResult& aResult ) + { + __UHEAP_MARK; + + //Owned DialUtilities library. + CDialUtilsApi* dialUtils; + + // Library loader. + RLibrary iLibrary; + + TInt error = iLibrary.Load( KDialUtilsLoadLib ); + + if ( !error ) + { + // Call function CreateDialUtilsFactoryL() + TInt res = iLibrary.Lookup( KPhoneDialUtilsNewLOrdinal )(); + + CDialUtilsFactory * dialUtilsFactory = + reinterpret_cast< CDialUtilsFactory * >( res ); + + if ( res ) + { + dialUtils = dialUtilsFactory->CDialUtilsApiLD(); + } + + if ( dialUtils ) + { + HBufC* number = HBufC::New( KPhoneTelephoneNumberLength ); + + //If allocation succeeds, send number to Dial Utils. + if ( number ) + { + *number = KPhoneNumber1; + TInt err = dialUtils->CheckNumber( *number ); + } + delete number; + } + + if ( dialUtils ) + { + delete dialUtils; + iLibrary.Close(); + } + } + __UHEAP_MARKEND; + // Sets test case result and description(Maximum size is KStifMaxResultDes) + _LIT( KDescription, "Create done" ); + aResult.SetResult( KErrNone, KDescription ); + + // Case was executed + return KErrNone; + + } + + +// ----------------------------------------------------------------------------- +// ?classname::?member_function +// ?implementation_description +// (other items were commented in a header). +// ----------------------------------------------------------------------------- +// +/* +?type ?classname::?member_function( + ?arg_type arg, + ?arg_type arg ) + { + + ?code + + } +*/ + +// ========================== OTHER EXPORTED FUNCTIONS ========================= + +// ----------------------------------------------------------------------------- +// ?function_name implements... +// ?implementation_description. +// Returns: ?value_1: ?description +// ?value_n: ?description +// ?description +// ----------------------------------------------------------------------------- +// +/* +?type ?function_name( + ?arg_type arg, // ?description + ?arg_type arg ) // ?description + { + + ?code + + } +*/ +// End of File