MockK: τι είναι, βασικές έννοιες και σύνταξη

Τι είναι το MockK;

MockK — είναι μια βιβλιοθήκη για τη δημιουργία mock-αντικειμένων, γραμμένη σε Kotlin και βελτιστοποιημένη για τη σύνταξή του. Λύνει τις ίδιες εργασίες με το Mockito — απομόνωση του ελεγχόμενου κώδικα από εξαρτήσεις — αλλά το κάνει χρησιμοποιώντας κατασκευές ειδικές για Kotlin: lambda, DSL, reified generics και συναρτήσεις suspend.

Το κύριο πλεονέκτημα του MockK έναντι των μεταφερμένων λύσεων — η εγγενής υποστήριξη του Kotlin. Στο Mockito, η πραξιμοποίηση final κλάσης απαιτεί opt-in (mockito-inline), και στατικών μεθόδων — mockStatic. Το MockK υποστηρίζει αυτό από προκαθορισμού, καθώς οι κλάσεις Kotlin είναι από προκαθορισμού final, και η παράκαμψη αυτού του περιορισμού είναι ενσωματωμένη στην αρχιτεκτονική της βιβλιοθήκης.

Έκδοση 1.13.12 (2024) — μια σταθερή έκδοση που υποστηρίζει Kotlin 2.0, τον μεταγλωττιστή K2 και πολυ-πλατφορμικά έργα (KMP). Το MockK λειτουργεί επίσης με Kotlin/Native και Kotlin/JS, καθιστώντας το τη μοναδική επιλογή για έργα KMP όπου ούτε το Mockito ούτε το EasyMock είναι εφαρμόσιμα.

Το MockK έχει σχεδιαστεί λαμβάνοντας υπόψη τις ιδιαιτερικότητες του Kotlin και χρησιμοποιεί τις δυνατότητες της γλώσσας — reified generics, DSL με lambda, συναρτήσεις inline — για να παρέχει ένα συντομο και ασφαλές από άποψη τύπων API χωρίς απώλεια απόδοσης.

Πώς λειτουργεί το MockK

Ο μηχανισμός του MockK βασίζεται σε προσαρμογή bytecode μέσω της βιβλιοθήκης ByteBuddy (όπως και το Mockito), αλλά το περιτυλίσσει σε ένα DSL φιλικό προς το Kotlin. Αντί για αλυσίδες when().thenReturn(), το MockK χρησιμοποιεί μπλοκ lambda every { } και coEvery { }, που μοιάζουν με φυσική επέκταση της γλώσσας. Κάτω από την επιφάνεια, το MockK παρακολουθεί την κλήση μέσα στο lambda, αναλύει τη μέθοδο και τα ορίσματα μέσω ανάκλασης και τα ταιριάζει με τους καταγεγραμμένους κανόνες stubbing.

Βασική σύνταξη MockK

Το μπλοκ every { mock.method() } returns value διαβάζεται ως “κάθε φορά που η μέθοδος καλείται, επίστρεψε την τιμή”. Μια τέτοια δηλωτική σύνταξη είναι πιο κοντά στο στυλ Kotlin και εξαλείφει τη σύγχυση με τη σειρά των ορισμάτων στο when(). Χάρη στα reified generics του Kotlin, ο τύπος του mock συμπεραίνεται αυτόματα χωρίς ρητή καθορισμό κλάσης.

val repository = mockk<UserRepository>()

// Stubbing: κάθε κλήση findById(1) επιστρέφει τον χρήστη
every { repository.findById(1) } returns User("Alice")

// Κλήση και επαλήθευση
val result = repository.findById(1)
assertEquals("Alice", result.name)

Relaxed mock: λιγότερο βοηθητικό κώδικα

Σε αντίθεση με το Mockito, όπου κάθε μέθοδος πρέπει να ρυθμιστεί ρητά, το MockK υποστηρίζει relaxed mock — ένα mock που επιστρέφει “λογικές” προκαθορισμένες τιμές για οποιαδήποτε μέθοδο: κενή λίστα για List, 0 για Int, κενή συμβολοσειρά για String. Αυτό μειώνει δραστικά την ποσότητα του προετοιμαστικού κώδικα.

// Relaxed mock — όλες οι μεθοδοι επιστρέφουν προκαθορισμένες τιμές
val api = mockk<ApiService>(relaxed = true)

// Δεν απαιτεί stubbing — θα επιστρέψει κενή λίστα
println(api.getUsers()) // []

Δημιουργία mock και relaxed mock

Το MockK προσφέρει αρκετούς τρόπους για τη δημιουργία mock-αντικειμένων: mockk<T>() για αυστηρό mock (κάθε μέθοδος πρέπει να ρυθμιστεί ρητά), mockk<T>(relaxed = true) για relaxed mock και spyk(obj) για τη δημιουργία spy σε ένα πραγματικό αντικείμενο.

Η επιλογή μεταξύ αυστηρού και relaxed mock εξαρτάται από το πλαίσιο. Το αυστηρό mock εγγυάται ότι το τεστ δεν χρησιμοποιεί μεθόδους των οποίων η συμπεριφορά δεν είναι καθορισμένη — αυτό αυξάνει την αξιοπιστία. Το relaxed mock είναι βολικό για γρήγορη προτοσυποίηση δοκιμών όπου δεν είναι όλες οι εξαρτήσεις σημαντικές. Στην πρακτική, συνιστάται να ξεκινάτε με αυστηρό mock και να μεταβαίνετε σε relaxed μόνο όταν το stubbing καταλαμβάνει περισσότερες γραμμές από ότι η ίδια η δοκιμή.

