This article gives an introduction how to use RTest class to create automatic test harness for your application engines. The RTest class provides a simple console window where you can display the test result. Unfortunately it is not possible to use RTest for GUI testing.
Test harness basically is a black box testing It calls a function and then compares the result value with a reference value When the result value is the same with the reference value, the test passes;.. If they are not the same, then the test Fails. RTEST WILL HELP You to Create An Automatic Test Harness; IT Will Display The Test Result on The Screen and Panic IF One of Tests Fails.
USING RTEST
.
The Rtest Class is Declared in E32test.h. The Following Example Shows How To Use Rtest Class.
#include
GLDEF_C TINT E32MAIN ()
{
_LIT (Ktesttitle, "My Testing");
RTEST ITEST (Ktesttitle);
ITEST.TITLE ();
_LIT (KFirstTest, "First Test");
ITEST.START (KFirstTest);
// Your Testing Code ...
ITEST.END ();
ITEST.GETCH ();
ITEST.CLOSE ();
}
The first two lines in the main program, E32Main (), defines an instance of RTest class and gives the title KTestTitle. You can display the title by calling Title () method, like shown in the second line. At the end of the program , all the resources,.
As you see in this example, before going to call start (); and at the end (); do not forget To Call end ()!
Now Let's Start With a Very Simple Test, I.E. To Compare a Defined Integer with a constant. Add the following code between start () and end (). Tint i = 10;
ITEST (i == 10);
The first line defines An Integer Which Has The Value of 10. The Second Line Calls The Operator RTEST: :() That Compares I with 10. This Operator Will Do Not The Condition Is True; And Raise A Paniciff IT Is False. Since this Simple Expurn True; The Test Program Will Run WITHOUT PANIC. IF You Run The Program, You Will See The Emulator WINDOW LIKE Figure 1A.
Figure 1a the emulator what shows the test pass
Figure 1b The emulator That shows the test fails
Next, try to change the condition to the following statement.
ITEST (i == 11);
THE Statement Above Will Return False; thus if you run the program you will get an emulator window like level 1b and your program will panic.
More about rtest: :()
There are Three Variants of Rtest: :() Operator. The First Variant, As You See Above, Requires One Parameter, That Is The Expression To Be Checked.
The Second Variant Has One Additional Parameter, That Is The Line Number Information. In Case of Failure, The Line Number Will Be Displayed on The screen. For example:
ITEST (Expression, 12345);
THIRD HAS One More Additional Parameter, That Is The File Name That Will Be Printed on The Screen WHEN A Failure Mode Occurs. For example:
ITEST (Expression, 12345, L "Testing.cpp");
.
Test Numbering
When your test suite contains of several tests, you can add numbering to them by calling Next () for each test. For example, if you have three tests, you can write a program like the example below._LIT (KFirstTest, "First Test ");
ITEST.START (KFirstTest);
// the first test ...
_LIT (Ksecondtest, "Second Test");
ITEST.NEXT (KSECondTest);
// the second ...
_LIT (Kthirdtest, "Third Test");
ITEST.NEXT (KTHIRDTEST);
// the Third Test ...
ITEST.END ();
The Output of the Example Above Can Be Seen in Figure 2a.
Figure 2a. Test Numbering in rtest.
Figure 2b Nested Numbering in rtest.
You can also have nested numbering by calling start () inside another start (). The folload example show how to have.com. 2b.
_LIT (Ktest1, "Test 1");
ITest.Start (ktest1);
// Test 1
_LIT (Ktest11, "Test 1.1");
ITest.Start (ktest11);
// Test 1.1
_LIT (Ktest12, "Test 1.2");
ITEST.NEXT (KTEST12);
// Test 1.2
_LIT (Ktest121, "Test 1.2.1");
ITest.Start (ktest121);
// Test 1.2.1
_LIT (Ktest122, "Test 1.2.2");
ITEST.NEXT (ktest122);
// Test 1.2.2
_LIT (Ktest123, "Test 1.2.3");
ITEST.NEXT (KTEST123);
// Test 1.2.3
ITEST.END (); // Test 1.2
ITEST.END (); // Test 1
_LIT (Ktest2, "Test 2");
ITEST.NEXT (KTEST2);
// Test 2
ITEST.END ();
I hope this article will give you an understanding how to create test harness using RTest class. There is another alternative to RTest, called Symbian OS Unit (see the link at the end of this article). It is an open source project, based on Junit from Java.
