Zum Beispiel ein Test

© OPITZ CONSULTING GmbH 2013 Seite 1Zum Beispiel ein Test
Zum Beispiel ein Test
Beispiele als Grundlage für
Anforderungsanalyse, Spezifikation und Implementierung

Zu meiner Person
Torsten Mandry
Solution Architect
OPITZ CONSULTING Deutschland GmbH
Entwurf und Entwicklung von
Enterprise Java Anwendungen
Anforderungsanalyse und
automatisiertes Testen
E-Mail: torsten.mandry@opitz-consulting.com
Twitter: @torstenmandry
Google: +torsten.mandry

Märkte
Java
SOA
ORACLE
BI/DWH
Outtasking
Kunden
Branchen-
übergreifend
Über 600
Kunden
Leistungs-
angebot
IT-Strategie
Beratung
Implementierung
Betrieb
Training
Fakten
Gründung 1990
400 Mitarbeiter
8 Standorte in
D/PL
Industrie / Versorger /
Telekommunikation
29%
Handel / Logistik /
Dienstleistungen
29%
42%
Öffentliche Auftraggeber /
Banken & Versicherungen /
Vereine & Verbände
© OPITZ CONSULTING GmbH 2011

Agenda
• Erfahrungen und
Erkenntnisse
• Verwendung von
Beispielen
• Vom Beispiel
zum Test
• Akzeptanztest
Frameworks
Foto: arquera@Flickr

Foto: Brady Withers@Flickr
Erfahrungen und Erkenntnisse

Entwicklung eines neuen Features
AnalystAuftraggeber Entwickler
Anforderung(en) Spezifikation Implementierung

Häufiges Ergebnis
Bild: dullhunk@Flickr

Spezifikation wird interpretiert
Auftraggeber Analyst Entwickler

Was läuft schief?
Wir spezifizieren
missverständlich
Wir verstehen „Problem“
des Kunden nicht
Wir kennen die Kriterien
des Kunden nicht
Wir haben kein
gemeinsames
Verständnis
Foto: Horia Varlan@Flickr

Beispiele
Foto: jonny goldstein@Flickr

Foto: bridgells@photobucket.com
?
?
?
Eine übliche Anforderung
Die Afa einer Investition ergibt sich aus dem
Investitionswert, linear verteilt über den
Abschreibungszeitraum, beginnend mit dem
Monat der Aktivierung!

Können Sie uns dazu ein Beispiel nennen?
Wenn wir eine Investition im Wert von 600 TEUR
getätigt haben, die am 01.01.2012 aktiviert wurde,
dann folgt daraus, bei einer Abschreibungsdauer
von 60 Monaten, eine monatliche AfA in Höhe von
10 TEUR und zwar von Jan/2012 bis Dez/2016.

Etwas anders formuliert…
dann folgt daraus
eine monatliche AfA
in Höhe von 10 TEUR
in der Zeit von Jan/2012 bis Dez/2016.
Wenn wir die Afa berechnen
Wir haben eine Investition
im Wert von 600 TEUR
aktiviert am 01.01.2012
und eine Abschreibungsdauer von 60 Monaten
Ausgangssituation / -zustand
Aktion / Ereignis
Erwartetes Ergebnis

Beispiele helfen…
 veranschaulichen / verdeutlichen
 decken Fragen / Lücken auf
 zwingen zum Nachdenken
 führen zu weiteren / detaillierteren Beispielen
 können nachgestellt werden
Foto: therichbrooks@Flickr

…können aber schwierig sein
 ungewohnt / erfordern Übung
 komplexe Zusammenhänge
 viele Einflussfaktoren / Vorbedingungen
 was ist relevant, was nicht?
 Auf das Wesentliche Konzentrieren
Foto: andrewrennie@Flickr

„Nachspezifikation“
„Das haben wir doch alles schon mal besprochen!“
„Alles wie bisher, nur...“
 Grundlegende
Beispiele als Basis
Foto: electricnerve@Flickr

