Home

bbd-cucumber-gherkin-lib

A Cucumber/Gherkin library for Spring that ships ready-to-use BDD step definitions for REST API and database testing. Add the dependency, configure a Spring test context, and write .feature files — no step implementation boilerplate required.

New here? Start with Getting Started.

---

Setup

Page	What it covers
Getting Started	Full working example from dependency to first passing test
Installation	Maven, Gradle (Groovy and Kotlin DSL), BOM
Configuration	Spring setup, bearer tokens, proxy, SSL, database support
Concepts	Given/When/Then conventions, ScenarioContext, file paths, And/But keywords

Step Reference

Page	What it covers
All Steps — Quick Reference	Every step signature in one table
Given — Authentication	Define users, set Bearer tokens
Given — Request Setup	Base paths, file paths, headers, URL, request body
Given — Context	Store static values, reset context
When — REST Calls	Execute GET/POST/PUT/PATCH/DELETE requests
When — Polling	Poll an endpoint until a condition is met
Then — Validation	Assert status code, response body, headers
Then — Context	Store response fields for later steps
Then — Timing	Wait for async processing, assert execution time
Common — Dates	Generate dynamic past/future dates
Common — Database	Liquibase scripts, SQL execution, CSV result comparison

JSON Validation

Page	What it covers
JSON-Unit	Built-in matchers, custom matchers, flexible comparison (ignore fields/order/extra elements)