argumentcaptor and source classes added into mockito post

Author: maciej-nowak

_drafts/2019-01-21-mockito.md

@@ -12,6 +12,43 @@ keywords: "testowanie, testing, testy, jednostkowe, automatyczne, lokalne, instr
 ## Dublerzy
 Testy jednostkowe rzadko kiedy dotyczą jednostki testowej wolnej od zależności innych obiektów co w konsekwencji prowadzi do definicji problemu tworzenia niezależnych testów na których rezultat nie ma wpływu żadna zależność testowanej jednostki. Wymaganą prawdziwą zależność można czasami dostarczyć ręcznie jednakże jest to kosztowne, obarczone marginesem błędu oraz często niewykonalne (szczególnie w przypadku testów instrumentalnych). Alternatywą dla tworzenia prawdziwych zależności jest dostarczanie `dublerów` (`double test`), które można sklasyfikować ze względu na przeznaczenie. Jedna z wielu definicji wyróżnia m.in. następujące obiekty: `dummy`, `fake`, `stub` i `mock`. `Dummy` jest przekazywany w celu spełnienia założeń sygnatury jednak jego metody nie są wywoływane. `Fake` posiada uproszczoną działającą implementacje spełniającą założenia interakcji. `Stub` dostarcza minimalną implementacją zależności, która pomija proces obliczeniowy i bezpośrednio zwraca zdefiniowany rezultat w taki sposób, aby test wykonał się pozytywnie. Natomiast `mock` to naiwna implementacja zależności, która bierze udział w procesie testowania i rejestruje nawiązane z nią interakcje, przeznaczona do badania zachowania. Mnogość definicji podziału dublerów oraz wynikające z tego różnice są powodem wielu niejasności, a sama terminologia jest mało istotna w procesie tworzenia zastępników. Pozwala on jednak zrozumieć co dokładnie i w jaki sposób ma zostać przetestowane. `Mockito` jest frameworkiem wspomagającym pisanie testów jednostkowych poprzez dostarczanie dublerów, które dzieli na zwyczajne `Mock` oraz częściowe `Spy`.
 
+>**Przykład**  
+>Na podstawie poniższych klas Manager oraz Data zostaną przedstawione cechy i właściwości zarządzania naiwnymi implementacjami w Mockito.
+
+{% highlight kotlin %}
+class Manager(val data: Data) {
+
+    fun fetchData(): String {
+        return data.getInfo()
+    }
+
+    fun fetchDataWithMessage(message: String): String {
+        return data.getInfo(message)
+    }
+}
+
+data class Data(var number: Int, var text: String) {
+
+    constructor() : this(0, "")
+
+    fun getInfo(): String {
+        return "$text $number"
+    }
+
+    fun getInfo(message: String?): String {
+        return "$message $number"
+    }
+
+    fun publicMethod(): String {
+        return privateMethod()
+    }
+
+    private fun privateMethod(): String {
+        return "private returned from public"
+    }
+}
+{% endhighlight %}
+
 ## Tworzenie
 Obiekt zastępnika oznaczony adnotacją `@Mock` lub `@Spy` może zostać inicjalizowany na kilka sposobów, m.in. poprzez uruchomienie klasy z użyciem `@RunWith(MockitoJUnitRunner.class)`, wykorzystanie zasady `MockitoJUnit.rule()` lub manualną inicjalizację za pomocą metody `MockitoAnnotations.initMocks()`. Instancję atrapy można uzyskać statyczną metodą `mock()` lub `spy()` co pozwala na pominięcie adnotacji.
 
@@ -223,17 +260,22 @@ class AnswerTest {
 {% endhighlight %}
 
 ## Weryfikacja
-Mockito przechowuje informacje na temat wszystkich wywołań metod wraz z użytymi argumentami. Dzięki temu pozwala na śledzenie działalności atrap oraz weryfikację ich wywołań za pomocą funkcji `verify()`.
+Mockito przechowuje informacje na temat wszystkich wywołań metod wraz z użytymi argumentami. Dzięki temu pozwala na śledzenie działalności atrap oraz weryfikację ich wywołań za pomocą funkcji `verify()`. Aby uzyskać informacje nt argumentów wywołań funkcji należy wykorzystać `ArgumentCaptor`.
 
 {% highlight kotlin %}
-@RunWith(MockitoJUnitRunner::class)
 class VerifyTest {
 
+    lateinit var mock: Data
+    lateinit var manager: Manager
+
+    @Before
+    fun init() {
+        mock = mock(Data::class.java)
+        manager = Manager(mock)
+    }
+
     @Test
     fun checkHowManyTimesGetInfoCalled() {
-        val mock = mock(Data::class.java)
-        val manager = Manager(mock)
-
         verifyZeroInteractions(mock) //any methods called on the mock
         verify(mock, never()).getInfo()
 
@@ -244,6 +286,17 @@ class VerifyTest {
         verify(mock, atMost(3)).getInfo()
         verifyNoMoreInteractions(mock) //no others method called
     }
+
+
+    @Test
+    fun checkArgsOfGetInfo() {
+        val captor = forClass(String::class.java)
+        manager.fetchDataWithMessage("message")
+
+        //verify args passed into getInfo method
+        verify(mock).getInfo(captor.capture())
+        assertEquals("message", captor.value)
+    }
 }
 {% endhighlight %}