CSC/ECE 517 Fall 2014/ch1b 29 ry

jBehave Introduction

jBehave is an open source BDD Testing framework written in Java. (JBehave is an open-source, Java-based [Behaviour-driven development] BDD) framework) It was originally developed by Dan North in 2003 to compare TDD to BDD [1]. jBehave is primarily a Java API but it also has been expanded to include an Eclipse plugin as well as a Maven plugin. Which in the background uses Selenium to do behavioral test cases against a web site.

Background: TDD vs BDD

Behaviour-Driven Development was conceived as an improvement to the thought processes behind [Test-Driven Develpoment] (TDD) and [Acceptance Test-Driven Planning [1]].[2].

TDD:

Test-driven development, which is often associated with [ExtremeProgramming], is a software development technique which combines test-first development and Refactoring. TDD can be described at a high level as a process that iteratively follows the steps below:

1. Add a test that tests for a required functionality. 2. Get the test to fail. 3. Write just enough code for the test to pass. 4. Refactor the code to acceptable standards.

Image - [1]

At each step along the process for TDD, the developer has to ensure that the new code which has been added does not affect previously written functionality, i.e. all tests written upto that point have to be re-run to ensure that everything is working as expected. TDD offers benefits such as: [3]

-Maintainable, flexible and easily extensible code. -Unparalleled test coverage and a streamlined codebase. -A cleaner interface, since the [API]s produced are written from an API-User perspective. -Better code quality through the emphasis on Refactoring. -Executable documentation in the form of tests.

BDD:

Behaviour-Driven Development is a development paradigm which aims to make development practices more accessible and intuitive to newcomers and experts alike, but by shifting the vocabulary from being test-based to behaviour-based. It emphasizes communication and automation as equal goals[4]. In essence, BDD Tests focus more on the features, as opposed to the actual results of the tests. Consequently, BDD helps to design the software, not just test it.[5]

BDD aims to bridge the gap between the differing views of computer systems held by business users and technologists by using terminology focused on the behavioural aspects of the system rather than testing. Its focus is on minimizing the hurdles between specification, design, implementation and confirmation of the behaviour of a system, thus enabling the incremental delivery of business systems, and in particular in allowing teams new to agile development to quickly get up to speed using extremely productive techniques.[6]

---

In the words of Dan North, the founder of BDD:[7]

I had a problem. While using and teaching agile practices like test-driven development (TDD) on projects in different environments, I kept coming across the same confusion and misunderstandings. Programmers wanted to know where to start, what to test and what not to test, how much to test in one go, what to call their tests, and how to understand why a test fails.

The deeper I got into TDD, the more I felt that my own journey had been less of a wax-on, wax-off process of gradual mastery than a series of blind alleys. I remember thinking “If only someone had told me that!” far more often than I thought “Wow, a door has opened.” I decided it must be possible to present TDD in a way that gets straight to the good stuff and avoids all the pitfalls.

My response is behaviour-driven development (BDD). It has evolved out of established agile practices and is designed to make them more accessible and effective for teams new to agile software delivery. Over time, BDD has grown to encompass the wider picture of agile analysis and automated acceptance testing.

---

BDD revolves around the concept of a Story>/b>, which represents an automatically executable description of a requirement and its business benefit [8][9]. At its core a Story comprises of one or more Scenarios, each of which represents a concrete example of the behaviour of the system. Each Scenario comprises of a number of executable steps. These Steps can be of three types:

Given - Provides the context (precondition) to an event When - Represents the occurence of the event Then - Occurence of the event

These are known as BDD Keywords. Another keyword And can also be used; 'And' can be thought of as merely a substitution for the previously used keyword. A scenario can contain any number of steps, and steps of the same type can follow each other. The following example demonstrates the concept of a story:

---

Story: User login

 In order to access my home page
 As a user
 I want to use my username and password to login

Scenario: User uses an incorrect password

 Given a username 'direwolf'
 And a password 'lannister'

 When the user logs in with username and password

 Then the login page should be displayed

Scenario: User uses a correct password

 Given a username 'direwolf'
 And a password 'stark'

 When the user logs in with username and password

 Then the home page should be displayed

---

As shown in the example, BDD tests use a verbose style so that they can almost be read as sentences. The ability to read a test like a sentence is a cognitive shift in how developers thinks about their tests. Reading their tests fluidly will enable them to naturally write better and more comprehensive tests that actual model and help shape the behaviour of a system.[5]

BDD tools such as [Cspec], [CppSpec], [NBehave], [Cuke4Duke], [PHPSpec], [behave] and [Cucumber] now exist to support behaviour-driven development in several popular languages. Jbehave is one such framework for Java which was created by BDD founder Dan North as an implementation of his newly conceived development principles.

Features

