Writing Acceptance Tests for Openshift and MongoDb Applications

public class Application {

    @Feature
    public class Books {
        public class ListAllBooks {}
    }

}

Next step is creating the PageObject class. Remember that PageObject pattern models web application's user interface as object. So let's see the html file to inspect what elements must be mapped.

<table id="listBooks" cellspacing="0" cellpadding="5">
<caption>List of Available Books</caption>
<tr>
<th>Title</th>
<th>Number Of Pages</th>
<th>Cover</th>
</tr>
                .....
</table>

The most important thing here is that table tag has an id named listBooks which will be used in PageObject class to get a reference to its parameters and data. Let's write the page object:

@DefaultUrl("http://books-lordofthejars.rhcloud.com/GetAllBooks")
public class FindAllBooksPage extends PageObject {

@FindBy(id = "listBooks")
private WebElement tableBooks;

public FindAllBooksPage(WebDriver driver) {
super(driver);
}

public TableWebElement getBooksTable() {

Map<String, List<String>> tableValues = new HashMap<String, List<String>>();

tableValues.put("titles", titles());
tableValues.put("numberOfPages", numberOfPages());
tableValues.put("covers", coversUrl());

return new TableWebElement(tableValues);
}

private List<String> titles() {
List<WebElement> namesWebElement = tableBooks.findElements(By.className("title"));
return with(namesWebElement).convert(toStringValue());

}

private List<String> numberOfPages() {
List<WebElement> numberOfPagesWebElement = tableBooks.findElements(By.className("numberOfPages"));
return with(numberOfPagesWebElement).convert(toStringValue());
}

private List<String> coversUrl() {
List<WebElement> coverUrlWebElement = tableBooks.findElements(By.className("cover"));
return with(coverUrlWebElement).convert(toImageUrl());
}

private Converter<WebElement, String> toImageUrl() {
return new Converter<WebElement, String>() {

@Override
public String convert(WebElement from) {
WebElement imgTag = from.findElement(By.tagName("img"));
return imgTag.getAttribute("src");
}
};
}

private Converter<WebElement, String> toStringValue() {
return new Converter<WebElement, String>() {

@Override
public String convert(WebElement from) {
return from.getText();
}
};
}

}

Using @DefaultUrl we are setting which URL is being mapped, with @FindBy we map the web element with id listBooks, and finally getBooksTable() method which returns the content of generated html table.

The next thing to do is implementing the steps class; in this simple case we only need two steps, the first one that opens the GetAllBooks page, and the other one which asserts that table contains the expected elements.

public class EndUserSteps extends ScenarioSteps {

public EndUserSteps(Pages pages) {
super(pages);
}

private static final long serialVersionUID = 1L;

@Step
public void should_obtain_all_inserted_books() {
TableWebElement booksTable = onFindAllBooksPage().getBooksTable();

List<String> titles = booksTable.getColumn("titles");
assertThat(titles, hasItems("The Lord Of The Rings", "The Hobbit"));

List<String> numberOfPages = booksTable.getColumn("numberOfPages");
assertThat(numberOfPages, hasItems("1299", "293"));

List<String> covers = booksTable.getColumn("covers");
assertThat(covers, hasItems("http://upload.wikimedia.org/wikipedia/en/6/62/Jrrt_lotr_cover_design.jpg", "http://upload.wikimedia.org/wikipedia/en/4/4a/TheHobbit_FirstEdition.jpg"));
}

@Step
public void open_find_all_page() {
onFindAllBooksPage().open();
}

private FindAllBooksPage onFindAllBooksPage() {
return getPages().currentPageAt(FindAllBooksPage.class);
}

}

And finally class for validating the acceptance criteria:

@Story(Application.Books.ListAllBooks.class)
@RunWith(ThucydidesRunner.class)
public class FindBooksStory {

private final MongoDbConfiguration mongoDbConfiguration = mongoDb()
.host("127.0.0.1").databaseName("books")
.username(MongoDbConstants.USERNAME)
.password(MongoDbConstants.PASSWORD).build();

@Rule
public final MongoDbRule mongoDbRule = newMongoDbRule().configure(
mongoDbConfiguration).build();

@Managed(uniqueSession = true)
public WebDriver webdriver;

@ManagedPages(defaultUrl = "http://books-lordofthejars.rhcloud.com")
public Pages pages;

@Steps
public EndUserSteps endUserSteps;

@Test
@UsingDataSet(locations = "books.json", loadStrategy = LoadStrategyEnum.CLEAN_INSERT)
public void finding_all_books_should_return_all_available_books() {
endUserSteps.open_find_all_page();
endUserSteps.should_obtain_all_inserted_books();
}

}

{
"book":[
{
    "title": "The Lord Of The Rings",
    "numberOfPages": "1299",
    "cover": "http:\/\/upload.wikimedia.org\/wikipedia\/en\/6\/62\/Jrrt_lotr_cover_design.jpg"
},
{
"title": "The Hobbit",
"numberOfPages": "293",
"cover": "http:\/\/upload.wikimedia.org\/wikipedia\/en\/4\/4a\/TheHobbit_FirstEdition.jpg"
}
]
}