MockK: шта је то, кључни појмови и синтакса

Шта је MockK?

MockK — је библиотека за креирање мок објеката, написана на Kotlin-у и оптимизована за његову синтаксу. Решава исте задатке као Mockito — изолација тестираног кода од зависности — али то чини користећи Kotlin-специфичне конструкције: ламбде, 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 са ламбдама, inline функције — да би обезбедио концизан и типно-безбедан API без губитка перформанси.

Како ради MockK

Механизам MockK-а се заснива на бајткод-инструментацији кроз библиотеку ByteBuddy (као и Mockito), али је облачи у Kotlin-пријатељски DSL. Уместо ланаца when().thenReturn(), MockK користи ламбда блокове every { } и coEvery { }, који изгледају као природно проширење језика. Испод хаубе, MockK пресреће позив унутар ламбде, анализира метод и аргументе кроз рефлексију и упарује их са забележеним правилима стаббинга.

Основна синтакса MockK-а

Блок every { mock.method() } returns value чита се као „сваки пут када се метод позове, врати вредност”. Оваква декларативна синтакса је ближа Kotlin стилу и елиминише забуну са редоследом аргумената у when(). Захваљујући reified generics у Kotlin-у, тип мока се изводи аутоматски без експлицитног навођења класе.

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: мање boilerplate-а

За разлику од Mockito-а, где сваки метод мора бити експлицитно подешен, MockK подржава relaxed mock — мок који враћа „разумне” подразумеване вредности за било који метод: празну листу за List, 0 за Int, празан стринг за String. Ово драстично смањује количину припремног кода.

// Relaxed mock — сви методи враћају подразумеване вредности
val api = mockk<ApiService>(relaxed = true)

// Не захтева стаббинг — вратиће празну листу
println(api.getUsers()) // []

Креирање мокова и релаксираних мокова

MockK нуди неколико начина за креирање мок објеката: mockk<T>() за строги мок (сваки метод мора бити експлицитно подешен), mockk<T>(relaxed = true) за релаксирани мок и spyk(obj) за креирање шпијуна на реалном објекту.

Избор између строгог и релаксираног мока зависи од контекста. Строги мок гарантује да тест не користи методе чије понашање није дефинисано — ово повећава поузданост. Релаксирани мок је згодан за брзо прототипирање тестова где нису све зависности важне. У пракси, препоручује се почети са строгим моком и прећи на relaxed само када стаббинг заузима више линија од самог теста.

Stubbing: подешавање понашања са every блоком

Every блок — централна конструкција стаббинга у MockK-у. Унутар ламбде се описује позив метода са конкретним аргументима, а затим се враћа вредност кроз returns, баца изузетак кроз throws или израчунава одговор кроз answers.

Различити начини стаббинга

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 за корутине

Verify у MockK-у је аналоган Mockito.verify() по значењу, али користи Kotlin DSL: verify { mock.method() }. За suspend-функције користи се coVerify { mock.suspendMethod() }, који коректно ради са корутинама и не захтева специјални раннер.

Провера броја позива

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 за креирање мокова кроз иницијализацију у JUnit 5. Екстензија MockKExtension аутоматски креира мокове пре сваког теста и чисти после — аналогно MockitoExtension-у, али са подршком за relaxed режим.

Пример са MockKExtension

Анотација @InjectMockKs (или алтернатива @MockK са експлицитним креирањем објекта) убризгава мокове у тестирани инстанцу. Ово смањује 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 vs Mockito: шта изабрати за Kotlin

Избор између MockK-а и Mockito-а зависи од састава тима и типа пројекта. Mockito има већи екосистем, више примера и интеграција, али MockK пружа чистију Kotlin синтаксу и нативну подршку за језичке функције. За нове Kotlin пројекте, MockK се препоручује као идиоматичније решење.

За пројекте на чистом Kotlin-у (без Java класа) MockK је пожељнији: мање boilerplate-а, нативна подршка за корутине, без изненађења са final класама. За хибридне пројекте или тимове са Java позадином, Mockito остаје радна опција — обе библиотеке се могу користити у истом пројекту кроз различите модуле. При миграцији са Mockito-а на MockK, довољно је заменити анотације @Mock са @MockK и преписати блокове when().thenReturn() у формат every { }.