Pure java implementation Junit integration Maven integration - allows automation of jBehave tasks at build time Ant integration Text based user stories can be written in: JBehave syntax, Gherkin syntax, or Groovy (Rob/Yogesh: Can we find examples of these?) Selenium Integration - allows automation of web based UI test cases Dependency Injection support allowing both configuration and Steps instances composed via your favourite container (Guice, Needle, PicoContainer, Spring, Weld) [4] WebRunner - a simple web-based non-technical interface that allows non-technical team members (Execs, BAs, QAs etc... ) to make contributions by generating stories. Run as a simple Jetty Web Service application from maven. Eclipse IDE Integration [2] Syntax highlighting Step hyperlink detection and link to corresponding Java method Step autocompletion Step validation, detecting both unimplemented steps and ambiguous steps, i.e. matching multiple methods

Figure 1. jBehave Plugin for Eclipse IDE

Usage Details

There are five basic steps to using jBehave: (1) Setup a configuration file, called a “textual story” with all of your english verbiage in it. This textual story is very similar to Cucumber test cases. (2) Next, write a POJO and add annotations to it that match the actions in your “textual story”. (3) (only once) Write a simple configuration file that defines the relationship between your textual story file and your POJO, for instance, one-to-one. (4) Run your test case. (5) Go over the outputted review files.

Begin by writing a “textual story” that tells a narrative Given a cholesterol calculator When a patient has a total cholesterol of 201 (mg/dL) and a HDL of 74 and triglycerides of 44 Then the patient has LDL of 118.2

Note: for reference the calculation in use: LDL = total cholesterol – HDL – (triglycerides/5)

Next compose a POJO class that has annotations that match the first (bolded above) words from the textual story. These bolded terms will actually become the annotations in the POJO and will become the action steps taken by jBehave to run the test case. jBehave will actually use these key-words in the annotation and the story to look up the next action from the Pojo to run.

public class CalculateLDLTest { private LDLCalculator ldlCalculator; private float result;

@Given (“a cholesterol calculator”) public void init(){ ldlCalculator = new LDLCalculator(); } @When (“a patient has a total cholesterol of $total and a HDL of $hdl and triglycerides of $tri”) public void populateValues(float total, float hdl, float tri){ result = ldlCalculator.calculate(total, hdl, tri); }

@Then (“the patient has LDL of $ldl”) public void checkResult(float ldl){ assert.assertEquals(ldl, result, “Did not get the expected BMI”); } }

Additionally, the story and pojo need to be wired together. This is done with a simple configuration pojo, that tells jBehave about the nature of the relationship between the story and the annotated Pojo. // Specify the mapping between the story and the pojo public class RunCholesterol extends JUnitStory {

   @Override
   public Configuration configuration() {
       return new MostUsefulConfiguration()
           .useStoryLoader(new LoadFromClasspath(this.getClass()))  
           .useStoryReporterBuilder(new StoryReporterBuilder().withDefaultFormats().withFormats(Format.CONSOLE, Format.TXT)); 
   }

   // Here we specify the CalculateLDLTest classes
   @Override
   public InjectableStepsFactory stepsFactory() {        
       return new InstanceStepsFactory(configuration(), new CalculateLDLTest());
   }

}

Run the tests using the Eclipse Junit plugin or maven > mvn clean install [ Rob: put output here ] Review the output for the results

WebRunner

WebRunner is an application developed using Java Standard Edition (SE) that allows non-technical business resources to contribute user stories concurrently. The system is run from a web application server such as Jetty or Tomcat. It can be easily started via running the maven target, “mvn jetty:run-war -Djbehave.webrunner.version=4.6” from inside the jbehave-web/web-runner folder inside the git repo. See Figure 2: WebRunner application to see a running example of WebRunner, where users can submit, run, or view stories from the simple web interface.

How to build and run jBehave

Build the latest code using maven: details outlined http://jbehave.org/reference/stable/running-examples.html

Selenium Example

Example: Yogesh -- I’d like to see/do a selenium example. there are plenty of examples (http://jbehave.org/reference/web/stable/using-selenium.html)

References

[1] http://www.slideshare.net/shadrik/bdd-with-java-8323915 [2] http://jbehave.org/eclipse-integration.html [3] http://jbehave.org/reference/web/stable/using-web-runner.html [4] http://jbehave.org/reference/stable/features.html

[1]http://testdrivendeveloper.com/2008/04/02/AcceptanceTestDrivenDevelopmentExplained.aspx [2]http://behaviour-driven.org/ [3]http://www.base36.com/2012/07/benefits-of-test-driven-development/ [4]http://jbehave.org/introduction.html [5]https://joshldavis.com/2013/05/27/difference-between-tdd-and-bdd/ [6]http://behaviour-driven.org/Introduction [7]http://dannorth.net/introducing-bdd/ [8]http://jbehave.org/reference/stable/concepts.html [9]http://dannorth.net/whats-in-a-story/