Foto: anieto2k@Flickr
Spezifikation wird durch Beispiele
nicht einfacher…
…sondern besser!

Specification by Example
Beispiele als alleinige Spezifikation
 alle relevante Funktionalität
 vollständig mit Beispielen beschrieben
 keine „Prosa“-Spezifikation mehr notwendig
Foto: VickyvS@flickr.com

„sanfter“ Mittelweg
Beispiele als Ergänzung
zur Prosa-Spezifikation
 Prosa
 Problemstellung / Motivation
 Rahmenbedingungen
 Hintergründe
 Beispiele
 Verdeutlichung / Detaillierung
 Sonder- / Randfälle
 Konkretisierung
Foto: tinyfroglet@Flickr

Beispiele als „Definition of Done“
Wenn alle definierten Beispiele
erfolgreich durchlaufen werden
ist das Feature fertig
Foto: jayneandd@flickr.com

Vom Beispiel zum Test

public class InvestmentPosition extends Position {
…
public void calculateArmortisation() {
if (initiationDate == null)
throw new IllegalStateException("initiation date not set");
if (amount == null)
throw new IllegalStateException("amount not set");
if (project == null)
throw new IllegalStateException("project not set");
if (project.getStartDate() == null || project.getEndDate() == null)
throw new IllegalStateException("project start/end date not set");
armortisation.clear();
int armortisationMonths = ProjectManagementApp.getInstance().getArmortisationMonths();
BigDecimal monthlyAmount = amount.divide(BigDecimal.valueOf(armortisationMonths));
for (int i = 0; i < armortisationMonths; i++) {
Calendar monthYear = new GregorianCalendar();
monthYear.setTime(initiationDate);
monthYear.add(Calendar.MONTH, i);
int month = monthYear.get(Calendar.MONTH) + 1;
int year = monthYear.get(Calendar.YEAR);
armortisation.add(new PositionValue(this, month, year, monthlyAmount));
}
}
…
}
Code Beispiel

Unser Beispiel von eben
dann folgt daraus
eine monatliche AfA
in Höhe von 10 TEUR
in der Zeit von Jan/2012 bis Dez/2016.
Wenn wir die Afa berechnen
Wir haben eine Investition
im Wert von 600 TEUR
aktiviert am 01.01.2012
und eine Abschreibungsdauer von 60 Monaten
Ausgangssituation / -zustand
Aktion / Ereignis
Erwartetes Ergebnis

JUnit Test
@Test
public void calculateArmortisationTest() {
// Gegeben sei eine Investition
InvestmentPosition investment = new InvestmentPosition("any position name");
// im Wert von 600 TEUR
investment.setAmount(BigDecimal.valueOf(600000));
// aktiviert am 01.01.2012
investment.setInitiationDate(new GregorianCalendar(2012, 1 - 1, 1).getTime());
// und eine Abschreibungsdauer von 60 Monaten
ProjectManagementApp.getInstance().setArmortisationMonths(60);
// und noch einiges mehr...
Project project = new Project("any project name");
project.addPosition(investment);
project.setStartDate(new GregorianCalendar(2012, 1 - 1, 1).getTime());
project.setEndDate(new GregorianCalendar(2013, 12 - 1, 31).getTime());
// wenn die Abschreibung berechnet wird
investment.calculateArmortisation();
// dann folgt daraus eine monatliche Abschreibung in Höhe von 10 TEUR
// in der Zeit von 01/2012 bis 12/2016
assertEquals("number of armortisation values", 60, investment.getArmortisation().size());
for (int i = 0; i < 60; i++) {
PositionValue value = investment.getArmortisation().get(i);
Calendar expectedMonthYear = new GregorianCalendar(2012, 1 - 1, 1);
expectedMonthYear.add(Calendar.MONTH, i);
assertEquals(format("value %d - month", i), expectedMonthYear.get(Calendar.MONTH) + 1, value.getMonth());
assertEquals(format("value %d - year", i), expectedMonthYear.get(Calendar.YEAR), value.getYear());
assertEquals(format("value %d - amount", i), BigDecimal.valueOf(10000), value.getAmount());
}
}

