Overview
With Unit Test Assistant you can easily create test suites by choosing the Create test suite option in the Unit Test Assistant view or in your IDE context menu. When you choose the Create test suite option, UTA will:
- Analyze the methods in the selected scope.
- Create test cases.
Run the created tests using the Track and make assertions functionality to add assertions (see Tracking Object Changes and Creating Assertions for details).
If you are using Eclipse IDE, the Build Automatically option (Project menu> Build Automatically) must be enabled for assertions to be added. If the option is disabled, no assertions are added during the test run.
To customize test cases created by UTA, review the values and assertions in the test code and update them as necessary. In addition, you can re-run the tests with the Run option to enhance your tests cases using UTA recommendations (see Executing Unit Tests with Unit Test Assistant).
Creating a Test Suite for One File
Open the Unit Test Assistant - Create test suite dialog in one of the following ways:
Select a class in the editor and click the Create test suite action link in the Unit Test Assistant view:
Right-click a file in Project Explorer and select Unit Testing> Create test suite from the context menu:
Configure the test creation options.
Optimize test suite for: - Allows you to specify your priorities for creating tests for the selected methods.
- Maximum code coverage - UTA will create as many tests as is required to cover the maximum possible number of method execution paths. Enabling this option will help you achieve the highest coverage rate, but the complexity and potential overlap of test cases may impact their maintenance.
- Test suite maintainability - UTA will create fewer tests only to cover the main execution paths. Enabling this option will help you create less complex and better maintainable tests, but the coverage rate will be lower.Mock initialization - Allows you to specify how you want mocks to be initialized.
- Configure within test method - Initializes mocks by declaring and initializing the object under test and its dependencies within the test method.
- Use @InjectMocks - Initializes mocks by using the @InjectMocks annotation to mark fields on which mock injection should be performed and the @Mock annotation for dependencies. See Configuring Mock Initialization for details.Methods to create test cases for: Allows you to specify the methods for which you want to create test cases (you can use the Select All or Deselect All buttons for your convenience).
- Click OK . UTA will:
- create test cases for all the selected methods in the file (including methods that already have corresponding tests).
- run the tests to create assertions.
- Review the tests to modify the values and assertions if necessary.
- Run the test with UTA to collect coverage information and recommendations for possible improvements (see Executing Unit Tests with Unit Test Assistant).
Creating a Test Suite for Multiple Files
UTA can create test cases in bulk – for more than one file at once.
- Right-click the files, package(s), or project(s) for which you want to create test cases. Also, you can select individual methods if they are in the same class (if you select methods from different classes, or an individual method and a class or package, test cases will not be created).
Click Unit Testing> Create test suite to open the the Unit Test Assistant -Create test suite dialog.
- Configure test suite optimization and mock initialization options as described in step 2 in the Creating Test Suites for One File section.
- (Optional) Hover over the License usage summary option to display an estimated number of tokens required to create test cases for the selected resources. Once the test are generated, the summary dialog will show how many tokens were actually consumed, and how many remain (see Licensing).
- Click OK. UTA will:
- create test cases, skipping the files that are not testable or whose corresponding test classes already exist.
- run the tests to create assertions.
- Run the tests with UTA to collect coverage information and recommendations for possible improvements (see Executing Unit Tests with Unit Test Assistant).
Licensing
Creating test cases for more than one file requires the 'Bulk creation' license feature. The feature provides license tokens that monitor the number of files for which test cases are generated (the number of tokens depends on your license agreement). When creating test cases for multiple files, UTA consumes one token per .java file you selected.
- Files for which UTA does not generate any test cases (for example, interfaces or abstract classes) do not consume a token.
- Once a token has been consumed for a given java file, regenerating tests for that java file doesn't consume another token, even if the first test is deleted.