本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 中的模擬 適用於 Kotlin 的 AWS SDK
開發人員可以使用數個架構，透過 在測試中執行模擬 適用於 Kotlin 的 AWS SDK。本主題記錄一些架構所需的額外組態或特殊考量。
## MockK
當您使用 [MockK](https://mockk.io/) 模擬整個模組的延伸函數時，您需要執行[額外的組態](https://mockk.io/#extension-functions)。在適用於 Kotlin 的 SDK 中，分頁程式、等待程式和預先簽章程式是延伸函數的範例，因此在模擬其行為時，您需要額外的組態。
您必須先呼叫 ，`mockkStatic("")`才能設定您的模擬。一般而言，模組類別名稱為：
+ **分頁程式**： `aws.sdk.kotlin.services..paginators.PaginatorsKt`
+ **等待程式**： `aws.sdk.kotlin.services..waiters.WaitersKt`
+ **預先簽章者**： `aws.sdk.kotlin.services..presigners.PresignersKt`
例如，在以下包含模擬 `listBucketsPaginated`- 分頁器延伸函數 - 的測試中，我們新增 `mockkStatic("aws.sdk.kotlin.services.s3.paginators.PaginatorsKt")`：
```
@Test
fun testPaginatedListBuckets() = runTest {
mockkStatic("aws.sdk.kotlin.services.s3.paginators.PaginatorsKt")
val s3Client: S3Client = mockk()
val s3BucketLister = S3BucketLister(s3Client)
val expectedBuckets = listOf(
Bucket { name = "bucket1" },
Bucket { name = "bucket2" }
)
val response = ListBucketsResponse { buckets = expectedBuckets }
coEvery { s3Client.listBucketsPaginated() } returns flowOf(response)
val result = s3BucketLister.getAllBucketNames()
assertEquals(listOf("bucket1", "bucket2"), result)
}
```
如果沒有 `mockkStatic`，您會看到下列錯誤：
```
Missing mocked calls inside every { ... } block: make sure the object inside the block is a mock
io.mockk.MockKException: Missing mocked calls inside every { ... } block: make sure the object inside the block is a mock
at io.mockk.impl.recording.states.StubbingState.checkMissingCalls(StubbingState.kt:14)
at io.mockk.impl.recording.states.StubbingState.recordingDone(StubbingState.kt:8)
at io.mockk.impl.recording.CommonCallRecorder.done(CommonCallRecorder.kt:47)
at io.mockk.impl.eval.RecordedBlockEvaluator.record(RecordedBlockEvaluator.kt:63)
at io.mockk.impl.eval.EveryBlockEvaluator.every(EveryBlockEvaluator.kt:30)
at io.mockk.MockKDsl.internalCoEvery(API.kt:100)
at io.mockk.MockKKt.coEvery(MockK.kt:174)
```
如果前簽署者延伸函數沒有 `mockkStatic`，您可能會看到：
```
key is bound to the URI and must not be null
java.lang.IllegalArgumentException: key is bound to the URI and must not be null
at aws.sdk.kotlin.services.s3.serde.GetObjectOperationSerializer.serialize(GetObjectOperationSerializer.kt:26)
at aws.sdk.kotlin.services.s3.presigners.PresignersKt.presignGetObject(Presigners.kt:49)
at aws.sdk.kotlin.services.s3.presigners.PresignersKt.presignGetObject$default(Presigners.kt:40)
at aws.sdk.kotlin.services.s3.presigners.PresignersKt.presignGetObject-exY8QGI(Presigners.kt:30)
```
### 所有範例成品
#### 測試中的程式碼
```
import aws.sdk.kotlin.services.s3.S3Client
import aws.sdk.kotlin.services.s3.paginators.listBucketsPaginated
import kotlinx.coroutines.flow.filter
import kotlinx.coroutines.flow.toList
import kotlinx.coroutines.flow.transform
import kotlinx.coroutines.runBlocking
import org.slf4j.Logger
import org.slf4j.LoggerFactory
fun main() {
val logger: Logger = LoggerFactory.getLogger(::main.javaClass)
// Create an S3Client
S3Client { region = "us-east-1" }.use { s3Client ->
// Create service instance
val bucketLister = S3BucketLister(s3Client)
// Since getAllBucketNames is a suspend function, you'll need to run it in a coroutine scope
runBlocking {
val bucketNames = bucketLister.getAllBucketNames()
logger.info("Found buckets: $bucketNames")
}
}
}
class S3BucketLister(private val s3Client: S3Client) {
suspend fun getAllBucketNames(): List {
return s3Client.listBucketsPaginated()
.transform { response ->
response.buckets?.forEach { bucket ->
emit(bucket.name ?: "")
}
}
.filter { it.isNotEmpty() }
.toList()
}
}
```
#### 測試類別
```
import aws.sdk.kotlin.services.s3.S3Client
import aws.sdk.kotlin.services.s3.model.Bucket
import aws.sdk.kotlin.services.s3.model.ListBucketsResponse
import aws.sdk.kotlin.services.s3.paginators.listBucketsPaginated
import io.mockk.coEvery
import io.mockk.mockk
import io.mockk.mockkStatic
import kotlinx.coroutines.flow.flowOf
import kotlinx.coroutines.test.runTest
import org.junit.jupiter.api.Assertions.assertEquals
import org.junit.jupiter.api.Test
class S3BucketListerTest {
@Test
fun testPaginatedListBuckets() = runTest {
mockkStatic("aws.sdk.kotlin.services.s3.paginators.PaginatorsKt")
val s3Client: S3Client = mockk()
val s3BucketLister = S3BucketLister(s3Client)
val expectedBuckets = listOf(
Bucket { name = "bucket1" },
Bucket { name = "bucket2" }
)
val response = ListBucketsResponse { buckets = expectedBuckets }
coEvery { s3Client.listBucketsPaginated() } returns flowOf(response)
val result = s3BucketLister.getAllBucketNames()
assertEquals(listOf("bucket1", "bucket2"), result)
}
}
```
#### build.gradle.kts
```
plugins {
kotlin("jvm") version "2.1.20"
application
}
group = "org.example"
version = "1.0-SNAPSHOT"
repositories {
mavenCentral()
}
dependencies {
implementation(platform(awssdk.bom))
implementation(platform("org.apache.logging.log4j:log4j-bom:2.24.3"))
implementation(awssdk.services.s3)
implementation("org.apache.logging.log4j:log4j-slf4j2-impl")
// Testing Dependencies
testImplementation(platform("org.junit:junit-bom:5.11.0"))
testImplementation("org.junit.jupiter:junit-jupiter")
testImplementation("org.jetbrains.kotlinx:kotlinx-coroutines-test:1.7.3")
testImplementation("io.mockk:mockk:1.14.0")
}
tasks.test {
useJUnitPlatform()
}
java {
toolchain {
languageVersion = JavaLanguageVersion.of(21)
}
}
application {
mainClass = "org.example.S3BucketService"
}
```
#### settings.gradle.kts
```
plugins {
id("org.gradle.toolchains.foojay-resolver-convention") version "0.10.0"
}
rootProject.name = "mockK-static"
dependencyResolutionManagement {
repositories {
mavenCentral()
}
versionCatalogs {
create("awssdk") {
from("aws.sdk.kotlin:version-catalog:1.4.69")
}
}
}
```