JUnit Test
@Test
for (int i = 0; i < 60; i++) {
}
}

JUnit Test
@Test
for (int i = 0; i < 60; i++) {
}
}
assertEquals("number of armortisation values", 60,
investment.getArmortisation().size());
for (int i = 0; i < 60; i++) {
assertEquals(format("value %d - month", i),
expectedMonthYear.get(Calendar.MONTH) + 1, value.getMonth());
assertEquals(format("value %d - year", i),
expectedMonthYear.get(Calendar.YEAR), value.getYear());
assertEquals(format("value %d - amount", i), BigDecimal.valueOf(10000),
value.getAmount());
}

Testdata Factory
erzeugt Domänen-Objekte
gefüllt mit Default-Daten
vollständig valide
Zwei nützliche Helfer
Configurable Entity
ermöglich konfigurieren
Fluent Interface
Foto: florianric@Flickr

Configurable Entity
public class ConfigurableInvestmentPosition extends InvestmentPosition {
public ConfigurableInvestmentPosition(String name) {
super(name);
}
public ConfigurableInvestmentPosition withAmount(double amount) {
this.setAmount(BigDecimal.valueOf(amount));
return this;
}
public ConfigurableInvestmentPosition withInitiationDate(Date initiationDate) {
this.setInitiationDate(initiationDate);
return this;
}
public ConfigurableInvestmentPosition withInitiationDate(int day,
int month, int year) {
this.setInitiationDate(DateBuilder.givenDate(day, month, year).toDate();
return this;
}
…
}

Testdata Factory
public class InvestmentPositionFactory {
private static final String DEFAULT_NAME = "any position name";
private static final double DEFAULT_AMOUNT = 100000;
private static final Date DEFAULT_INITIATION_DATE =
DateBuilder.givenDate(1, 1, 2012).toDate();
private static final String DEFAULT_COST_CENTER = "66666";
public static ConfigurableInvestmentPosition createDefault() {
ConfigurableInvestmentPosition investmentPosition =
new ConfigurableInvestmentPosition(DEFAULT_NAME)
.withAmount(DEFAULT_AMOUNT)
.withInitiationDate(DEFAULT_INITIATION_DATE)
.withCostCenter(DEFAULT_COST_CENTER);
Project project = ProjectFactory.createDefault();
project.addPosition(investmentPosition);
return investmentPosition;
}
}

Besserer JUnit Test
@Test
public void betterCalculateArmortisationTest() {
InvestmentPosition investment = InvestmentPositionFactory.createDefault()
.withAmount(600000)
.withInitiationDate(1, 1, 2012);
assertThat(investment.getArmortisation(), hasConstantAmount(10000));
assertThat(investment.getArmortisation(), containsMonthsFromTo( 1, 2012,
12, 2016));
}
Hamcrest
Matchers

Akzeptanztest Frameworks
http://jbehave.org/ http://cukes.info/
http://www.concordion.org/

http://jbehave.org/

User Story
calculate_armortisation_of_an_investment_position.story
Narrative:
As a user
I want to calculate the armortisation of an investment position
So that I can see the monthly armortisation amounts
Scenario: calculate armortisation for 600000 EUR and 60 months
Given an investment position with amount 600000 EUR initiated on 01.01.2012
And an armortisation time of 60 months
When I calculate the armortisation of the investment position
Then the monthly armortisation amount is 10000 EUR
And the armortisation runs from 01/2012 to 12/2016
Scenario: calculate armortisation for 30000 EUR and 24 months
Given an investment position with amount 30000 EUR initiated on 01.01.2012
And an armortisation time of 24 months
When I calculate the armortisation of the investment position
Then the monthly armortisation amount is 1250 EUR
And the armortisation runs from 01/2012 to 12/2013

Mapped Steps
public class CalculateArmortisationSteps {
private InvestmentPosition investment;
@Given("an investment position with amount $amount EUR initiated on $initiationDate")
public void setupInvestmentPosition(double amount, String initiationDate) {
investment = InvestmentPositionFactory.createDefault()
.withAmount(amount)
.withInitiationDate(initiationDate);
}
@Given("an armortisation time of $months months")
public void setupArmortisationPeriod(int months) {
ProjectManagementApp.getInstance().setArmortisationMonths(months);
}
@When("I calculate the armortisation of the investment position")
public void calculateArmortisation() {
}
@Then("the monthly armortisation amount is $amount EUR")
public void assertMonthlyArmortisationAmount(double amount) {
assertThat(investment.getArmortisation(), hasConstantAmount(amount));
}
…
}

Testergebnis

Fehlerfall

http://www.concordion.org/

Spezifikation
<html xmlns:concordion="http://www.concordion.org/2007/concordion">
<body>
<h1>Calculate armortisation of an investment position</h1>
…
<div class="example">
<h3>Scenario: calculate armortisation for 600000 EUR and 60 months</h3>
<p concordion:execute="#investment = setupInvestmentPosition(#amount, #initiationDate)">
Given an investment position
with amount <strong concordion:set="#amount">600000</strong> EUR
initiated on <strong concordion:set="#initiationDate">01.01.2012</strong></p>
<p concordion:execute="setupArmortisationTime(#months)">
And an armortisation time of <strong concordion:set="#months">60</strong> months</p>
<p>When I <strong concordion:execute="calculateArmortisation(#investment)">calculate
the armortisation of the investment position</strong></p>
<p>Then the monthly armortisation amount is <strong concordion:assertEquals=
"monthlyArmortisationAmount(#investment)">10000,00</strong> EUR</p>
<p>And the armortisation runs
from <strong concordion:assertEquals="armortisationStart(#investment)">01/2012</strong>
to <strong concordion:assertEquals="armortisationEnd(#investment)">12/2016</strong>
…

Fixture
@RunWith(ConcordionRunner.class)
public class CalculateArmortisationOfAnInvestmentPositionFixture {
public InvestmentPosition setupInvestmentPosition(double amount,
String initiationDate) {
return InvestmentPositionFactory.createDefault()
.withAmount(amount)
.withInitiationDate(initiationDate);
}
public void setupArmortisationTime(int months) {
ProjectManagementApp.getInstance().setArmortisationMonths(months);
}
public void calculateArmortisation(InvestmentPosition investment) {
}
…

Fixture
public String armortisationStart(InvestmentPosition investment) {
PositionValue firstValue = getSortedPositionValues(investment).get(0);
return format("%02d/%4d", firstValue.getMonth(), firstValue.getYear());
}
public String armortisationEnd(InvestmentPosition investment) {
List<PositionValue> values = getSortedPositionValues(investment);
PositionValue lastValue = values.get(values.size() - 1);
return format("%02d/%4d", lastValue.getMonth(), lastValue.getYear());
}
public boolean isContinousArmortisation(InvestmentPosition investment) {
return containsMonthsFromTo(armortisationStart(investment),
armortisationEnd(investment)).matches(investment.getArmortisation());
}
…

Testergebnis

Fehlerfall

Lebende Spezifikation
 Beschreibung der vollständigen Funktionalität
 in Form von automatisierten Akzeptanztests

Referenzen
 Code-Beispiele:
https://github.com/torstenmandry/testing-samples
 Torsten Mandry: “Configurable entities with fluent
interface”, http://javandry.blogspot.de/2012/11/configurable-entities-with-
fluent.html, 2012
 Gojko Adzic: „Bridging the Communication Gap –
Specification by Example and Agile Acceptance Testing”,
Neuri Limited, 2011
 JBehave: http://jbehave.org/
 Cucumber: http://cukes.info/
 Concordion: http://www.concordion.org/

Danke für Ihre Aufmerksamkeit

Zum Beispiel ein Test

Empfohlen

Empfohlen

Weitere ähnliche Inhalte

Ähnlich wie Zum Beispiel ein Test

Ähnlich wie Zum Beispiel ein Test (20)

Zum Beispiel ein Test