Java2 days 2013-j-treg
Download as PPTX, PDF0 likes526 views
Jtreg is a test framework that supports Java test cases in the form of Java programs with a main method, applets, or shell scripts. It supports TestNG annotations and properties files to define tests. Tests should throw an exception if they fail or return normally if they pass. Jtreg provides options to select tests, set JVM options, specify the JDK, run tests concurrently, and generate reports.
![Jtreg – test cases
• Example:
/* @test
* @summary StringBuffer.isEmpty();
* @run main IsEmptyTest
*/
public class IsEmptyTest {
public static void main(String[] args) {
StringBuffer buffer = new StringBuffer();
if (!buffer.isEmpty()) {
throw new RuntimeException("StringBuffer isEmpty on new object
failed");
}
}
}](https://image.slidesharecdn.com/idyhau0vsru9las7ilmo-signature-6b441b9f50b9081bc248c7cf3b972f38635351cec9b8078ea70cd02a1ad08893-poli-140922180131-phpapp02/85/Java2-days-2013-j-treg-4-320.jpg)
Java2 days 2013-j-treg
- 1. JTreg Martin Toshev Ivan St. Ivanov Mani Sarkar Dmitry Alexandrov
- 2. Jtreg – test cases • A test case is: – Java program with main method – An applet – Shell script (bourne shell) • Jtreg supports TestNG – Via annotation – TEST.properties (demo later…)
- 3. Jtreg – test cases • Pass criteria: – If test fails, testcase should throw an exception – If it succeeds, testcase should return normally • Avoid catching Throwable, Exception or Error
- 4. Jtreg – test cases • Example: /* @test * @summary StringBuffer.isEmpty(); * @run main IsEmptyTest */ public class IsEmptyTest { public static void main(String[] args) { StringBuffer buffer = new StringBuffer(); if (!buffer.isEmpty()) { throw new RuntimeException("StringBuffer isEmpty on new object failed"); } } }
- 5. Jtreg – test description @test – defines a test. Mandatory. @run – tells how to perform a test. @summary – text description. @library – reference library source files. @build – compile class or library before running test
- 6. Jtreg – test description @bug – bug number reference @key – keywords • Shorthands: – @build <classname>+ == @run build <classname>+ – @clean <classname>+ == @run clean <classname>+ – @compile<option>* <arg>+ == @run compile<option>* <arg>+ – @ignore <word>* == @run ignore <word>*
- 7. Jtreg – test description @run – optional tag: – Manual: • @run applet/manual • @run main/manual • @run shell/ manual – Negative tests: • @run main/fail
- 8. Jtreg – testrun and execution • To pass JVM options for tests: – -vmoption | -vmoptions – Many common JVM options (like –server, -d64..) are supported directly • Specified JDK: – -testjdk:<java.home>, -jdk:<java.home> – -compilejdk:<java.home> • Java options – -javaoption | -javaoptions
- 9. Jtreg – JDK-related options • Run test concurrently – -conc:N | -concurrency: N – Cannot be used with –samevm • Timeouts – -timeout:N | -timeoutFactor:N
- 10. Jtreg – test mode options -othervm : Run every test in own vm -samevm : Run all tests in the same vm as the harness -agentvm : use pool of reusable vms Modes can be specified directly in the source file: – @run main/othervm/timeout=300
- 11. Jtreg – test selection options • To execute tests: – -exclude:ProblemList.txt – ProblemList.txt contains list of known failing tests • Select specific tests: – -a | -automatic – -m | -manual – -k:<keyword>
- 12. Jtreg – reporting the results • Different report and work directory – -r: | -reportDir:<dir> – -w: | -workDir:<dir> • Report as xml – -xml
- 13. Jtreg – running tests >jtreg –verbose:summary –jdk:{PRODUCT} <other options> test.java Jtreport/html/report.html Jtreport/text/summary.txt Jtwork/test.jtr
- 14. Jtreg – running tests … or use make tests
- 15. Now let’s have fun!!!