The sample uses Cucumber behavior driven development (BDD) library. The tests combine BDD feature stories with the famous Gherkin syntax and Citrus integration test capabilities. Read about this feature in reference guide
This sample application shows the usage of both Cucumber and Citrus in combination. The sample also uses Cucumber Spring support in order to inject autowired beans to step definitions. The step definitions add @ContextConfiguration(classes = CitrusSpringConfig.class) annotation in order to load the Citrus Spring application context with Cucumber Spring support.
All bean definitions ready for dependency injection using autowiring are located in the default Citrus Spring configuration file classpath:citrus-context.xml. This way step definitions can use @Autowired annotations.
We start with a feature test using JUnit and Cucumber runner.
The test feature is described in a story using Gherkin syntax.
Feature: Todo app Scenario: Add todo entry Given Todo list is empty When I add entry "Code something" Then the number of todo entries should be 1 Scenario: Remove todo entry Given Todo list is empty When I add entry "Remove me" Then the number of todo entries should be 1 When I remove entry "Remove me" Then the todo list should be empty
The steps executed are defined in a separate class where a Citrus test designer is used to build integration test logic.
As you can see we are now able to use Spring @Autowired annotations in order to enable dependency injection. The CitrusSpringConfig class is also loaded as Spring context configuration in order to load the Citrus default Spring application context.
There are some configuration aspects that should be highlighted in particular. The sample uses Cucumber Spring support. Therefore we have included the respective Maven dependency to the project:
Secondly we choose Citrus Spring object factory in cucumber.properties in order to enable Cucumber Spring support in all tests.
These two steps are required to make Citrus work with Cucumber Spring features.
The object factory takes care on creating all step definition instances. The object factory is able to inject @CitrusResource annotated fields in step classes.
The usage of this special object factory is mandatory in order to combine Citrus and Cucumber capabilities.
We also have the usual citrus-context.xml Citrus Spring configuration that is automatically loaded within the object factory. So you can define and use Citrus components as usual within your test. In this sample we use a Http client component to call some REST API on the todo-list application.
You can run the sample on your localhost in order to see Citrus in action. Read the instructions how to run the sample.