junit example tested code added

Author: maciej-nowak

_drafts/2019-01-14-junit.md

@@ -24,6 +24,100 @@ Podstawą procesu testowania jest tworzenie i wykonywanie testów jednostkowych,
 ## Dobre praktyki
 Tworząc metody testowe należy przede wszystkim pamiętać o wykluczeniu wszelkich zależności w taki sposób, aby na wynik testu testowanej jednostki nie miały wpływu inne zależności. Klasy testowe powinny znajdować się w pakiecie o tej samej nazwie co klasy implementacji, a nazwy klas testowych powinny być podobne do klas testowanych. Metody opisowe powinny być nazywane w sposób opisowy i jednoznaczny w nawiązaniu do celu testu nawet jeśli z tego powodu nazwa metody jest długa. W tym celu można posłużyć się konwencją `Given/When/Then`, gdzie `Given` określa warunki początkowe, `When` opisuje akcje, a `Then` informuje o oczekiwanym rezultacie. Ponadto należy dążyć do minimalizacji asercji, czasu wykonywania testów oraz zwiększać pokrycie kodu. Testy powinny być krótkie, proste i ściśle dotyczyć jednej jednostki. Jeśli sytuacja tego wymaga należy wykorzystywać metody cyklu życia testów, aby zapewnić odpowiednią inicjalizację i czyszczenie środowiska.
 
+>**Przykład**  
+>Klasa `Game` zarządza rozgrywką w grze komputerowej w której dwie przeciwne drużyny walczą o zwycięstwo zdobywając bramki. W odniesieniu do implementacji klasy `Game` zostaną przeprowadzone testy przedstawiające dobre praktyki oraz charakterystykę testów jednostkowych `JUnit4` dla Android.
+
+{% highlight kotlin %}
+class Game {
+
+    private val redTeam = mutableListOf<String>()
+    private val blueTeam = mutableListOf<String>()
+    private var redGoals = 0
+    private var blueGoals = 0
+    private var gameStarted = false
+
+    fun start() {
+        if(!gameStarted && teamsSizesEquals()) {
+            gameStarted = true
+            redGoals = 0
+            blueGoals = 0
+            //do and allow for some actions
+        }
+    }
+
+    fun stop() {
+        if(gameStarted) {
+            gameStarted = false
+            //do some other actions
+        }
+    }
+
+    fun clearTeams() {
+        redTeam.clear()
+        blueTeam.clear()
+    }
+
+    fun addPlayer(team: Team, player: String): Boolean {
+        if(allowToAddPlayer(player)) {
+            when(team) {
+                Team.RED -> { redTeam.add(player) }
+                Team.BLUE -> { blueTeam.add(player) }
+            }
+            return true
+        }
+        else return false
+    }
+
+    fun removePlayer(player: String): Boolean {
+        if(allowToRemovePlayer(player)) {
+            if(redTeam.contains(player)) redTeam.remove(player)
+            else blueTeam.remove(player)
+            return true
+        }
+        else return false
+    }
+
+    fun goal(team: Team) {
+        when(team) {
+            Team.RED -> { redGoals++ }
+            Team.BLUE -> { blueGoals++ }
+        }
+    }
+
+    fun getScore(): String {
+        return "RED $redGoals:$blueGoals BLUE"
+    }
+
+    fun getRedTeam(): List<String> {
+        return redTeam
+    }
+
+    fun getBlueTeam(): List<String> {
+        return blueTeam
+    }
+
+    fun hasStarted(): Boolean {
+        return gameStarted
+    }
+
+    private fun allowToAddPlayer(player: String): Boolean {
+        return (!gameStarted && !redTeam.contains(player) && !blueTeam.contains(player))
+    }
+
+    private fun allowToRemovePlayer(player: String): Boolean {
+        return (!gameStarted && (redTeam.contains(player) || blueTeam.contains(player)))
+    }
+
+    private fun teamsSizesEquals(): Boolean {
+        return redTeam.size != 0 && blueTeam.size != 0 && redTeam.size.equals(blueTeam.size)
+    }
+
+    enum class Team {
+        RED, BLUE;
+    }
+}
+{% endhighlight %}
+
 ## Klasa testowa
 Testy w JUnit (metody) zawierają się w `klasie testowej`, które z kolei mogą być częścią `zestawu klas testowych`. Aby klasa była klasą testową w JUnit4 musi zawierać deklarację przynajmniej jednej metody testowej oznaczonej adnotacją `@Test`. Podstawowym elementem testów są asercje sprawdzające wartość logiczną, równość wartości czy referencji.