模拟 GraphQL 响应

测试网络传输目前在 Apollo Kotlin 中使用实验性。如果您对它们有反馈，请通过GitHub 问题或Kotlin Slack 社区提出。

QueueTestNetworkTransport是一个高级测试 API，可用于指定您的 GraphQL响应，这些响应由您的 ApolloClient 实例返回。

将依赖项添加到项目的 build.gradle 文件中：

build.gradle[.kts]

1
dependencies {
2
  testImplementation("com.apollographql.apollo:apollo-testing-support:4.0.0")
3
}

通过将其传递到 ApolloClient 构建器来启用 QueueTestNetworkTransport：

1
val apolloClient = ApolloClient.Builder()
2
    .networkTransport(QueueTestNetworkTransport())
3
    .build()

然后，您可以使用 enqueueTestResponse 扩展函数来指定要返回的 GraphQL 响应：

1
val testQuery = GetHeroQuery("001")
2
val testData = GetHeroQuery.Data {
3
  hero = droidHero {
4
    name = "R2D2"
5
  }
6
}
7
apolloClient.enqueueTestResponse(testQuery, testData)
8

9
val actual = apolloClient.query(testQuery).execute().data!!
10
assertEquals(testData.hero.name, actual.hero.name)

您可以将一个ApolloResponse对象传递给enqueueTestResponse函数，或者作为快捷方式，您可以直接像上面那样传递一个Data对象。如果传递了Data对象，您还需要传递一个操作，因为底层数据结构需要在里面建立一个ApolloResponse的引用。

为了帮助创建模拟的响应数据，您可以使用数据构建器。

高级使用

QueueTestNetworkTransport按照它们被入队时的顺序返回响应。

在某些测试中，将响应映射到操作可能更方便。

为了实现这一点，请使用MapTestNetworkTransport，并调用registerTestResponse扩展函数：

1
val apolloClient = ApolloClient.Builder().networkTransport(MapTestNetworkTransport()).build()
2

3
apolloClient.registerTestResponse(query1, testData1)
4
apolloClient.registerTestResponse(query2, testData2)
5

6
val actual1 = apolloClient.query(query1).execute().data
7
val actual2 = apolloClient.query(query2).execute().data
8
// Execute query1 again, which is mapped to testData1
9
val actual3 = apolloClient.query(query1).execute().data
10

11
assertEquals(testData1, actual1)
12
assertEquals(testData2, actual2)
13
assertEquals(testData1, actual3)

如果需要对返回的响应有更多控制，您可以实现自己的NetworkTransport并将其传递给ApolloClient构建器：

1
private class CustomTestNetworkTransport : NetworkTransport {
2
  override fun <D : Operation.Data> execute(request: ApolloRequest<D>): Flow<ApolloResponse<D>> {
3
    return flowOf(
4
        ApolloResponse.Builder(
5
          /* Your custom logic here */
6
        ).build() as ApolloResponse<D>
7
    )
8
  }
9

10
override fun dispose() {}
11
}
12

13
apolloClient = ApolloClient.Builder()
14
    .networkTransport(CustomTestNetworkTransport())
15
    .build()

请注意，如果您使用自定义的NetworkTransport，则无法调用enqueueTestResponse()或registerTestResponse()，因为它们期望传输是QueueTestNetworkTransport或MapTestNetworkTransport。

模拟HTTP响应当前内容

数据构建器