--- /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 <e32math.h>
+#include "DialUtilsTests.h"
+
+#include <DialUtils.h>
+
+// 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