«1. Обзор
Cucumber — очень мощная среда тестирования, написанная на языке программирования Ruby, который следует методологии BDD (разработка, управляемая поведением). Он позволяет разработчикам писать сценарии использования высокого уровня в виде простого текста, которые могут быть проверены нетехническими заинтересованными сторонами, и превращать их в исполняемые тесты, написанные на языке под названием Gherkin.
Мы уже обсуждали это в другой статье.
А интеграция Cucumber-Spring предназначена для упрощения автоматизации тестирования. Как только мы интегрируем тесты Cucumber со Spring, мы сможем выполнять их вместе со сборкой Maven.
2. Зависимости Maven
Давайте начнем использовать интеграцию Cucumber-Spring, определив зависимости Maven, начиная с зависимости Cucumber-JVM:
<dependency>
<groupId>io.cucumber</groupId>
<artifactId>cucumber-java</artifactId>
<version>6.8.0</version>
<scope>test</scope>
</dependency>
Мы можем найти самую последнюю версию Cucumber JVM здесь.
Далее мы добавим зависимость тестирования JUnit и Cucumber:
<dependency>
<groupId>io.cucumber</groupId>
<artifactId>cucumber-junit</artifactId>
<version>6.8.0</version>
<scope>test</scope>
</dependency>
Самую последнюю версию Cucumber JUnit можно найти здесь.
И, наконец, зависимость Spring и Cucumber:
<dependency>
<groupId>io.cucumber</groupId>
<artifactId>cucumber-spring</artifactId>
<version>6.8.0</version>
<scope>test</scope>
</dependency>
Опять же, мы можем проверить самую последнюю версию Cucumber Spring здесь.
3. Конфигурация
Теперь мы рассмотрим, как мы можем интегрировать Cucumber в приложение Spring.
Сначала мы создадим приложение Spring Boot, для чего мы будем следовать статье о приложении Spring-Boot. Затем мы создадим сервис Spring REST и напишем для него тест Cucumber.
3.1. Контроллер REST
Сначала создадим простой контроллер:
@RestController
public class VersionController {
@GetMapping("/version")
public String getVersion() {
return "1.0";
}
}
3.2. Определения шагов Cucumber
Все, что нам нужно для запуска наших тестов Cucumber с помощью JUnit, — это создать один пустой класс с аннотацией @RunWith(Cucumber.class):
@RunWith(Cucumber.class)
@CucumberOptions(features = "src/test/resources")
public class CucumberIntegrationTest {
}
Мы можем увидеть аннотацию @CucumberOptions там, где мы повторное указание местоположения файла корнишона, который также известен как файл функций. В этот момент Cucumber распознает язык корнишонов; вы можете прочитать больше о Gherkin в статье, упомянутой во введении.
Итак, теперь давайте создадим файл функций Cucumber:
Feature: the version can be retrieved
Scenario: client makes call to GET /version
When the client calls /version
Then the client receives status code of 200
And the client receives server version 1.0
Сценарий состоит в том, чтобы сделать вызов GET для URL / версии службы REST и проверить ответ.
Далее нам нужно создать так называемый связующий код. Это методы, которые связывают один шаг корнишона с кодом Java.
У нас есть варианты здесь — мы можем использовать либо Cucumber Expressions, либо регулярные выражения внутри аннотаций. В нашем случае мы будем придерживаться регулярных выражений:
@When("^the client calls /version$")
public void the_client_issues_GET_version() throws Throwable{
executeGet("http://localhost:8080/version");
}
@Then("^the client receives status code of (\\d+)$")
public void the_client_receives_status_code_of(int statusCode) throws Throwable {
HttpStatus currentStatusCode = latestResponse.getTheResponse().getStatusCode();
assertThat("status code is incorrect : "+
latestResponse.getBody(), currentStatusCode.value(), is(statusCode));
}
@And("^the client receives server version (.+)$")
public void the_client_receives_server_version_body(String version) throws Throwable {
assertThat(latestResponse.getBody(), is(version));
}
Теперь давайте интегрируем тесты Cucumber с контекстом приложения Spring. Для этого мы создадим новый класс и аннотируем его с помощью @SpringBootTest и @CucumberContextConfiguration:
@CucumberContextConfiguration
@SpringBootTest
public class SpringIntegrationTest {
// executeGet implementation
}
Теперь все определения Cucumber можно поместить в отдельный класс Java, который расширяет SpringIntegrationTest:
public class StepDefs extends SpringIntegrationTest {
@When("^the client calls /version$")
public void the_client_issues_GET_version() throws Throwable {
executeGet("http://localhost:8080/version");
}
}
Мы все готово для пробного запуска сейчас.
Наконец, мы можем выполнить быстрый запуск через командную строку, просто запустив mvn clean install -Pintegration — Maven выполнит интеграционные тесты и покажет результаты в консоли.
3 Scenarios ([32m3 passed[0m)
9 Steps ([32m9 passed[0m)
0m1.054s
Tests run: 12, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 9.283 sec - in
com.baeldung.CucumberTest
2016-07-30 06:28:20.142 INFO 732 --- [Thread-2] AnnotationConfigEmbeddedWebApplicationContext :
Closing org.springframework.boot.context.embedded.AnnotationConfigEmbeddedWebApplicationContext:
startup date [Sat Jul 30 06:28:12 CDT 2016]; root of context hierarchy
Results :
Tests run: 12, Failures: 0, Errors: 0, Skipped: 0
4. Заключение
Настроив Cucumber с помощью Spring, будет удобно использовать сконфигурированные Spring компоненты в тестировании BDD. Это простое руководство по интеграции теста Cucumber в приложение Spring-Boot.
Как обычно, все примеры кода, показанные в этом руководстве, доступны на GitHub.