| Excerpt | ||||||
|---|---|---|---|---|---|---|
|
1. Introduction
Even though one of the objectives of is to create a common language between the business experts and the development team, there will always be a certain degree of difference between the natural language and the programming language. Hence comes the reason for having fixtures. Fixtures are the glue between the business expert examples and the software being developed. When running the table,
uses a fixture to mediate between the example expressed in the table and the system under test.
2. Collaboration demands Compromise
The goal of the fixture, is to translate from one language to the other so neither has to compromise their clarity or their design to match the other. The fixture is the compromise. A fixture is any class. It does not have to extend or implement any base class/interface.
3. The fixture name
The fixture name is found right next to the interpreter specification.
...
Since a fixture is a Java class, when LivingDoc executes the example, it will try to match the fixture name with a class name.
4. What about packages?
Usually, Java classes are found inside a package and we can explicitly load a class via the package name.
| An explicitly imported fixture | ||||
|---|---|---|---|---|
|
5. Readability
The problem with packages and namespace and with the classes naming convention, camel casing and no spaces, is that they makes the example less readable for the business expert.
To help readability, we have the following options:
6. Import tables
Import tables are special tables at the beginning of the document.
...
LivingDoc will search for the fixture in each of these packages until it finds a matching class.
7. Humanized name
Event without the package, programmatic naming conventions are not the most readable form for the name of the example. This can be arranged by following the camel casing conventions.
...
| Note |
|---|
When using the humanized version of fixture naming, you must use LD Fixture Conventions Import tables. Explicit package won't work ex: |list of | com.xyz.stuff.the fixture name| |
8. The fixture suffix
If you wish to clearly distinguish between your domain classes and the classes that serve as fixture, you can add the suffix Fixture at the end of the fixture classes name.
...
| Suffix example | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
and
will both match
|
9. Constructor
A fixture can receive parameters during it's construction. You must have a public constructor that matches the numbers of parameters.
...