Projects:Upgrade to JUnit 4.11/Technical Specification

Contents 1 Introduction 2 Technical Considerations 2.1 JUnit 3x Vs JUnit 4.11 2.2 Location of test cases

Introduction

This project is basically going to upgrade the JUnit libraries to the latest stable version 4.11. This project will cover the refactor of all the test cases to make them use the new notation

For these changes, there are two possible ways to do future test cases :

• a) by using latest stable version 4.11. with new notations.
  • It is recommended to use the 4.11 version because it has a lot of improvements: specific notation, hamcrest,...In this new version it's important that know what class is OBBaseTest.java. OBBaseTest class which can/should be extended by most other test classes which want to make use of the Openbravo test infrastructure.
• b) by using previous version. This version was deprecated.
  • If it is necessary to continue using the deprecated version, "BaseTest" still using the previous notation (Version 3x).

Technical Considerations

JUnit 3x Vs JUnit 4.11

It is recommended to use the 4.11 version because it has a lot of improvements. For example:

• All test methods are annotated with @Test. Unlike JUnit3 tests, you do not need to prefix the method name with "test" (and usually don't).
• Do not have your test classes extend junit.framework.TestCase (directly or indirectly). Usually, tests with JUnit4 do not need to extend anything (which is good, since Java does not support multiple inheritance).
• Do not use any classes in junit.framework or junit.extensions.a) would result in a criteria like this {fieldName: columnName$_identifier, operation: 'equals', value:...}, and b would result in something like: {fieldName: columnName$_identifier, operation: 'iContains', value:...}.
• We can see a summary table:

Features	JUnit 3.x	Junit 4.x
Test annotation	test* pattern	@Test
Run at the beginning	---	@BeforeClass
Run at the end	---	@AfterClass
Run before each test method	override setUp()	@Before
Run after each test method	override tearDown()	@After
Ignore test	change name method, ...	@Ignore
Run at the end	---	@AfterClass
Timeouts	---	@Test(timeout = 1000)
Exceptions	Catch exceptions	@Test(expected =Exception.class)

• You can search all information about JUnit 4.11 in JUnit Wiki: https://github.com/junit-team/junit/wiki

Location of test cases

It have been change the location of the test. Now test case are in different project called OpenbravoTest. There are some changes to explain:

• Now one new project need to be imported in the workspace (by menu File=>Import and then General=>Existing Projects into Workspace). Here they are:

OpenbravoTest    XXX\opensource\openbravo\erp\devel\main\src-test

• Now, compilation of tests is done separately.
• All - jars need to be included in lib/test directory instead of lib directory for create a test case.