Initial commit
This commit is contained in:
commit
bd1d2e051c
|
@ -0,0 +1,29 @@
|
|||
# EditorConfig is awesome: https://EditorConfig.org
|
||||
|
||||
# top-most EditorConfig file
|
||||
root = true
|
||||
|
||||
# Default formatting Unix-style newlines with a newline ending every file
|
||||
[*]
|
||||
charset = utf-8
|
||||
end_of_line = lf
|
||||
insert_final_newline = true
|
||||
trim_trailing_whitespace = true
|
||||
indent_style = space
|
||||
indent_size = 4
|
||||
|
||||
# do not trim trailing whitespace in markdown files
|
||||
[*.md]
|
||||
trim_trailing_whitespace = false
|
||||
|
||||
# explicit 4 space indentation
|
||||
[*.py]
|
||||
indent_size = 4
|
||||
|
||||
# explicit 2 space indentation
|
||||
[*.{json, yml, yaml, xml, ddl, sql}]
|
||||
indent_size = 2
|
||||
|
||||
# windows specific files
|
||||
[*.{bat, cmd}]
|
||||
end_of_line = crlf
|
|
@ -0,0 +1,5 @@
|
|||
#
|
||||
# https://help.github.com/articles/dealing-with-line-endings/
|
||||
#
|
||||
# These are explicitly windows files and should use crlf
|
||||
*.bat text eol=crlf
|
|
@ -0,0 +1,14 @@
|
|||
{
|
||||
"tests": [
|
||||
{
|
||||
"name": "Run PA unit tests",
|
||||
"setup": "",
|
||||
"run": "gradle :Herzschlag:autograding --info",
|
||||
"input": "",
|
||||
"output": "",
|
||||
"comparison": "included",
|
||||
"timeout": 10,
|
||||
"points": 2
|
||||
}
|
||||
]
|
||||
}
|
|
@ -0,0 +1,15 @@
|
|||
name: GitHub Classroom Workflow
|
||||
|
||||
on: [push]
|
||||
|
||||
jobs:
|
||||
build:
|
||||
name: Autograding
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v2
|
||||
- name: Set up JDK 17
|
||||
uses: actions/setup-java@v1
|
||||
with:
|
||||
java-version: '17'
|
||||
- uses: education/autograding@v1
|
|
@ -0,0 +1,70 @@
|
|||
# InelliJ IDEA files
|
||||
*.iml
|
||||
*.ipr
|
||||
*.ids
|
||||
*.iws
|
||||
.idea/
|
||||
|
||||
# Eclipse files
|
||||
.project
|
||||
.metadata
|
||||
.classpath
|
||||
.settings/
|
||||
.loadpath
|
||||
bin/
|
||||
|
||||
# Netbeans
|
||||
nbactions.xml
|
||||
|
||||
# Visual Studio Code
|
||||
.vscode
|
||||
|
||||
# Maven
|
||||
target/
|
||||
|
||||
# gradle files
|
||||
.gradle
|
||||
build/
|
||||
|
||||
# ignore logfiles
|
||||
*.log*
|
||||
|
||||
# OS dependant files
|
||||
.DS_Store
|
||||
.Spotlight-V100
|
||||
.Trashes
|
||||
Thumbs.db
|
||||
Desktop.ini
|
||||
*~
|
||||
# Thumbnails
|
||||
._*
|
||||
|
||||
# compiled files
|
||||
*.com
|
||||
*.class
|
||||
*.dll
|
||||
*.exe
|
||||
*.o
|
||||
*.so
|
||||
|
||||
# packages
|
||||
*.7z
|
||||
#*.jar
|
||||
*.rar
|
||||
*.zip
|
||||
*.gz
|
||||
*.bzip
|
||||
*.xz
|
||||
*.lzma
|
||||
*~$*
|
||||
|
||||
# package managment formats
|
||||
*.dmg
|
||||
*.xpi
|
||||
*.gem
|
||||
*.egg
|
||||
*.deb
|
||||
*.rpm
|
||||
|
||||
# databases
|
||||
*.sqlite
|
|
@ -0,0 +1,210 @@
|
|||
:source-highlighter: coderay
|
||||
:icons: font
|
||||
:experimental:
|
||||
:!sectnums:
|
||||
:imagesdir: ./images/
|
||||
:handout: ./code/
|
||||
|
||||
:logo: IT.PROG2 -
|
||||
ifdef::backend-html5[]
|
||||
:logo: image:PROG2-300x300.png[IT.PROG2,100,100,role=right,fit=none,position=top right]
|
||||
endif::[]
|
||||
ifdef::backend-pdf[]
|
||||
:logo:
|
||||
endif::[]
|
||||
ifdef::env-github[]
|
||||
:tip-caption: :bulb:
|
||||
:note-caption: :information_source:
|
||||
:important-caption: :heavy_exclamation_mark:
|
||||
:caution-caption: :fire:
|
||||
:warning-caption: :warning:
|
||||
endif::[]
|
||||
|
||||
// references
|
||||
:mockito-home: http://mockito.org/[Mockito Homepage]
|
||||
:mockito-docs: http://mockito.github.io/mockito/docs/current/org/mockito/Mockito.html[Mockito Dokumentation]
|
||||
:mockito-annotations: https://www.baeldung.com/mockito-annotations[Konkrete Beispiele mit Mockito]
|
||||
:planet-wissen-herz: https://www.planet-wissen.de/video-das-herz--wie-funktioniert-es-100.html[Planet Wissen]
|
||||
:maven-central: https://search.maven.org/search?q=a:mockito-core[MavenCentral]
|
||||
|
||||
|
||||
= {logo} Praktikum Mock-Testing
|
||||
|
||||
== Einleitung
|
||||
|
||||
Ziele dieses Praktikums sind:
|
||||
|
||||
* Anwenden von erweiterten Testverfahren (Mocks, Spys)
|
||||
* Übung des Umgangs mit Mockito
|
||||
|
||||
=== Voraussetzungen
|
||||
|
||||
* Vorlesung Mock-Testing
|
||||
|
||||
=== Tooling
|
||||
* Installiertes JDK 17+.
|
||||
* Gradle 7.4+
|
||||
* Mockito ab Version 2.
|
||||
|
||||
=== Struktur
|
||||
Das Praktikum enthält verschiedene Arten von Aufgaben, die wie folgt gekennzeichnet sind:
|
||||
|
||||
[TU] – Theoretische Übung::
|
||||
Dient der Repetition bzw. Vertiefung des Stoffes aus der Vorlesung und als Vorbereitung für die nachfolgenden Übungen.
|
||||
|
||||
[PU] – Praktische Übung::
|
||||
Übungsaufgaben zur praktischen Vertiefung von Teilaspekten des behandelten Themas.
|
||||
|
||||
[PA] – Pflichtaufgabe::
|
||||
Übergreifende Aufgabe zum Abschluss. Das Lösen dieser Aufgaben ist Pflicht. Sie muss bis zum definierten Zeitpunkt abgegeben werden, wird bewertet und ist Teil der Vornote.
|
||||
|
||||
|
||||
=== Zeit und Bewertung
|
||||
Für das Praktikum stehen zwei Wochen in den Praktikumslektionen und im Selbststudium zur Verfügung.
|
||||
|
||||
Je nach Kenntniss- und Erfahrungsstufe benötigen Sie mehr oder weniger Zeit.
|
||||
Nutzen Sie die Gelegenheit, den Stoff zu vertiefen, auszuprobieren, Fragen zu stellen und Lösungen zu diskutieren (Intensive-Track).
|
||||
|
||||
Falls Sie das Thema schon beherrschen, müssen Sie nur die Pflichtaufgaben lösen und bis zum angegebenen Zeitpunkt abgeben (Fast-Track).
|
||||
|
||||
Sie können die Lösungen der Textaufgaben in diesem Praktikum direkt in den Java-Files als Kommentar hinzufügen - oder als Markdown-File neben den Java-Files.
|
||||
|
||||
=== Referenzen
|
||||
|
||||
* link:{handout}[Praktikumsverzeichnis – Quellcode, Projektstruktur]
|
||||
* link:{mockito-home}
|
||||
* link:{mockito-docs}
|
||||
* link:{mockito-annotations}
|
||||
|
||||
:sectnums:
|
||||
:sectnumlevels: 2
|
||||
// Beginn des Aufgabenblocks
|
||||
|
||||
== Herz
|
||||
Das menschliche Herz ist ein lebenswichtiges und kompliziertes Organ.
|
||||
Nur, wenn seine einzelnen "Bauteile" richtig koordiniert werden, kann es eine ausreichende Blutversorgung unseres Körpers gewährleisten.
|
||||
|
||||
Da es beim Mocking um das Testen des Verhaltens eines Objekts geht, bietet sich das Herz als Beispiel an.
|
||||
Darum simulieren wir in dieser Aufgabe ein menschliches Herz.
|
||||
Eine kurze Erklärung der Funktionsweise des Herzens gibt es auf link:{planet-wissen-herz}.
|
||||
|
||||
Einige Fakten über das Herz, die bei dieser Aufgabe helfen können -
|
||||
im Projekt werden englische Begriffe verwendet, die Sie in Klammern finden:
|
||||
|
||||
* Das Herz (Heart) besteht aus zwei Hälften.
|
||||
* Jede Herzhälfte (Half) hat einen Vorhof (Atrium) und eine Herzkammer (Ventricle).
|
||||
Vorhöfe sammeln Blut, Herzkammern pressen es in den Körper.
|
||||
* Zwei Phasen wechseln sich jeweils ab.
|
||||
** Anspannungsphase: Systole
|
||||
** Entspannungsphase: Diastole
|
||||
* Die Herzklappen sind eine Art Rücklaufventile, es gibt 2 verschiedene:
|
||||
** 2 Segelklappen (AtrioventricularValve): verhindern, dass Blut in der Systole in den Vorhof zurückfliesst.
|
||||
** 2 Taschenklappen (SemilunarValve): verhindern, dass in der Diastole Blut ins Herz zurückfliesst.
|
||||
|
||||
image:Heart_diagram-en.svg.png[pdfwidth=75%, width=600px]
|
||||
|
||||
=== Ablauf des Herzschlags
|
||||
|
||||
==== Diastole – Blut sammelt sich im Vorhof ("atrium")
|
||||
|
||||
* Segelklappen ("atrioventricular valves") öffnen
|
||||
* Taschenklappen ("semilunar valves") schliessen
|
||||
* Vorhöfe ("atria") entspannen
|
||||
* Herzkammern ("ventricle") entspannen
|
||||
* Warten auf Systole
|
||||
|
||||
==== Systole
|
||||
|
||||
* Segelklappen schliessen
|
||||
* Taschenklappen öffnen
|
||||
* Herzkammern kontrahieren
|
||||
* Vorhöfe kontrahieren
|
||||
* Warten auf Diastole
|
||||
|
||||
Es gibt die folgenden Klassen im Projekt:
|
||||
|
||||
image:heartbeat_classdiagram.png[pdfwidth=75%, width=600px]
|
||||
|
||||
Darüber hinaus gibt es eine Klasse `HeartTest`, die bereits mehrere Tests implementiert.
|
||||
|
||||
Stubs sind nicht sehr intelligent und daher kann man häufig nur oberflächlich mit Stubs testen.
|
||||
Sie sollen mit Hilfe von Mock-Objekten die Tests noch gründlicher gestalten.
|
||||
|
||||
Die Abhängigkeit für Mockito ist bereits für Sie in build.gradle erfasst worden.
|
||||
Studieren Sie kurz in diesem File, wie das gemacht wurde.
|
||||
Informationen dazu finden Sie auf der link:{mockito-home} und auf link:{maven-central}.
|
||||
|
||||
Studieren bzw. überfliegen Sie bei dieser Gelegenheit auch gerade die link:{mockito-docs}.
|
||||
|
||||
|
||||
== Aufgaben
|
||||
|
||||
=== Einführung in Mockito [PU]
|
||||
[loweralpha]
|
||||
. Studieren Sie die Testmethoden `HeartTest::testValveStatus()` und `HeartTest::testExecuteHartBeatErrorBehaviour()`.
|
||||
Dort wird *ein Teil* des Verhaltens des Herzens getestet.
|
||||
|
||||
. Implementieren Sie die Methoden `Heart::executeDiastole()`, `Heart::executeSystole()` und `Heart::executeHeartBeat()` sodass die bestehenden Tests durchlaufen und das oben beschriebene Verhalten des Herzens modelliert wird.
|
||||
|
||||
. (optional) Ein echtes Herz hat eine Schlagfrequenz.
|
||||
Implementieren Sie, dass das Herz nach jeder Systole pausiert.
|
||||
Sie können z. B. den aktuellen Thread 1000 ms lang anhalten mit
|
||||
+
|
||||
[source, Java]
|
||||
----
|
||||
try {
|
||||
Thread.currentThread().sleep(1000);
|
||||
} catch (InterruptedException e) {
|
||||
e.printStackTrace();
|
||||
}
|
||||
----
|
||||
|
||||
=== Fragen zu Testing [TU]
|
||||
[loweralpha]
|
||||
. Testing kann in zwei unterschiedliche Strategien aufgeteilt werden.
|
||||
Zum einen gibt es White-Box Testing und zum zweiten Black-Box Testing.
|
||||
Was für Java Libraries gibt es um diese zwei Strategien zu testen?
|
||||
Wann wenden Sie welche Strategie an?
|
||||
|
||||
. Das Erstellen von guten automatisierten Unit-Tests kann manchmal schwierig umzusetzen sein.
|
||||
Was ist der Hauptgrund dafür? Wie können Sie dieses Problem entschärfen?
|
||||
|
||||
. Der Testfokus war bisher auf der Klasse `Heart`.
|
||||
Testen Sie jetzt die Klasse `Half`. Wo verwenden Sie Stubbing, wo Mocking?
|
||||
|
||||
=== Vorbedingungen, Exceptions und Callback-Funktionen [PA]
|
||||
[loweralpha]
|
||||
. Testen Sie, dass beim Ausführen der Diastole und Systole alle Herzklappen in der richtigen Reihenfolge geöffnet und geschlossen werden.
|
||||
Implementieren Sie dafür die Methode `HeartTest::testValvesBehavior()` und benutzen Sie die von Mockito bereitgestellte Klasse `InOrder`. +
|
||||
Testen Sie auch, dass keine Methode unnötig oft aufgerufen wird (mit der Methode `Inorder::verifyNoMoreInteractions()`). +
|
||||
Benutzen Sie mindestens einmal die statische Methode `mock()` und einmal die Annotation `@Mock` von Mockito.
|
||||
|
||||
. Die vorhandene Implementation des Testfalls `HeartTest::testExecuteHartBeatErrorBehaviour()` verwendet keine Mock-Objekte für die linke und rechte Herzhälfte.
|
||||
Implementieren Sie die Testmethode `HeartTest::testExecuteHartBeatErrorBehaviourWithStubbing()` analog zur bestehenden Variante, aber diesmal setzen Sie entsprechende Mock-Objekte für die Herzhälften ein.
|
||||
+
|
||||
TIP: Für das Stubbing werden Sie die `doThrow`- Methode von Mockito benötigen.
|
||||
Mit Stubbing ist die Konfiguration von Ihrem Mock-Objekt gemeint.
|
||||
|
||||
. Die bestehende Implementierung hat einen ungenügenden Exception-Mechanismus.
|
||||
Beispielsweise führt die Herzhälfte (`Half`) ihre Methoden aus, auch wenn die notwendigen Vorbedingungen (d.h., die Klappenstellungen von `SemilunarValve` und `AtrioVentricularValve`)
|
||||
nicht gelten. +
|
||||
Beheben Sie dieses Problem, indem Sie in `Heart::executeDiastole()` und `Heart::executeSystole()` eine `InvalidValvePositionException` werfen,
|
||||
falls die notwendigen Vorbedingungen nicht in der korrekten Position (offen, geschlossen) sind. +
|
||||
Erstellen Sie zwei Methoden `testDiastoleException()` und `testSystoleException()` und setzen Sie Mocking und Stubbing ein, um diesen Exception-Mechanismus zu testen.
|
||||
|
||||
. Die Klasse Pacemaker ist eine Implementation für einen Herzschrittmacher.
|
||||
Es ist eine unvollständige Implementation, reduziert auf das Wesentliche für den Inhalt des Praktikums.
|
||||
Ihre Aufgabe ist es, die Methode `Pacemaker::setHeartRate` mit zwei vorgegeben Testfällen zu testen. +
|
||||
Implementieren Sie Test-Methoden `PacemakerTest::testSetHeartRateRejectsFrequenciesOutOfRange` und `PacemakerTest::testSetHeartRateAppliesFrequenciesInsideRange`. +
|
||||
Die beiden Testfälle prüfen die Methode `Pacemaker::setHeartRate` darauf, ob sie korrekt reagiert, wenn das Herz die gewünschte Frequenz im einen Fall anwenden und im anderen Fall nicht anwenden kann.
|
||||
In diesem Szenario ist die Klasse `Pacemaker` die Class-Under-Test und die Klasse `Heart` eine Abhängigkeit für `Pacemaker`. +
|
||||
Verwenden Sie für die Klasse `Heart` ein entsprechendes Mock-Objekt und stubben Sie das Verhalten gemäss der Spezifikation von der Methode `Heart::setHeartRate()`.
|
||||
Eine Voraussetzung ist, dass Sie für beide Testfälle dasselbe Mock-Objekt mit demselben Stubbing verwenden können.
|
||||
Die Callback-Methode wird Ihnen dabei eine Hilfe sein.
|
||||
|
||||
|
||||
== Abschluss
|
||||
Stellen Sie sicher, dass die Tests der Pflichtaufgabe mittels `gradlew test` gestartet werden können und pushen Sie die Lösung vor der Deadline in Ihr Abgaberepository.
|
||||
|
||||
|
||||
|
|
@ -0,0 +1,74 @@
|
|||
/*
|
||||
* This file was generated by the Gradle 'init' task.
|
||||
*
|
||||
* This generated file contains a sample Java application project to get you started.
|
||||
* For more details take a look at the 'Building Java & JVM projects' chapter in the Gradle
|
||||
* User Manual available at https://docs.gradle.org/7.2/userguide/building_java_projects.html
|
||||
*/
|
||||
|
||||
plugins {
|
||||
// Apply the application plugin to add support for building a CLI application in Java.
|
||||
id 'application'
|
||||
}
|
||||
|
||||
repositories {
|
||||
// Use Maven Central for resolving dependencies.
|
||||
mavenCentral()
|
||||
}
|
||||
|
||||
dependencies {
|
||||
// Junit 5 dependencies
|
||||
testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.+'
|
||||
testImplementation 'org.junit.jupiter:junit-jupiter-params:5.8.+'
|
||||
testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.+'
|
||||
// Mockito dependencies
|
||||
testImplementation 'org.mockito:mockito-core:4.3.+'
|
||||
}
|
||||
|
||||
// Test task configuration
|
||||
test {
|
||||
// Use JUnit platform for unit tests
|
||||
useJUnitPlatform()
|
||||
// Output results of individual tests
|
||||
testLogging {
|
||||
events "PASSED", "SKIPPED", "FAILED"
|
||||
}
|
||||
}
|
||||
|
||||
application {
|
||||
// Define the main class for the application.
|
||||
mainClass = 'ch.zhaw.prog2.heartbeat.Heart'
|
||||
}
|
||||
|
||||
// Java plugin configuration
|
||||
java {
|
||||
// By default the Java version of the gradle process is used as source/target version.
|
||||
// This can be overridden, to ensure a specific version. Enable only if required.
|
||||
// sourceCompatibility = JavaVersion.VERSION_17 // ensure Java source code compatibility
|
||||
// targetCompatibility = JavaVersion.VERSION_17 // version of the created byte-code
|
||||
|
||||
// Java compiler specific options
|
||||
compileJava {
|
||||
// source files should be UTF-8 encoded
|
||||
options.encoding = 'UTF-8'
|
||||
// for more options see https://docs.gradle.org/current/dsl/org.gradle.api.tasks.compile.CompileOptions.html
|
||||
}
|
||||
}
|
||||
|
||||
task autograding(type: Test) {
|
||||
description = "Runs specific tests for autograding"
|
||||
group = 'verification'
|
||||
|
||||
useJUnitPlatform()
|
||||
testLogging {
|
||||
events "PASSED", "SKIPPED", "FAILED"
|
||||
}
|
||||
filter {
|
||||
failOnNoMatchingTests true
|
||||
includeTestsMatching "PacemakerTest"
|
||||
includeTestsMatching "HeartTest.testExecuteHartBeatErrorBehaviourWithStubbing"
|
||||
includeTestsMatching "HeartTest.testValvesBehavior"
|
||||
includeTestsMatching "HeartTest.testDiastoleException"
|
||||
includeTestsMatching "HeartTest.testSystoleException"
|
||||
}
|
||||
}
|
|
@ -0,0 +1,100 @@
|
|||
package ch.zhaw.prog2.heartbeat;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.parts.*;
|
||||
|
||||
/**
|
||||
* Represents one half of a heart.
|
||||
*
|
||||
* @author wahl, muon
|
||||
*/
|
||||
public class Half {
|
||||
|
||||
public enum Side {LEFT, RIGHT}
|
||||
|
||||
private Atrium atrium; // "Vorhof"
|
||||
private Ventricle ventricle; // "Herzkammer"
|
||||
private AtrioventricularValve atrioventricularValve; // "Segelklappe"
|
||||
private SemilunarValve semilunarValve; // "Taschenklappe"
|
||||
private final Side side;
|
||||
|
||||
public Half(Side side) {
|
||||
this.side = side;
|
||||
atrium = new Atrium(side);
|
||||
ventricle = new Ventricle(side);
|
||||
atrioventricularValve = new AtrioventricularValve(side);
|
||||
semilunarValve = new SemilunarValve(side);
|
||||
}
|
||||
|
||||
public void initializeState(Heart.State state) {
|
||||
atrioventricularValve.initializeState(state);
|
||||
semilunarValve.initializeState(state);
|
||||
}
|
||||
|
||||
public AtrioventricularValve getAtrioventricularValve() {
|
||||
return atrioventricularValve;
|
||||
}
|
||||
|
||||
public SemilunarValve getSemilunarValve() {
|
||||
return semilunarValve;
|
||||
}
|
||||
|
||||
public boolean isAtrioventricularValveOpen() {
|
||||
return atrioventricularValve.isOpen();
|
||||
}
|
||||
|
||||
public boolean isSemilunarValveOpen() {
|
||||
return semilunarValve.isOpen();
|
||||
}
|
||||
|
||||
/**
|
||||
* Closes the valve
|
||||
*
|
||||
* @throws IllegalStateException when valve is already closed
|
||||
*/
|
||||
public void closeSemilunarValve() throws Valve.IllegalValveStateException {
|
||||
semilunarValve.close();
|
||||
}
|
||||
|
||||
/**
|
||||
* Opens the valve
|
||||
*
|
||||
* @throws Valve.IllegalValveStateException when the valve is already open
|
||||
*/
|
||||
public void openSemilunarValve() throws Valve.IllegalValveStateException {
|
||||
semilunarValve.open();
|
||||
}
|
||||
|
||||
/**
|
||||
* Closes the valve
|
||||
*
|
||||
* @throws Valve.IllegalValveStateException when valve is already closed
|
||||
*/
|
||||
public void closeAtrioventricularValve() throws Valve.IllegalValveStateException {
|
||||
atrioventricularValve.close();
|
||||
}
|
||||
|
||||
/**
|
||||
* Opens the valve
|
||||
*
|
||||
* @throws Valve.IllegalValveStateException when the valve is already open
|
||||
*/
|
||||
public void openAtrioventricularValve() throws Valve.IllegalValveStateException {
|
||||
atrioventricularValve.open();
|
||||
}
|
||||
|
||||
public void contractVentricle() {
|
||||
ventricle.contract();
|
||||
}
|
||||
|
||||
public void relaxVentricle() {
|
||||
ventricle.relax();
|
||||
}
|
||||
|
||||
public void contractAtrium() {
|
||||
atrium.contract();
|
||||
}
|
||||
|
||||
public void relaxAtrium() {
|
||||
atrium.relax();
|
||||
}
|
||||
}
|
|
@ -0,0 +1,145 @@
|
|||
package ch.zhaw.prog2.heartbeat;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.parts.Valve;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* This class represents a human heart (https://en.wikipedia.org/wiki/Heart).
|
||||
* <p>
|
||||
* <p>
|
||||
* Example tests: before Chamber::contract() is called, the atrioventricular
|
||||
* valves must be closed.
|
||||
*
|
||||
* @author wahl
|
||||
*/
|
||||
public class Heart {
|
||||
private final static int AVERAGE_HEART_RATE = 60;
|
||||
|
||||
/**
|
||||
* Encodes the states of the heart
|
||||
*
|
||||
* @author wahl
|
||||
*/
|
||||
public enum State {
|
||||
SYSTOLE, DIASTOLE
|
||||
}
|
||||
|
||||
private List<Half> halves;
|
||||
private State state;
|
||||
private int heartRate;
|
||||
|
||||
/**
|
||||
* The default constructor calls the more specific constructor with a new left
|
||||
* and right half.
|
||||
*/
|
||||
public Heart() {
|
||||
this(new Half(Half.Side.LEFT), new Half(Half.Side.RIGHT));
|
||||
}
|
||||
|
||||
/**
|
||||
* The default constructor adds the left and the right half that are specified
|
||||
* as parameters and sets the start state to diastole.
|
||||
*/
|
||||
public Heart(Half leftHalf, Half rightHalf) {
|
||||
state = State.DIASTOLE;
|
||||
heartRate = AVERAGE_HEART_RATE;
|
||||
halves = new ArrayList<>();
|
||||
halves.add(leftHalf);
|
||||
halves.add(rightHalf);
|
||||
initalizeState();
|
||||
}
|
||||
|
||||
public void initalizeState(){
|
||||
for(Half half : halves){
|
||||
half.initializeState(state);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Executes a sequence of diastole and systole, beginning with the current
|
||||
* state.
|
||||
*
|
||||
* @throws HeartBeatDysfunctionException when Valve.IllegalValveStateException or
|
||||
* InvalidValvePositionException occurs during diastole or systole
|
||||
* TODO Implement a pause mechanism based on the current heart rate
|
||||
*/
|
||||
public void executeHeartBeat() throws HeartBeatDysfunctionException{
|
||||
//TODO implement
|
||||
}
|
||||
|
||||
/**
|
||||
* Executes the diastole phase of the heart.
|
||||
*
|
||||
* @throws Valve.IllegalValveStateException when one of the valves has an illegal State
|
||||
*/
|
||||
public void executeDiastole() {
|
||||
//TODO implement
|
||||
}
|
||||
|
||||
/**
|
||||
* Executes the systole phase of the heart.
|
||||
*
|
||||
* @throws Valve.IllegalValveStateException when one of the valves has an illegal State
|
||||
*/
|
||||
public void executeSystole() {
|
||||
//TODO implement
|
||||
}
|
||||
|
||||
public State getState() {
|
||||
return state;
|
||||
}
|
||||
|
||||
public void setState(State state) {
|
||||
this.state = state;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the heart rate to the parameter value in Hz.
|
||||
* Rate has to be inside range >30 && <220
|
||||
* If rate is outside of range method rejects the change
|
||||
* and returns false.
|
||||
*
|
||||
* @param frequencyInHz which should be applied to the heart
|
||||
* @return true if the heart rate could be set, false otherwise
|
||||
*/
|
||||
public boolean setHeartRate(int frequencyInHz) {
|
||||
if (frequencyInHz < 30 || frequencyInHz > 220) {
|
||||
return false;
|
||||
}
|
||||
this.heartRate = frequencyInHz;
|
||||
return true;
|
||||
}
|
||||
|
||||
public int getHeartRate() {
|
||||
return heartRate;
|
||||
}
|
||||
|
||||
public List<Half> getHalves() {
|
||||
return halves;
|
||||
}
|
||||
|
||||
public static class HeartBeatDysfunctionException extends Exception {
|
||||
public HeartBeatDysfunctionException() {
|
||||
}
|
||||
|
||||
public HeartBeatDysfunctionException(String message) {
|
||||
super(message);
|
||||
}
|
||||
|
||||
public HeartBeatDysfunctionException(String message, Throwable cause) {
|
||||
super(message, cause);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* The main method instantiates a heart object and executes a single heartbeat.
|
||||
*
|
||||
* @param args
|
||||
*/
|
||||
public static void main(String[] args) throws HeartBeatDysfunctionException {
|
||||
Heart heart = new Heart();
|
||||
heart.executeHeartBeat();
|
||||
}
|
||||
}
|
|
@ -0,0 +1,44 @@
|
|||
package ch.zhaw.prog2.heartbeat;
|
||||
/**
|
||||
* This class represents a pacemaker for a human hart.
|
||||
*
|
||||
* This is an incomplete implementation, reduced to the essentials for the content of the lab.
|
||||
* There would be a lot more code needed to implement a pacemaker, but this is not part of this lab :-)
|
||||
*
|
||||
* @author muon
|
||||
*
|
||||
*/
|
||||
public class Pacemaker {
|
||||
Heart heart;
|
||||
|
||||
/**
|
||||
* Constructor of Pacemaker
|
||||
* @param heart
|
||||
*/
|
||||
public Pacemaker(Heart heart) {
|
||||
this.heart = heart;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the heart rate to the parameter value in Hz.
|
||||
* Rate has to be inside range >30 && <220
|
||||
* If frequency can be applied on heart, the current frequency will be returned.
|
||||
* If heart does reject the change the method throws an exception.
|
||||
*
|
||||
* @param frequencyInHz needs to be applied on heart
|
||||
* @return current frequency of the heart
|
||||
* @throws IllegalArgumentException when heart does reject the change
|
||||
*/
|
||||
public int setHeartRate(int frequencyInHz) {
|
||||
if(heart.setHeartRate(frequencyInHz) == false){
|
||||
throw new IllegalArgumentException("Frequency could not be set.");
|
||||
}
|
||||
return heart.getHeartRate();
|
||||
}
|
||||
|
||||
/*
|
||||
...
|
||||
There would be a lot more code needed to implement a pacemaker, but this is not part of this lab :-)
|
||||
...
|
||||
*/
|
||||
}
|
|
@ -0,0 +1,19 @@
|
|||
package ch.zhaw.prog2.heartbeat.parts;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.Half.Side;
|
||||
import ch.zhaw.prog2.heartbeat.Heart;
|
||||
|
||||
public class AtrioventricularValve extends Valve {
|
||||
|
||||
public AtrioventricularValve(Side side) {
|
||||
super (side);
|
||||
}
|
||||
|
||||
public void initializeState(Heart.State state) {
|
||||
if(Heart.State.DIASTOLE.equals(state)){
|
||||
setOpen(false);
|
||||
}else{
|
||||
setOpen(true);
|
||||
}
|
||||
}
|
||||
}
|
|
@ -0,0 +1,20 @@
|
|||
package ch.zhaw.prog2.heartbeat.parts;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.Half.Side;
|
||||
|
||||
public class Atrium {
|
||||
private Side side;
|
||||
|
||||
public Atrium (Side side) {
|
||||
this.side = side;
|
||||
}
|
||||
|
||||
public void contract() {
|
||||
System.out.println("Atrium "+ side + " is contracting.");
|
||||
}
|
||||
|
||||
public void relax() {
|
||||
System.out.println("Atrium "+ side + " is relaxing.");
|
||||
}
|
||||
|
||||
}
|
|
@ -0,0 +1,20 @@
|
|||
package ch.zhaw.prog2.heartbeat.parts;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.Half.Side;
|
||||
import ch.zhaw.prog2.heartbeat.Heart;
|
||||
|
||||
public class SemilunarValve extends Valve {
|
||||
|
||||
public SemilunarValve(Side side) {
|
||||
super (side);
|
||||
}
|
||||
|
||||
public void initializeState(Heart.State state) {
|
||||
if(Heart.State.DIASTOLE.equals(state)){
|
||||
setOpen(true);
|
||||
}else{
|
||||
setOpen(false);
|
||||
}
|
||||
}
|
||||
|
||||
}
|
|
@ -0,0 +1,61 @@
|
|||
package ch.zhaw.prog2.heartbeat.parts;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.Half.Side;
|
||||
|
||||
public abstract class Valve {
|
||||
|
||||
private boolean open;
|
||||
private Side side;
|
||||
|
||||
public Valve(Side side) {
|
||||
this.side = side;
|
||||
}
|
||||
|
||||
/**
|
||||
* Opens the valve
|
||||
*
|
||||
* @throws IllegalValveStateException when the valve is already open
|
||||
*/
|
||||
public void open() throws IllegalValveStateException {
|
||||
if (open) {
|
||||
throw new IllegalValveStateException(this.getClass().getSimpleName() + " " + side + " valve is already open.");
|
||||
}
|
||||
System.out.println(this.getClass().getSimpleName() + " " + side + " is opening.");
|
||||
open = true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Closes the valve
|
||||
*
|
||||
* @throws IllegalValveStateException when valve is already closed
|
||||
*/
|
||||
public void close() throws IllegalValveStateException {
|
||||
if (!open) {
|
||||
throw new IllegalValveStateException(this.getClass().getSimpleName() + " " + side + " valve is already closed.");
|
||||
}
|
||||
System.out.println(this.getClass().getSimpleName() + " " + side + " is closing.");
|
||||
open = false;
|
||||
}
|
||||
|
||||
public boolean isOpen() {
|
||||
return open;
|
||||
}
|
||||
|
||||
protected void setOpen(Boolean open) {
|
||||
this.open = open;
|
||||
}
|
||||
|
||||
public static class IllegalValveStateException extends Exception {
|
||||
|
||||
public IllegalValveStateException() {
|
||||
}
|
||||
|
||||
public IllegalValveStateException(String message) {
|
||||
super(message);
|
||||
}
|
||||
|
||||
public IllegalValveStateException(String message, Throwable cause) {
|
||||
super(message, cause);
|
||||
}
|
||||
}
|
||||
}
|
|
@ -0,0 +1,20 @@
|
|||
package ch.zhaw.prog2.heartbeat.parts;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.Half.Side;
|
||||
|
||||
public class Ventricle {
|
||||
private Side side;
|
||||
|
||||
public Ventricle (Side side) {
|
||||
this.side = side;
|
||||
}
|
||||
|
||||
public void contract() {
|
||||
System.out.println("Chamber "+ side + " is contracting.");
|
||||
}
|
||||
|
||||
public void relax() {
|
||||
System.out.println("Chamber "+ side + " is relaxing.");
|
||||
}
|
||||
|
||||
}
|
|
@ -0,0 +1,100 @@
|
|||
/*
|
||||
* Test Class for Heart
|
||||
*/
|
||||
package ch.zhaw.prog2.heartbeat;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.*;
|
||||
import static org.mockito.Mockito.*;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.parts.Valve;
|
||||
import org.junit.jupiter.api.Disabled;
|
||||
import org.junit.jupiter.api.Test;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.Heart.State;
|
||||
|
||||
class HeartTest {
|
||||
/**
|
||||
* This is a very simple test to check if Junit and Mockito are properly set up.
|
||||
*/
|
||||
@Test
|
||||
void testTheTest() {
|
||||
Heart classUnderTest = new Heart();
|
||||
assertNotNull(classUnderTest.getState(), "The heart must have a state.");
|
||||
}
|
||||
|
||||
/**
|
||||
* Tests a single heartbeat
|
||||
*/
|
||||
@Test
|
||||
void testHeartBeat() throws Heart.HeartBeatDysfunctionException {
|
||||
Heart heart = new Heart();
|
||||
State startState = heart.getState();
|
||||
|
||||
heart.executeHeartBeat();
|
||||
|
||||
// after one heartbeat, the heart must be in the same state as before
|
||||
assertEquals(startState, heart.getState());
|
||||
}
|
||||
|
||||
/**
|
||||
* Tests if the valves are open or closed depending on the status of the heart
|
||||
*/
|
||||
@Test
|
||||
void testValveStatus() throws Heart.HeartBeatDysfunctionException {
|
||||
Heart heart = new Heart();
|
||||
|
||||
heart.executeHeartBeat();
|
||||
|
||||
State state = heart.getState();
|
||||
|
||||
if (state.equals(Heart.State.DIASTOLE)) {
|
||||
for (Half half : heart.getHalves()) {
|
||||
assertFalse(half.isAtrioventricularValveOpen());
|
||||
assertTrue(half.isSemilunarValveOpen());
|
||||
}
|
||||
} else if ((state.equals(Heart.State.SYSTOLE))) {
|
||||
for (Half half : heart.getHalves()) {
|
||||
assertTrue(half.isAtrioventricularValveOpen());
|
||||
assertFalse(half.isSemilunarValveOpen());
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Tests if the hart throws the appropriate Exception, when malfunction was detected during hartBeat
|
||||
*/
|
||||
@Test
|
||||
void testExecuteHeartBeatErrorBehaviour() {
|
||||
Heart heart = new Heart();
|
||||
// prepare error situation due to wrong initialization
|
||||
heart.setState(State.SYSTOLE);
|
||||
|
||||
assertThrows(Heart.HeartBeatDysfunctionException .class, // verification using lambda
|
||||
() -> heart.executeHeartBeat());
|
||||
}
|
||||
|
||||
/**
|
||||
* Tests if the hart throws the appropriate Exception, when malfunction was detected during hartBeat
|
||||
* with exception Stubbing
|
||||
*/
|
||||
@Test
|
||||
void testExecuteHartBeatErrorBehaviourWithStubbing() throws Valve.IllegalValveStateException {
|
||||
//TODO implement
|
||||
fail();
|
||||
}
|
||||
|
||||
/**
|
||||
* We test if Heart::executeHeartbeat() sends the right signals to both of its
|
||||
* halves.
|
||||
*
|
||||
* When Half::contractVentricle() is called, Half::closeAtrioventricularValve()
|
||||
* and Half::openSemilunarValve() must have been called earlier.
|
||||
*
|
||||
*/
|
||||
@Test
|
||||
void testValvesBehavior() {
|
||||
//TODO implement
|
||||
fail();
|
||||
}
|
||||
|
||||
}
|
|
@ -0,0 +1,30 @@
|
|||
package ch.zhaw.prog2.heartbeat;
|
||||
|
||||
import org.junit.jupiter.api.Test;
|
||||
import static org.junit.jupiter.api.Assertions.*;
|
||||
|
||||
/*
|
||||
* Test Class for Pacemaker
|
||||
*/
|
||||
public class PacemakerTest {
|
||||
|
||||
/**
|
||||
* Test if setHeartRate does throw correct exception when rate is rejected (because frequency is out of range)
|
||||
*/
|
||||
@Test
|
||||
void testSetHeartRateRejectsFrequenciesOutOfRange() {
|
||||
//TODO implement
|
||||
fail();
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Test if setHeartRate does correctly set the rate when frequency is inside range
|
||||
*/
|
||||
@Test
|
||||
void testSetHeartRateAppliesFrequenciesInsideRange() {
|
||||
//TODO implement
|
||||
fail();
|
||||
}
|
||||
|
||||
}
|
|
@ -0,0 +1,7 @@
|
|||
# Used to set properties for gradle builds
|
||||
# (see https://dev.to/jmfayard/configuring-gradle-with-gradle-properties-211k)
|
||||
|
||||
# gradle configuration
|
||||
# (https://docs.gradle.org/current/userguide/build_environment.html#sec:gradle_configuration_properties)
|
||||
#org.gradle.warning.mode=(all,fail,summary,none) default: summary
|
||||
org.gradle.warning.mode=all
|
Binary file not shown.
|
@ -0,0 +1,5 @@
|
|||
distributionBase=GRADLE_USER_HOME
|
||||
distributionPath=wrapper/dists
|
||||
distributionUrl=https\://services.gradle.org/distributions/gradle-7.4-bin.zip
|
||||
zipStoreBase=GRADLE_USER_HOME
|
||||
zipStorePath=wrapper/dists
|
|
@ -0,0 +1,234 @@
|
|||
#!/bin/sh
|
||||
|
||||
#
|
||||
# Copyright © 2015-2021 the original authors.
|
||||
#
|
||||
# Licensed under the Apache License, Version 2.0 (the "License");
|
||||
# you may not use this file except in compliance with the License.
|
||||
# You may obtain a copy of the License at
|
||||
#
|
||||
# https://www.apache.org/licenses/LICENSE-2.0
|
||||
#
|
||||
# Unless required by applicable law or agreed to in writing, software
|
||||
# distributed under the License is distributed on an "AS IS" BASIS,
|
||||
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
# See the License for the specific language governing permissions and
|
||||
# limitations under the License.
|
||||
#
|
||||
|
||||
##############################################################################
|
||||
#
|
||||
# Gradle start up script for POSIX generated by Gradle.
|
||||
#
|
||||
# Important for running:
|
||||
#
|
||||
# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
|
||||
# noncompliant, but you have some other compliant shell such as ksh or
|
||||
# bash, then to run this script, type that shell name before the whole
|
||||
# command line, like:
|
||||
#
|
||||
# ksh Gradle
|
||||
#
|
||||
# Busybox and similar reduced shells will NOT work, because this script
|
||||
# requires all of these POSIX shell features:
|
||||
# * functions;
|
||||
# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
|
||||
# «${var#prefix}», «${var%suffix}», and «$( cmd )»;
|
||||
# * compound commands having a testable exit status, especially «case»;
|
||||
# * various built-in commands including «command», «set», and «ulimit».
|
||||
#
|
||||
# Important for patching:
|
||||
#
|
||||
# (2) This script targets any POSIX shell, so it avoids extensions provided
|
||||
# by Bash, Ksh, etc; in particular arrays are avoided.
|
||||
#
|
||||
# The "traditional" practice of packing multiple parameters into a
|
||||
# space-separated string is a well documented source of bugs and security
|
||||
# problems, so this is (mostly) avoided, by progressively accumulating
|
||||
# options in "$@", and eventually passing that to Java.
|
||||
#
|
||||
# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
|
||||
# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
|
||||
# see the in-line comments for details.
|
||||
#
|
||||
# There are tweaks for specific operating systems such as AIX, CygWin,
|
||||
# Darwin, MinGW, and NonStop.
|
||||
#
|
||||
# (3) This script is generated from the Groovy template
|
||||
# https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
|
||||
# within the Gradle project.
|
||||
#
|
||||
# You can find Gradle at https://github.com/gradle/gradle/.
|
||||
#
|
||||
##############################################################################
|
||||
|
||||
# Attempt to set APP_HOME
|
||||
|
||||
# Resolve links: $0 may be a link
|
||||
app_path=$0
|
||||
|
||||
# Need this for daisy-chained symlinks.
|
||||
while
|
||||
APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
|
||||
[ -h "$app_path" ]
|
||||
do
|
||||
ls=$( ls -ld "$app_path" )
|
||||
link=${ls#*' -> '}
|
||||
case $link in #(
|
||||
/*) app_path=$link ;; #(
|
||||
*) app_path=$APP_HOME$link ;;
|
||||
esac
|
||||
done
|
||||
|
||||
APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
|
||||
|
||||
APP_NAME="Gradle"
|
||||
APP_BASE_NAME=${0##*/}
|
||||
|
||||
# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
|
||||
DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
|
||||
|
||||
# Use the maximum available, or set MAX_FD != -1 to use that value.
|
||||
MAX_FD=maximum
|
||||
|
||||
warn () {
|
||||
echo "$*"
|
||||
} >&2
|
||||
|
||||
die () {
|
||||
echo
|
||||
echo "$*"
|
||||
echo
|
||||
exit 1
|
||||
} >&2
|
||||
|
||||
# OS specific support (must be 'true' or 'false').
|
||||
cygwin=false
|
||||
msys=false
|
||||
darwin=false
|
||||
nonstop=false
|
||||
case "$( uname )" in #(
|
||||
CYGWIN* ) cygwin=true ;; #(
|
||||
Darwin* ) darwin=true ;; #(
|
||||
MSYS* | MINGW* ) msys=true ;; #(
|
||||
NONSTOP* ) nonstop=true ;;
|
||||
esac
|
||||
|
||||
CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
|
||||
|
||||
|
||||
# Determine the Java command to use to start the JVM.
|
||||
if [ -n "$JAVA_HOME" ] ; then
|
||||
if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
|
||||
# IBM's JDK on AIX uses strange locations for the executables
|
||||
JAVACMD=$JAVA_HOME/jre/sh/java
|
||||
else
|
||||
JAVACMD=$JAVA_HOME/bin/java
|
||||
fi
|
||||
if [ ! -x "$JAVACMD" ] ; then
|
||||
die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
|
||||
|
||||
Please set the JAVA_HOME variable in your environment to match the
|
||||
location of your Java installation."
|
||||
fi
|
||||
else
|
||||
JAVACMD=java
|
||||
which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
|
||||
|
||||
Please set the JAVA_HOME variable in your environment to match the
|
||||
location of your Java installation."
|
||||
fi
|
||||
|
||||
# Increase the maximum file descriptors if we can.
|
||||
if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
|
||||
case $MAX_FD in #(
|
||||
max*)
|
||||
MAX_FD=$( ulimit -H -n ) ||
|
||||
warn "Could not query maximum file descriptor limit"
|
||||
esac
|
||||
case $MAX_FD in #(
|
||||
'' | soft) :;; #(
|
||||
*)
|
||||
ulimit -n "$MAX_FD" ||
|
||||
warn "Could not set maximum file descriptor limit to $MAX_FD"
|
||||
esac
|
||||
fi
|
||||
|
||||
# Collect all arguments for the java command, stacking in reverse order:
|
||||
# * args from the command line
|
||||
# * the main class name
|
||||
# * -classpath
|
||||
# * -D...appname settings
|
||||
# * --module-path (only if needed)
|
||||
# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
|
||||
|
||||
# For Cygwin or MSYS, switch paths to Windows format before running java
|
||||
if "$cygwin" || "$msys" ; then
|
||||
APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
|
||||
CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
|
||||
|
||||
JAVACMD=$( cygpath --unix "$JAVACMD" )
|
||||
|
||||
# Now convert the arguments - kludge to limit ourselves to /bin/sh
|
||||
for arg do
|
||||
if
|
||||
case $arg in #(
|
||||
-*) false ;; # don't mess with options #(
|
||||
/?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
|
||||
[ -e "$t" ] ;; #(
|
||||
*) false ;;
|
||||
esac
|
||||
then
|
||||
arg=$( cygpath --path --ignore --mixed "$arg" )
|
||||
fi
|
||||
# Roll the args list around exactly as many times as the number of
|
||||
# args, so each arg winds up back in the position where it started, but
|
||||
# possibly modified.
|
||||
#
|
||||
# NB: a `for` loop captures its iteration list before it begins, so
|
||||
# changing the positional parameters here affects neither the number of
|
||||
# iterations, nor the values presented in `arg`.
|
||||
shift # remove old arg
|
||||
set -- "$@" "$arg" # push replacement arg
|
||||
done
|
||||
fi
|
||||
|
||||
# Collect all arguments for the java command;
|
||||
# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
|
||||
# shell script including quotes and variable substitutions, so put them in
|
||||
# double quotes to make sure that they get re-expanded; and
|
||||
# * put everything else in single quotes, so that it's not re-expanded.
|
||||
|
||||
set -- \
|
||||
"-Dorg.gradle.appname=$APP_BASE_NAME" \
|
||||
-classpath "$CLASSPATH" \
|
||||
org.gradle.wrapper.GradleWrapperMain \
|
||||
"$@"
|
||||
|
||||
# Use "xargs" to parse quoted args.
|
||||
#
|
||||
# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
|
||||
#
|
||||
# In Bash we could simply go:
|
||||
#
|
||||
# readarray ARGS < <( xargs -n1 <<<"$var" ) &&
|
||||
# set -- "${ARGS[@]}" "$@"
|
||||
#
|
||||
# but POSIX shell has neither arrays nor command substitution, so instead we
|
||||
# post-process each arg (as a line of input to sed) to backslash-escape any
|
||||
# character that might be a shell metacharacter, then use eval to reverse
|
||||
# that process (while maintaining the separation between arguments), and wrap
|
||||
# the whole thing up as a single "set" statement.
|
||||
#
|
||||
# This will of course break if any of these variables contains a newline or
|
||||
# an unmatched quote.
|
||||
#
|
||||
|
||||
eval "set -- $(
|
||||
printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
|
||||
xargs -n1 |
|
||||
sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
|
||||
tr '\n' ' '
|
||||
)" '"$@"'
|
||||
|
||||
exec "$JAVACMD" "$@"
|
|
@ -0,0 +1,89 @@
|
|||
@rem
|
||||
@rem Copyright 2015 the original author or authors.
|
||||
@rem
|
||||
@rem Licensed under the Apache License, Version 2.0 (the "License");
|
||||
@rem you may not use this file except in compliance with the License.
|
||||
@rem You may obtain a copy of the License at
|
||||
@rem
|
||||
@rem https://www.apache.org/licenses/LICENSE-2.0
|
||||
@rem
|
||||
@rem Unless required by applicable law or agreed to in writing, software
|
||||
@rem distributed under the License is distributed on an "AS IS" BASIS,
|
||||
@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
@rem See the License for the specific language governing permissions and
|
||||
@rem limitations under the License.
|
||||
@rem
|
||||
|
||||
@if "%DEBUG%" == "" @echo off
|
||||
@rem ##########################################################################
|
||||
@rem
|
||||
@rem Gradle startup script for Windows
|
||||
@rem
|
||||
@rem ##########################################################################
|
||||
|
||||
@rem Set local scope for the variables with windows NT shell
|
||||
if "%OS%"=="Windows_NT" setlocal
|
||||
|
||||
set DIRNAME=%~dp0
|
||||
if "%DIRNAME%" == "" set DIRNAME=.
|
||||
set APP_BASE_NAME=%~n0
|
||||
set APP_HOME=%DIRNAME%
|
||||
|
||||
@rem Resolve any "." and ".." in APP_HOME to make it shorter.
|
||||
for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
|
||||
|
||||
@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
|
||||
set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
|
||||
|
||||
@rem Find java.exe
|
||||
if defined JAVA_HOME goto findJavaFromJavaHome
|
||||
|
||||
set JAVA_EXE=java.exe
|
||||
%JAVA_EXE% -version >NUL 2>&1
|
||||
if "%ERRORLEVEL%" == "0" goto execute
|
||||
|
||||
echo.
|
||||
echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
|
||||
echo.
|
||||
echo Please set the JAVA_HOME variable in your environment to match the
|
||||
echo location of your Java installation.
|
||||
|
||||
goto fail
|
||||
|
||||
:findJavaFromJavaHome
|
||||
set JAVA_HOME=%JAVA_HOME:"=%
|
||||
set JAVA_EXE=%JAVA_HOME%/bin/java.exe
|
||||
|
||||
if exist "%JAVA_EXE%" goto execute
|
||||
|
||||
echo.
|
||||
echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
|
||||
echo.
|
||||
echo Please set the JAVA_HOME variable in your environment to match the
|
||||
echo location of your Java installation.
|
||||
|
||||
goto fail
|
||||
|
||||
:execute
|
||||
@rem Setup the command line
|
||||
|
||||
set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
|
||||
|
||||
|
||||
@rem Execute Gradle
|
||||
"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
|
||||
|
||||
:end
|
||||
@rem End local scope for the variables with windows NT shell
|
||||
if "%ERRORLEVEL%"=="0" goto mainEnd
|
||||
|
||||
:fail
|
||||
rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
|
||||
rem the _cmd.exe /c_ return code!
|
||||
if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
|
||||
exit /b 1
|
||||
|
||||
:mainEnd
|
||||
if "%OS%"=="Windows_NT" endlocal
|
||||
|
||||
:omega
|
Binary file not shown.
After Width: | Height: | Size: 378 KiB |
Binary file not shown.
After Width: | Height: | Size: 121 KiB |
Binary file not shown.
After Width: | Height: | Size: 91 KiB |
|
@ -0,0 +1,45 @@
|
|||
/*
|
||||
* Dynamic Multi-Module project structure
|
||||
* automatically adds each exercise as a sub-project (module)
|
||||
*/
|
||||
|
||||
// use current directory name as root project name
|
||||
rootProject.name = file('.').name
|
||||
|
||||
// dynamically add sub-projects in handout folder
|
||||
File handoutDir = file('code')
|
||||
if (handoutDir.isDirectory()) {
|
||||
handoutDir.eachDir { dir ->
|
||||
String subProjectName = ":${dir.name}"
|
||||
include(subProjectName)
|
||||
project(subProjectName).projectDir = dir
|
||||
}
|
||||
}
|
||||
|
||||
// dynamically add sub-projects in solutions* folders
|
||||
//List<File> solutionDirs = List.of(file('.').listFiles((File dir, String name) -> name.startsWith("solutions")))
|
||||
file('.').eachDirMatch( name -> name.startsWith('solutions')) { solutionDir ->
|
||||
if (solutionDir.isDirectory()) {
|
||||
solutionDir.eachDir { dir ->
|
||||
if (!dir.name.equals('images')) {
|
||||
String subProjectName = ":${dir.name}-sol"
|
||||
include(subProjectName)
|
||||
project(subProjectName).projectDir = dir
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// lab preparation tasks
|
||||
File classroomDir = file('classroom')
|
||||
if (classroomDir.isDirectory()) {
|
||||
String subProjectName = ":${classroomDir.name}"
|
||||
include(subProjectName)
|
||||
}
|
||||
|
||||
// Example: manually adding sub-project with name == folder
|
||||
//include 'module1'
|
||||
|
||||
// Example: manually adding sub-projects with different name & folder
|
||||
//include(':lab00-module1')
|
||||
//project(':lab00-module1').projectDir = file('handout/module1')
|
|
@ -0,0 +1,74 @@
|
|||
/*
|
||||
* This file was generated by the Gradle 'init' task.
|
||||
*
|
||||
* This generated file contains a sample Java application project to get you started.
|
||||
* For more details take a look at the 'Building Java & JVM projects' chapter in the Gradle
|
||||
* User Manual available at https://docs.gradle.org/7.2/userguide/building_java_projects.html
|
||||
*/
|
||||
|
||||
plugins {
|
||||
// Apply the application plugin to add support for building a CLI application in Java.
|
||||
id 'application'
|
||||
}
|
||||
|
||||
repositories {
|
||||
// Use Maven Central for resolving dependencies.
|
||||
mavenCentral()
|
||||
}
|
||||
|
||||
dependencies {
|
||||
// Junit 5 dependencies
|
||||
testImplementation 'org.junit.jupiter:junit-jupiter-api:5.8.+'
|
||||
testImplementation 'org.junit.jupiter:junit-jupiter-params:5.8.+'
|
||||
testRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.8.+'
|
||||
// Mockito dependencies
|
||||
testImplementation 'org.mockito:mockito-core:4.3.+'
|
||||
}
|
||||
|
||||
// Test task configuration
|
||||
test {
|
||||
// Use JUnit platform for unit tests
|
||||
useJUnitPlatform()
|
||||
// Output results of individual tests
|
||||
testLogging {
|
||||
events "PASSED", "SKIPPED", "FAILED"
|
||||
}
|
||||
}
|
||||
|
||||
application {
|
||||
// Define the main class for the application.
|
||||
mainClass = 'ch.zhaw.prog2.heartbeat.Heart'
|
||||
}
|
||||
|
||||
// Java plugin configuration
|
||||
java {
|
||||
// By default the Java version of the gradle process is used as source/target version.
|
||||
// This can be overridden, to ensure a specific version. Enable only if required.
|
||||
// sourceCompatibility = JavaVersion.VERSION_17 // ensure Java source code compatibility
|
||||
// targetCompatibility = JavaVersion.VERSION_17 // version of the created byte-code
|
||||
|
||||
// Java compiler specific options
|
||||
compileJava {
|
||||
// source files should be UTF-8 encoded
|
||||
options.encoding = 'UTF-8'
|
||||
// for more options see https://docs.gradle.org/current/dsl/org.gradle.api.tasks.compile.CompileOptions.html
|
||||
}
|
||||
}
|
||||
|
||||
task autograding(type: Test) {
|
||||
description = "Runs specific tests for autograding"
|
||||
group = 'verification'
|
||||
|
||||
useJUnitPlatform()
|
||||
testLogging {
|
||||
events "PASSED", "SKIPPED", "FAILED"
|
||||
}
|
||||
filter {
|
||||
failOnNoMatchingTests true
|
||||
includeTestsMatching "PacemakerTest"
|
||||
includeTestsMatching "HeartTest.testExecuteHartBeatErrorBehaviourWithStubbing"
|
||||
includeTestsMatching "HeartTest.testValvesBehavior"
|
||||
includeTestsMatching "HeartTest.testDiastoleException"
|
||||
includeTestsMatching "HeartTest.testSystoleException"
|
||||
}
|
||||
}
|
|
@ -0,0 +1,100 @@
|
|||
package ch.zhaw.prog2.heartbeat;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.parts.*;
|
||||
|
||||
/**
|
||||
* Represents one half of a heart.
|
||||
*
|
||||
* @author wahl, muon
|
||||
*/
|
||||
public class Half {
|
||||
|
||||
public enum Side {LEFT, RIGHT}
|
||||
|
||||
private Atrium atrium; // "Vorhof"
|
||||
private Ventricle ventricle; // "Herzkammer"
|
||||
private AtrioventricularValve atrioventricularValve; // "Segelklappe"
|
||||
private SemilunarValve semilunarValve; // "Taschenklappe"
|
||||
private final Side side;
|
||||
|
||||
public Half(Side side) {
|
||||
this.side = side;
|
||||
atrium = new Atrium(side);
|
||||
ventricle = new Ventricle(side);
|
||||
atrioventricularValve = new AtrioventricularValve(side);
|
||||
semilunarValve = new SemilunarValve(side);
|
||||
}
|
||||
|
||||
public void initializeState(Heart.State state) {
|
||||
atrioventricularValve.initializeState(state);
|
||||
semilunarValve.initializeState(state);
|
||||
}
|
||||
|
||||
public AtrioventricularValve getAtrioventricularValve() {
|
||||
return atrioventricularValve;
|
||||
}
|
||||
|
||||
public SemilunarValve getSemilunarValve() {
|
||||
return semilunarValve;
|
||||
}
|
||||
|
||||
public boolean isAtrioventricularValveOpen() {
|
||||
return atrioventricularValve.isOpen();
|
||||
}
|
||||
|
||||
public boolean isSemilunarValveOpen() {
|
||||
return semilunarValve.isOpen();
|
||||
}
|
||||
|
||||
/**
|
||||
* Closes the valve
|
||||
*
|
||||
* @throws IllegalStateException when valve is already closed
|
||||
*/
|
||||
public void closeSemilunarValve() throws Valve.IllegalValveStateException {
|
||||
semilunarValve.close();
|
||||
}
|
||||
|
||||
/**
|
||||
* Opens the valve
|
||||
*
|
||||
* @throws Valve.IllegalValveStateException when the valve is already open
|
||||
*/
|
||||
public void openSemilunarValve() throws Valve.IllegalValveStateException {
|
||||
semilunarValve.open();
|
||||
}
|
||||
|
||||
/**
|
||||
* Closes the valve
|
||||
*
|
||||
* @throws Valve.IllegalValveStateException when valve is already closed
|
||||
*/
|
||||
public void closeAtrioventricularValve() throws Valve.IllegalValveStateException {
|
||||
atrioventricularValve.close();
|
||||
}
|
||||
|
||||
/**
|
||||
* Opens the valve
|
||||
*
|
||||
* @throws Valve.IllegalValveStateException when the valve is already open
|
||||
*/
|
||||
public void openAtrioventricularValve() throws Valve.IllegalValveStateException {
|
||||
atrioventricularValve.open();
|
||||
}
|
||||
|
||||
public void contractVentricle() {
|
||||
ventricle.contract();
|
||||
}
|
||||
|
||||
public void relaxVentricle() {
|
||||
ventricle.relax();
|
||||
}
|
||||
|
||||
public void contractAtrium() {
|
||||
atrium.contract();
|
||||
}
|
||||
|
||||
public void relaxAtrium() {
|
||||
atrium.relax();
|
||||
}
|
||||
}
|
|
@ -0,0 +1,168 @@
|
|||
package ch.zhaw.prog2.heartbeat;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.parts.Valve;
|
||||
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* This class represents a human heart (https://en.wikipedia.org/wiki/Heart).
|
||||
* <p>
|
||||
* <p>
|
||||
* Example tests: before Chamber::contract() is called, the atrioventricular
|
||||
* valves must be closed.
|
||||
*
|
||||
* @author wahl
|
||||
*/
|
||||
public class Heart {
|
||||
private final static int AVERAGE_HEART_RATE = 60;
|
||||
|
||||
/**
|
||||
* Encodes the states of the heart
|
||||
*
|
||||
* @author wahl
|
||||
*/
|
||||
public enum State {
|
||||
SYSTOLE, DIASTOLE
|
||||
}
|
||||
|
||||
private List<Half> halves;
|
||||
private State state;
|
||||
private int heartRate;
|
||||
|
||||
/**
|
||||
* The default constructor calls the more specific constructor with a new left
|
||||
* and right half.
|
||||
*/
|
||||
public Heart() {
|
||||
this(new Half(Half.Side.LEFT), new Half(Half.Side.RIGHT));
|
||||
}
|
||||
|
||||
/**
|
||||
* The default constructor adds the left and the right half that are specified
|
||||
* as parameters and sets the start state to diastole.
|
||||
*/
|
||||
public Heart(Half leftHalf, Half rightHalf) {
|
||||
state = State.DIASTOLE;
|
||||
heartRate = AVERAGE_HEART_RATE;
|
||||
halves = new ArrayList<>();
|
||||
halves.add(leftHalf);
|
||||
halves.add(rightHalf);
|
||||
initalizeState();
|
||||
}
|
||||
|
||||
public void initalizeState(){
|
||||
for(Half half : halves){
|
||||
half.initializeState(state);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Executes a sequence of diastole and systole, beginning with the current
|
||||
* state.
|
||||
*
|
||||
* @throws HeartBeatDysfunctionException when Valve.IllegalValveStateException or
|
||||
* InvalidValvePositionException occurs during diastole or systole
|
||||
* TODO Implement a pause mechanism based on the current heart rate
|
||||
*/
|
||||
public void executeHeartBeat() throws HeartBeatDysfunctionException {
|
||||
try {
|
||||
if (state.equals(State.DIASTOLE)) {
|
||||
executeDiastole();
|
||||
executeSystole();
|
||||
} else {
|
||||
executeSystole();
|
||||
executeDiastole();
|
||||
}
|
||||
} catch (Valve.IllegalValveStateException | InvalidValvePositionException e) {
|
||||
System.out.println(e.getMessage());
|
||||
throw new HeartBeatDysfunctionException("Heart is in an invalid state!", e);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Executes the diastole phase of the heart.
|
||||
*
|
||||
* @throws Valve.IllegalValveStateException when one of the valves has an illegal State
|
||||
*/
|
||||
public void executeDiastole() throws Valve.IllegalValveStateException {
|
||||
for (Half half : halves) {
|
||||
half.closeSemilunarValve();
|
||||
half.openAtrioventricularValve();
|
||||
half.relaxAtrium();
|
||||
half.relaxVentricle();
|
||||
}
|
||||
state = State.SYSTOLE;
|
||||
}
|
||||
|
||||
/**
|
||||
* Executes the systole phase of the heart.
|
||||
*
|
||||
* @throws Valve.IllegalValveStateException when one of the valves has an illegal State
|
||||
*/
|
||||
public void executeSystole() throws Valve.IllegalValveStateException {
|
||||
for (Half half : halves) {
|
||||
half.openSemilunarValve();
|
||||
half.closeAtrioventricularValve();
|
||||
half.contractAtrium();
|
||||
half.contractVentricle();
|
||||
}
|
||||
state = State.DIASTOLE;
|
||||
}
|
||||
|
||||
public State getState() {
|
||||
return state;
|
||||
}
|
||||
|
||||
public void setState(State state) {
|
||||
this.state = state;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the heart rate to the parameter value in Hz.
|
||||
* Rate has to be inside range >30 && <220
|
||||
* If rate is outside of range method rejects the change
|
||||
* and returns false.
|
||||
*
|
||||
* @param frequencyInHz which should be applied to the heart
|
||||
* @return true if the heart rate could be set, false otherwise
|
||||
*/
|
||||
public boolean setHeartRate(int frequencyInHz) {
|
||||
if (frequencyInHz < 30 || frequencyInHz > 220) {
|
||||
return false;
|
||||
}
|
||||
this.heartRate = frequencyInHz;
|
||||
return true;
|
||||
}
|
||||
|
||||
public int getHeartRate() {
|
||||
return heartRate;
|
||||
}
|
||||
|
||||
public List<Half> getHalves() {
|
||||
return halves;
|
||||
}
|
||||
|
||||
public static class HeartBeatDysfunctionException extends Exception {
|
||||
public HeartBeatDysfunctionException() {
|
||||
}
|
||||
|
||||
public HeartBeatDysfunctionException(String message) {
|
||||
super(message);
|
||||
}
|
||||
|
||||
public HeartBeatDysfunctionException(String message, Throwable cause) {
|
||||
super(message, cause);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* The main method instantiates a heart object and executes a single heartbeat.
|
||||
*
|
||||
* @param args
|
||||
*/
|
||||
public static void main(String[] args) throws HeartBeatDysfunctionException {
|
||||
Heart heart = new Heart();
|
||||
heart.executeHeartBeat();
|
||||
}
|
||||
}
|
|
@ -0,0 +1,9 @@
|
|||
package ch.zhaw.prog2.heartbeat;
|
||||
|
||||
public class InvalidValvePositionException extends RuntimeException {
|
||||
|
||||
public InvalidValvePositionException (String message) {
|
||||
super (message);
|
||||
}
|
||||
|
||||
}
|
|
@ -0,0 +1,44 @@
|
|||
package ch.zhaw.prog2.heartbeat;
|
||||
/**
|
||||
* This class represents a pacemaker for a human hart.
|
||||
*
|
||||
* This is an incomplete implementation, reduced to the essentials for the content of the lab.
|
||||
* There would be a lot more code needed to implement a pacemaker, but this is not part of this lab :-)
|
||||
*
|
||||
* @author muon
|
||||
*
|
||||
*/
|
||||
public class Pacemaker {
|
||||
Heart heart;
|
||||
|
||||
/**
|
||||
* Constructor of Pacemaker
|
||||
* @param heart
|
||||
*/
|
||||
public Pacemaker(Heart heart) {
|
||||
this.heart = heart;
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the heart rate to the parameter value in Hz.
|
||||
* Rate has to be inside range >30 && <220
|
||||
* If frequency can be applied on heart, the current frequency will be returned.
|
||||
* If heart does reject the change the method throws an exception.
|
||||
*
|
||||
* @param frequencyInHz needs to be applied on heart
|
||||
* @return current frequency of the heart
|
||||
* @throws IllegalArgumentException when heart does reject the change
|
||||
*/
|
||||
public int setHeartRate(int frequencyInHz) {
|
||||
if(!heart.setHeartRate(frequencyInHz)){
|
||||
throw new IllegalArgumentException("Frequency could not be set.");
|
||||
}
|
||||
return heart.getHeartRate();
|
||||
}
|
||||
|
||||
/*
|
||||
...
|
||||
There would be a lot more code needed to implement a pacemaker, but this is not part of this lab :-)
|
||||
...
|
||||
*/
|
||||
}
|
|
@ -0,0 +1,19 @@
|
|||
package ch.zhaw.prog2.heartbeat.parts;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.Half.Side;
|
||||
import ch.zhaw.prog2.heartbeat.Heart;
|
||||
|
||||
public class AtrioventricularValve extends Valve {
|
||||
|
||||
public AtrioventricularValve(Side side) {
|
||||
super (side);
|
||||
}
|
||||
|
||||
public void initializeState(Heart.State state) {
|
||||
if(Heart.State.DIASTOLE.equals(state)){
|
||||
setOpen(false);
|
||||
}else{
|
||||
setOpen(true);
|
||||
}
|
||||
}
|
||||
}
|
|
@ -0,0 +1,20 @@
|
|||
package ch.zhaw.prog2.heartbeat.parts;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.Half.Side;
|
||||
|
||||
public class Atrium {
|
||||
private Side side;
|
||||
|
||||
public Atrium (Side side) {
|
||||
this.side = side;
|
||||
}
|
||||
|
||||
public void contract() {
|
||||
System.out.println("Atrium "+ side + " is contracting.");
|
||||
}
|
||||
|
||||
public void relax() {
|
||||
System.out.println("Atrium "+ side + " is relaxing.");
|
||||
}
|
||||
|
||||
}
|
|
@ -0,0 +1,20 @@
|
|||
package ch.zhaw.prog2.heartbeat.parts;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.Half.Side;
|
||||
import ch.zhaw.prog2.heartbeat.Heart;
|
||||
|
||||
public class SemilunarValve extends Valve {
|
||||
|
||||
public SemilunarValve(Side side) {
|
||||
super (side);
|
||||
}
|
||||
|
||||
public void initializeState(Heart.State state) {
|
||||
if(Heart.State.DIASTOLE.equals(state)){
|
||||
setOpen(true);
|
||||
}else{
|
||||
setOpen(false);
|
||||
}
|
||||
}
|
||||
|
||||
}
|
|
@ -0,0 +1,61 @@
|
|||
package ch.zhaw.prog2.heartbeat.parts;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.Half.Side;
|
||||
|
||||
public abstract class Valve {
|
||||
|
||||
private boolean open;
|
||||
private Side side;
|
||||
|
||||
public Valve(Side side) {
|
||||
this.side = side;
|
||||
}
|
||||
|
||||
/**
|
||||
* Opens the valve
|
||||
*
|
||||
* @throws IllegalValveStateException when the valve is already open
|
||||
*/
|
||||
public void open() throws IllegalValveStateException {
|
||||
if (open) {
|
||||
throw new IllegalValveStateException(this.getClass().getSimpleName() + " " + side + " valve is already open.");
|
||||
}
|
||||
System.out.println(this.getClass().getSimpleName() + " " + side + " is opening.");
|
||||
open = true;
|
||||
}
|
||||
|
||||
/**
|
||||
* Closes the valve
|
||||
*
|
||||
* @throws IllegalValveStateException when valve is already closed
|
||||
*/
|
||||
public void close() throws IllegalValveStateException {
|
||||
if (!open) {
|
||||
throw new IllegalValveStateException(this.getClass().getSimpleName() + " " + side + " valve is already closed.");
|
||||
}
|
||||
System.out.println(this.getClass().getSimpleName() + " " + side + " is closing.");
|
||||
open = false;
|
||||
}
|
||||
|
||||
public boolean isOpen() {
|
||||
return open;
|
||||
}
|
||||
|
||||
protected void setOpen(Boolean open) {
|
||||
this.open = open;
|
||||
}
|
||||
|
||||
public static class IllegalValveStateException extends Exception {
|
||||
|
||||
public IllegalValveStateException() {
|
||||
}
|
||||
|
||||
public IllegalValveStateException(String message) {
|
||||
super(message);
|
||||
}
|
||||
|
||||
public IllegalValveStateException(String message, Throwable cause) {
|
||||
super(message, cause);
|
||||
}
|
||||
}
|
||||
}
|
|
@ -0,0 +1,20 @@
|
|||
package ch.zhaw.prog2.heartbeat.parts;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.Half.Side;
|
||||
|
||||
public class Ventricle {
|
||||
private Side side;
|
||||
|
||||
public Ventricle (Side side) {
|
||||
this.side = side;
|
||||
}
|
||||
|
||||
public void contract() {
|
||||
System.out.println("Chamber "+ side + " is contracting.");
|
||||
}
|
||||
|
||||
public void relax() {
|
||||
System.out.println("Chamber "+ side + " is relaxing.");
|
||||
}
|
||||
|
||||
}
|
|
@ -0,0 +1,118 @@
|
|||
/*
|
||||
* Test Class for Heart
|
||||
*/
|
||||
package ch.zhaw.prog2.heartbeat;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.*;
|
||||
import static org.mockito.Mockito.*;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.parts.Valve;
|
||||
import org.junit.jupiter.api.Disabled;
|
||||
import org.junit.jupiter.api.Test;
|
||||
|
||||
import ch.zhaw.prog2.heartbeat.Heart.State;
|
||||
|
||||
class HeartTest {
|
||||
/**
|
||||
* This is a very simple test to check if Junit and Mockito are properly set up.
|
||||
*/
|
||||
@Test
|
||||
void testTheTest() {
|
||||
Heart classUnderTest = new Heart();
|
||||
assertNotNull(classUnderTest.getState(), "The heart must have a state.");
|
||||
}
|
||||
|
||||
/**
|
||||
* Tests a single heartbeat
|
||||
*/
|
||||
@Test
|
||||
void testHeartBeat() throws Heart.HeartBeatDysfunctionException {
|
||||
Heart heart = new Heart();
|
||||
State startState = heart.getState();
|
||||
|
||||
heart.executeHeartBeat();
|
||||
|
||||
// after one heartbeat, the heart must be in the same state as before
|
||||
assertEquals(startState, heart.getState());
|
||||
}
|
||||
|
||||
/**
|
||||
* Tests if the valves are open or closed depending on the status of the heart
|
||||
*/
|
||||
@Test
|
||||
void testValveStatus() throws Heart.HeartBeatDysfunctionException {
|
||||
Heart heart = new Heart();
|
||||
|
||||
heart.executeHeartBeat();
|
||||
|
||||
State state = heart.getState();
|
||||
|
||||
if (state.equals(Heart.State.DIASTOLE)) {
|
||||
for (Half half : heart.getHalves()) {
|
||||
assertFalse(half.isAtrioventricularValveOpen());
|
||||
assertTrue(half.isSemilunarValveOpen());
|
||||
}
|
||||
} else if ((state.equals(Heart.State.SYSTOLE))) {
|
||||
for (Half half : heart.getHalves()) {
|
||||
assertTrue(half.isAtrioventricularValveOpen());
|
||||
assertFalse(half.isSemilunarValveOpen());
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Tests if the hart throws the appropriate Exception, when malfunction was detected during hartBeat
|
||||
*/
|
||||
@Test
|
||||
void testExecuteHeartBeatErrorBehaviour() {
|
||||
Heart heart = new Heart();
|
||||
// prepare error situation due to wrong initialization
|
||||
heart.setState(State.SYSTOLE);
|
||||
|
||||
assertThrows(Heart.HeartBeatDysfunctionException .class, // verification using lambda
|
||||
() -> heart.executeHeartBeat());
|
||||
}
|
||||
|
||||
/**
|
||||
* Tests if the hart throws the appropriate Exception, when malfunction was detected during hartBeat
|
||||
* with exception Stubbing
|
||||
*/
|
||||
@Disabled
|
||||
void testExecuteHartBeatErrorBehaviourWithStubbing() throws Valve.IllegalValveStateException {
|
||||
//TODO implement and replace the annotation @Disabled by @Test
|
||||
fail();
|
||||
}
|
||||
|
||||
/**
|
||||
* We test if Heart::executeHeartbeat() sends the right signals to both of its
|
||||
* halves.
|
||||
*
|
||||
* When Half::contractVentricle() is called, Half::closeAtrioventricularValve()
|
||||
* and Half::openSemilunarValve() must have been called earlier.
|
||||
*
|
||||
*/
|
||||
@Disabled
|
||||
void testValvesBehavior() {
|
||||
//TODO implementand replace the annotation @Disabled by @Test
|
||||
fail();
|
||||
}
|
||||
|
||||
/**
|
||||
* This is code used for the lecture slide.
|
||||
*/
|
||||
@Test
|
||||
void testForSlide() throws Valve.IllegalValveStateException {
|
||||
Half mockedHalf = mock(Half.class);
|
||||
Heart heart = new Heart(mockedHalf, new Half(Half.Side.RIGHT));
|
||||
heart.setState(State.SYSTOLE);
|
||||
heart.initalizeState();
|
||||
|
||||
when(mockedHalf.isAtrioventricularValveOpen()).thenReturn(false);
|
||||
when(mockedHalf.isSemilunarValveOpen()).thenReturn(true);
|
||||
heart.executeSystole();
|
||||
|
||||
verify(mockedHalf).contractVentricle();
|
||||
verify(mockedHalf, times(1)).contractAtrium();
|
||||
}
|
||||
|
||||
}
|
|
@ -0,0 +1,31 @@
|
|||
package ch.zhaw.prog2.heartbeat;
|
||||
|
||||
import org.junit.jupiter.api.Disabled;
|
||||
import org.junit.jupiter.api.Test;
|
||||
import static org.junit.jupiter.api.Assertions.*;
|
||||
|
||||
/*
|
||||
* Test Class for Pacemaker
|
||||
*/
|
||||
public class PacemakerTest {
|
||||
|
||||
/**
|
||||
* Test if setHeartRate does throw correct exception when rate is rejected (because frequency is out of range)
|
||||
*/
|
||||
@Disabled
|
||||
void testSetHeartRateRejectsFrequenciesOutOfRange() {
|
||||
//TODO implement and replace the annotation @Disabled by @Test
|
||||
fail();
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* Test if setHeartRate does correctly set the rate when frequency is inside range
|
||||
*/
|
||||
@Disabled
|
||||
void testSetHeartRateAppliesFrequenciesInsideRange() {
|
||||
//TODO implement and replace the annotation @Disabled by @Test
|
||||
fail();
|
||||
}
|
||||
|
||||
}
|
|
@ -0,0 +1,99 @@
|
|||
:source-highlighter: coderay
|
||||
:icons: font
|
||||
:experimental:
|
||||
:!sectnums:
|
||||
:imagesdir: ../images/
|
||||
:handout: ./code/
|
||||
|
||||
:logo: IT.PROG2 -
|
||||
ifdef::backend-html5[]
|
||||
:logo: image:PROG2-300x300.png[IT.PROG2,100,100,role=right,fit=none,position=top right]
|
||||
endif::[]
|
||||
ifdef::backend-pdf[]
|
||||
:logo:
|
||||
endif::[]
|
||||
ifdef::env-github[]
|
||||
:tip-caption: :bulb:
|
||||
:note-caption: :information_source:
|
||||
:important-caption: :heavy_exclamation_mark:
|
||||
:caution-caption: :fire:
|
||||
:warning-caption: :warning:
|
||||
endif::[]
|
||||
|
||||
= {logo} Lösungen zum Praktikum Mock-Testing
|
||||
|
||||
:sectnums:
|
||||
:sectnumlevels: 2
|
||||
// Beginn des Aufgabenblocks
|
||||
|
||||
== Herz
|
||||
|
||||
****
|
||||
Funktionserläuterung zum Herzschlag finden Sie in der Aufgabenstellung
|
||||
****
|
||||
|
||||
== Aufgaben
|
||||
|
||||
=== Einführung in Mockito
|
||||
[loweralpha]
|
||||
. Studieren Sie die Testmethoden `HeartTest::testValveStatus()` und `HeartTest::testExecuteHartBeatErrorBehaviour()`.
|
||||
Dort wird *ein Teil* des Verhaltens des Herzens getestet.
|
||||
|
||||
. Implementieren Sie die Methoden `Heart::executeDiastole()`, `Heart::executeSystole()` und `Heart::executeHeartBeat()` sodass die bestehenden Tests durchlaufen und das oben beschriebene Verhalten des Herzens modelliert wird.
|
||||
|
||||
. (optional) Ein echtes Herz hat eine Schlagfrequenz.
|
||||
Implementieren Sie, dass das Herz nach jeder Systole pausiert.
|
||||
|
||||
****
|
||||
Siehe Musterlösung: `Heart.executeDiastole()`, `Heart.executeSystole()` und `Heart.executeHeartBeat()`
|
||||
****
|
||||
|
||||
|
||||
=== Fragen zu Testing [TU]
|
||||
[loweralpha]
|
||||
. Testing kann in zwei unterschiedliche Strategien aufgeteilt werden.
|
||||
Zum einen gibt es White-Box-Testing und zum zweiten Black-Box-Testing.
|
||||
Was für Java Libraries gibt es, um diese zwei Strategien zu testen?
|
||||
Wann wenden Sie welche Strategie an?
|
||||
+
|
||||
****
|
||||
* JUnit ist ein Framework für Unit-Tests (auch Modul-Tests genannt).
|
||||
Es wird sowohl für White-Box-Testing als auch für Black-Box-Testing angewendet.
|
||||
|
||||
* Für White-Box-Testing eignet sich Mockito, weil damit die Abläufe innerhalb einer Klasse getestet werden können (behavior testing).
|
||||
|
||||
* Black-Box-Testing trifft keine Annahmen darüber, *wie* eine Klasse oder Methode eine Aufgabe erledigt.
|
||||
Es wird lediglich überprüft, ob auf eine bestimmte Eingabe die erwartete Ausgabe erfolgt.
|
||||
|
||||
* Nichttriviale Methoden sollten immer mindestens mit Black-Box-Testing getestet werden.
|
||||
Diese Tests werden am besten von einer anderen Person geschrieben als von der Programmierer:in.
|
||||
|
||||
* Für White-Box-Testing werden Informationen benötigt, *wie* eine Klasse oder Methode eine Aufgabe erledigt.
|
||||
****
|
||||
|
||||
. Das Erstellen von guten automatisierten Unit-Tests kann manchmal schwierig umzusetzen sein.
|
||||
Was ist der Hauptgrund dafür? Wie können Sie dieses Problem entschärfen?
|
||||
+
|
||||
****
|
||||
* Das Setup eines Unit-Tests kann kompliziert werden, wenn mehrere Klassen dafür instanziiert und konfiguriert werden müssen.
|
||||
* Das Problem kann entschärft werden, indem
|
||||
** die verschiedenen Klassen besser entkoppelt werden und
|
||||
** die Klassen, von denen die zu testende Klasse abhängig ist, zu mocken.
|
||||
****
|
||||
|
||||
. Der Testfokus war bisher auf der Klasse `Heart`.
|
||||
Testen Sie jetzt die Klasse `Half`. Wo verwenden Sie Stubbing, wo Mocking?
|
||||
+
|
||||
****
|
||||
* Die Funktionalität der Klasse Half nicht besonders umfangreich.
|
||||
Alle Methoden der Klasse bestehen aus nur genau einer Zeile und die Klasse hat bis auf das Datenfeld `Half.side` keinen State.
|
||||
Was schieflaufen könnte ist, dass jemand beispielweise auf einem Ventil anstatt der `close()` Methode die `open()` Methode aufruft.
|
||||
Weil wir in der Klasse `Half` nicht wirklich einen Status prüfen können, macht es mehr Sinn das Verhalten der Klasse zu prüfen (ruft die Klasse die richtigen Methoden auf)
|
||||
→ Das können wir mit Mocking (in Mockito mit `verify`) erreichen.
|
||||
Entsprechend würde sich hier ein Mock besser eignen als ein Stub.
|
||||
Über die Frage, wie sinnvoll es ist solch einfache Klassen zu simulieren, lässt sich Diskutieren und ist abhängig vom jeweiligen Testkonzept.
|
||||
|
||||
* Beim Auftrag die Klasse `Half` zu testen, stossen Sie auf das Problem, dass Sie weder Stubs noch Mocks anwenden können, weil die Klassen von welchen `Half` abhängt direkt im Konstruktor von `Half` initialisiert werden.
|
||||
Damit können Sie kein Test-Double verwenden (injecten).
|
||||
Das Problem könnten Sie lösen, wenn es einen entsprechenden Konstruktor in der Klasse `Half` gäbe, welche die Instanzen der Abhängigen Typen entgegennimmt (analog zu `Heart`).
|
||||
****
|
File diff suppressed because one or more lines are too long
Loading…
Reference in New Issue