ApolloStore

Apollo Kotlin公开了ApolloStore API，以编程方式从正常化的缓存中读取和写入。该ApolloStore构建在NormalizedCache之上，提供了一个线程安全的API，以及使读取和写入片段和操作更简单的

该存储可以通过ApolloClient.apolloStore扩展访问：

1
val apolloClient = ApolloClient.Builder()
2
  .serverUrl("https://...")
3
  .normalizedCache(MemoryCacheFactory(maxSizeBytes = 10 * 1024 * 1024))
4
  .build()
5

6
val apolloStore: ApolloStore = apolloClient.apolloStore

读取操作数据

就像一个普通的GraphQL查询一样，使用商店的主要方式是读取和写入查询：

给定以下query：

1
query GetBook($id: String!) {
2
  book(id: $id) {
3
    title
4
    author {
5
      name
6
    }
7
  }
8
}

您可以这样读取它

1
val data = apolloClient.apolloStore.readOperation(GetBookQuery(id = "42"), apolloClient.customScalarAdapters)
2

3
println("Title=${data.title}")
4
println("Author Name=${data.author.name}")

在缓存缺失的情况下，readOperation将抛出异常：

1
try {
2
  apolloClient.apolloStore.readOperation(GetBookQuery(id = "42"), apolloClient.customScalarAdapters)
3
} catch(e: CacheMissException) {
4
  println("CacheMiss on key: ${e.key}.${e.fieldName}")
5
}

如果您在运行时声明了标量适配器，将您的客户端customScalarAdapters传递给商店的方法，因为商店需要它们将标量值转换为Kotlin/Java类型。

写入操作数据

写入操作数据与读取相似：

1
apolloClient.apolloStore.writeOperation(GetBookQuery(id = "42"), data, apolloClient.customScalarAdapters)

请注意，您需要将数据传递给操作。

读取和写入片段

在GraphQL规范中，片段始终是更大操作的一部分，不能独立执行。

1
fragment BookDetails on Book {
2
  id
3
  title
4
  author {
5
    name
6
  }
7
}

Apollo Kotlin对此规则做出了例外，并允许读取/写入单独的片段。默认情况下，此功能是禁用的，可以启用generateFragmentImplementations：

1
apollo {
2
  service("service") {
3
    generateFragmentImplementations.set(true)
4
  }
5
}

由于片段没有根节点，您需要指定片段的根缓存标识符：

1
val data = apolloClient.apolloStore.readFragment(BookDetailsImpl(), CacheKey("42"), apolloClient.customScalarAdapters)
2

3
println("Title=${data.title}")
4
println("Author Name=${data.author.name}")

片段可以包含变量。不同变量不同的片段可以返回不同的数据。在这种情况下，Impl类将需要变量作为构造函数参数：

1
fragment BookDetails on Book {
2
  id
3
  title(locale: $locale)
4
}

1
val data = apolloClient.apolloStore.readFragment(BookDetailsImpl(locale = "en-US"), CacheKey("42"), apolloClient.customScalarAdapters)
2

3
println("Title=${data.title}")

清除缓存

调用apolloClient.apolloStore.clearAll()来清除所有条目的缓存。

监视缓存数据

HTTP缓存