Stubbing: ρύθμιση συμπεριφοράς με μπλοκ every

Το μπλοκ every — είναι η κεντρική κατασκευή stubbing στο MockK. Μέσα στο lambda, περιγράφεται μια κλήση μεθόδου με συγκεκριμένα ορίσματα, και στη συνέχεια η τιμή επιστρέφεται μέσω returns, η εξαίρεση ρίχνεται μέσω throws ή η απάντηση υπολογίζεται μέσω answers.

Διαφορετικοί τρόποι stubbing

Το MockK υποστηρίζει όλα τα σενάρια που απαιτούνται για δοκιμές: επιστροφή τιμής, ρίξιμο εξαίρεσης, υπολογισμός απάντησης βάσει ορισμάτων, πολλαπλές απαντήσεις σε σειρά (σειρά κλήσεων).

// Επιστροφή τιμής
every { repo.findById(1) } returns User("Alice")

// Ρίξιμο εξαίρεσης
every { repo.findById(999) } throws NotFoundException()

// Δυναμική απάντηση
every { repo.save(any()) } answers {
    val user = firstArg<User>()
    user.copy(id = 42)
}

// Σειρά απαντήσεων
every { repo.findAll() } returnsMany listOf(
    listOf(User("Alice")),
    listOf(User("Bob")),
    emptyList()
)

Verify και coVerify για coroutine

Verify στο MockK είναι ανάλογο με το Mockito.verify() σημασιολογικά, αλλά χρησιμοποιεί DSL Kotlin: verify { mock.method() }. Για συναρτήσεις suspend χρησιμοποιείται το coVerify { mock.suspendMethod() }, που λειτουργεί σωστά με τα coroutine και δεν απαιτεί ειδικό εκτελεστή.

Έλεγχος αριθμού κλήσεων

Το MockK υποστηρίζει τους ίδιους τροποποιητές με το Mockito: exactly(1), atLeast(2), atMost(5), wasNot(Called). Η σύνταξη είναι μινιμαλιστική — ο τροποποιητής μεταβιβάζεται ως πρώτο όρισμα στο verify { }.

// Έλεγχος: η μέθοδος κλήθηκε ακριβώς 1 φορά
verify(exactly = 1) { repo.save(any()) }

// Έλεγχος σειράς κλήσεων
verifySequence {
    repo.save(any())
    repo.flush()
}

// coVerify για συναρτήσεις suspend
coVerify { api.fetchUsers() }

Slot: σύλληψη ορισμάτων

Για τον έλεγχο ορισμάτων χρησιμοποιείται το slot() — ανάλογο του ArgumentCaptor. Το slot δηλώνεται πριν από την κλήση, μεταβιβάζεται στο every ή verify, και μετά την εκτέλεση του τεστ περιέχει τη συλληφθείσα τιμή.

val userSlot = slot<User>()

verify { repo.save(capture(userSlot)) }

assertEquals("Alice", userSlot.captured.name)

Σχολιασμοί MockK και ενσωμάτωση JUnit

Το MockK παρέχει σχολιασμούς @MockK και @RelaxedMockK για τη δημιουργία mock μέσω αρχικοποίησης στο JUnit 5. Η επέκταση MockKExtension δημιουργεί αυτόματα mock πριν από κάθε δοκιμή και καθαρίζει μετά — ανάλογα με το MockitoExtension, αλλά με υποστήριξη της relaxed λειτουργίας.

Παράδειγμα με MockKExtension

Ο σχολιασμός @InjectMockKs (ή η εναλλακτική @MockK με ρητή δημιουργία αντικειμένου) ενχέει τα mock στο ελεγχόμενο στην δοκιμή. Αυτό μειώνει τον boilerplate κώδικα και κάνει τον κώδικα της δοκιμής πιο καθαρό.

@ExtendWith(MockKExtension::class)
class UserServiceTest {

    @MockK
    lateinit var repository: UserRepository

    @InjectMockKs
    lateinit var service: UserService

    @Test
    fun `getUser returns user from repository`() {
        every { repository.findById(1) } returns User("Alice")
        assertEquals("Alice", service.getUser(1)?.name)
    }
}

MockK εναντίον Mockito: τι να διαλέξετε για Kotlin

Η επιλογή μεταξύ MockK και Mockito εξαρτάται από τη σύνθεση της ομάδας και τον τύπο του έργου. Το Mockito έχει μεγαλύτερο οικοσύστημα, περισσότερα παραδείγματα και ενσωματώσεις, αλλά το MockK προσφέρει πιο καθαρή σύνταξη Kotlin και εγγενή υποστήριξη για τα χαρακτηριστικά της γλώσσας. Για νέα έργα Kotlin, το MockK συνιστάται ως η πιο ιδιοματική λύση.

Για έργα σε καθαρό Kotlin (χωρίς Java κλάσεις) το MockK είναι προτιμητέο: λιγότερος boilerplate, εγγενής υποστήριξη coroutine, χωρίς εκπλήξεις με final κλάσεις. Για υβριδικά έργα ή ομάδες με υποθάθρωση Java, το Mockito παραμένει μια λειτουργική επιλογή — και οι δύο βιβλιοθήκες μπορούν να χρησιμοποιηθούν σε ένα έργο μέσω διαφορετικών αρθρωμάτων. Κατά τη μετανάστευση από Mockito σε MockK, αρκεί να αντικαταστήσετε τις σχολιασμούς @Mock με @MockK και να επαναγράψετε τα μπλοκ when().thenReturn() σε μορφή every { }.