Control Tutorial: Step 2: Create a Test Class

In this step you will create a test class that will run tests on the control you just created. You can put tests in a separate source folder for better organization and so it's easier to exclude them later during packaging for production. Better yet, you can put the tests in a completely separate project, provided that the project dependencies are correctly configured. But, in this simple case, we will leave the control and test class in the same project.

In this section, you will:

Create a new Source Folder and Package
Create the Test Class

To Create a New Source Folder and Package

Here, you'll create a new source folder to hold the test class.

Select File > New> Other.
In the New dialog, open the Java node, select Source Folder, and click Next.
In the Folder name field, enter src-test and click Finish.
On the Package Explorer view, right-click the src-test folder and select New > Package.
In the New Java Package dialog, in the Name field, enter sharedcontrols.test and click Finish.

To Create the Test Class

In this step you will create the class that tests your control.

On the Package Explorer view, right-click the sharedcontrol.test package and select New > Other.
In the New dialog open nodes Java > JUnit, select JUnit Test Case, and click Next.
In the New Test Case dialog, click Yes to add the junit.jar to the build path.
In the New JUnit Test Case dialog, in the Name field, enter EmployeeControlTestCase.
In the Superclass field, enter org.apache.beehive.controls.test.junit.ControlTestCase.
(Hint: in the Superclass field enter ControlTestCase and press Ctrl+Space Bar to fill in the remaining package names.)
In the Class under test field, enter sharedcontrols.EmployeeControl.
Click Next.
Click Select All and then Finish.

Edit the source code for EmployeeTestCase.java so it appears as follows. Code to add appears in bold.

package sharedcontrols.test;
 
import org.apache.beehive.controls.api.bean.Control;
import org.apache.beehive.controls.test.junit.ControlTestCase;
 
public class EmployeeControlTestCase extends ControlTestCase {
 
    @Control
    sharedcontrols.EmployeeControl employeeControl;  
   	
    /*
     * Test method for 'sharedcontrols.EmployeeControl.getManagerNames()'
     */
    public void testGetManagerNames() {
        String[] mgrs = employeeControl.getManagerNames();
        assertNotNull("Didn't find managers!", mgrs);
        assertTrue("Found wrong number of managers!", 
                    mgrs.length == 3); 
    }
}

(Notice that you were able to use the control simply by using the @Control field notation and didn't have to programmatically instantiate it yourself. That's the magic of ControlTestCase. By extending that class you inherit its setUp() and tearDown() methods that do the declarative wire-up for you.)

Select Ctrl+Shift+S to save your work.