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:

  1. Analyze the methods in the selected scope.
  2. Create test cases.
  3. Run the created tests using the Track and make assertions functionality to add assertions (see Tracking Object Changes and Creating Assertions for details).
    (info) 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).

Minimum RAM Requirement

UTA requires 2 GB of RAM for bulk creation. If you create multiple test cases for a large code base, we recommend configuring your IDE to use 4 GB of RAM.

Bulk Creation in IntelliJ IDEA

We recommend that you disable the Synchronize files on frame or editor tab activation option in the IntelliJ settings. If enabled, UTA may occasionally abort and then resume the test creation process, which may result in failing to generate one test, or generating a test that is incomplete. To disable the option:

  1. Go to File> Settings in your IntelliJ IDEA.
  2. Select Appearance & Behavior> System Settings.
  3. Disable the Synchronize files on frame or editor tab activation option.

Private methods

UTA creates test for private methods in the selected classes if the Create tests for private methods option in the UTA Preferences is enabled (see Configuring Preferences). By default, the Create tests for private methods option is disabled, since the industry best practice is to test private methods by creating tests for the accessible methods that call them, rather than by creating tests for private methods directly.

Timeout

You can specify the time limit for executing a test suite by configuring the Configure tests with timeout (in ms) option in the UTA Preferences (see Test creation options).

Creating a Test Suite for One File

  1. 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:
       

  2.   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).
       

  3. Click OK . UTA will:
    1. create test cases for all the selected methods in the file (including methods that already have corresponding tests).
    2. run the tests to create assertions.
  4. Review the tests to modify the values and assertions if necessary.

     
  5. 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.

  1. 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).
  2. Click Unit Testing> Create test suite to open the the Unit Test Assistant -Create test suite dialog.

  3. Configure test suite optimization and mock initialization options as described in step 2 in the Creating Test Suites for One File section.
  4. (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).
  5. Click OK. UTA will:
    1. create test cases, skipping the files that are not testable or whose corresponding test classes already exist.
    2. run the tests to create assertions.
  6. 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.
  • No labels