Running tests

Introduction

JHipster comes with an extensive set of tests, and each generated application has:

• Integration tests using the Spring Test Context framework.
• UI tests with Karma.js.

Optionally, JHipster can also generate:

• Performance tests with Gatling.
• Behaviour-driven tests with Cucumber
• AngularJS integration tests with Protractor.

We have two goals in generating those tests:

• Help every JHipster user to follow best practices, as we believe tests are a very useful part of every application
• Validate that what is being generated is correct. So even if you don’t plan to use those tests at all, doing just a ./mvnw clean test and gulp test after generating your application is a good way of knowing if everything is fine. You are then free to ignore those tests if you think that testing is a waste of time!

All those tests will be generated in the standard Maven src/test folder.

Integration tests

Integration tests are done with the Spring Test Context framework, and are located in the src/test/java folder. JHipster will launch a specific Spring test context, which will be re-used along all tests, as:

• Your Spring beans should be stateless and thread-safe, and thus can be re-used across your different tests suites.
• Launching just one Spring context for all tests if a lot faster than launching a new Spring context for each test.

This Spring test context will use a specific test database to execute its tests:

• If you use an SQL database, JHipster will launch an in-memory H2 instance in order to use a temporary database for its integration tests. Liquibase will be run automatically, and will generate the database schema.
• If you use Cassandra, JHipster will launch an in-memory Cassandra instance using CassandraUnit.
• If you use MongoDB, JHipster will launch an in-memory MongoDB instance using de.flapdoodle.embed.mongo.
• If you use Elasticsearch, JHipster will launch an in-memory Elasticsearch instance using Spring Data Elasticsearch.

Those tests can be run directly in your IDE, by right-clicking on each test class, or by running ./mvnw clean test (or ./gradlew test if you run Gradle).

Limitations: if the generated entities have validation enabled, JHipster is not enable to generate the correct values depending on the validation rules. Those rules can be so complex, for example if a Regex pattern is used, that this just not possible. In this case, the tests will fail validation, and the default values used in the test will need to changed manually, so they can pass the validation rules.

UI tests

UI tests come in two flavors with JHipster: unit tests with KarmaJS, and integration tests with Protractor. Only KarmaJS is provided by default, but if you want to have a good test coverage of your application, we recommend that you use both tools together.

KarmaJS

UI unit tests are written in Jasmine and run with Karma.js and PhantomJS, and are located in the src/test/javascript/spec folder.

Those tests will mock up the access to the application’s REST endpoints, so you can test your UI layer without having to launch the Java back-end.

• Those tests can be run using gulp test.
• To debug your JS tests, you will need to disable minification and Istanbul covarage on your Javascript files. To do so start Karma with the –debug option, something like this: ./node_modules/karma/bin/karma start src/test/javascript/karma.conf.js --debug, then navigate to Karma debug page and open your Javascript console.
• Tip: if you want to focus on a single test change the module description from describe('...', function() { to fdescribe('...', function() { and Jasmine will run this test only.

Protractor

UI integration tests are done with Protractor, and are located in the src/test/javascript/e2e folder.

Those tests will launch a Web browser and use the application like a real user would do, so you need to have a real application running, with its database set-up.

Those tests can be run using gulp protractor or gulp itest.

Performance tests

Performance tests are done with Gatling, and are located in the src/test/gatling folder. They are generated for each entity, and allows to test each of them with a lot of concurrent user requests.

Gatling tests can be run with Maven, by running ./mvnw gatling:execute. If you have several tests, JHipster will ask which test should be run. When using Gradle you should run ./gradlew gatlingRun -x cleanResources.

Warning! At the moment, those tests do not take into account the validation rules you may have enforced on your entities. Also tests for creating entities that have a required relationship with another entity will fail out of the box. You will anyway need to change those tests, according to your business rules, so here are few tips to improve your tests:

• On your running application, go to the Administration > Logs screen, and put org.springframework in debug mode. You will see the validation errors, for example.
• Use the application normaly and open the Chrome console log: you will be able to see the REST requests with all their parameters, including the HTTP headers.

For running Gatling tests on a microservice application, you have to:

• Run a registry
• Run a gateway
• Run the microservice application
• Then, you can run Gatling tests

Behaviour-driven development (BDD)

Behaviour-driven development (BDD) is available using Cucumber, with its JVM implementation.

Gherkin features will have to be written in your src/test/features directory.