如何使用GraphQL Client: Apollo Android
2021-02-23 23:31
1721 查看
如何使用GraphQL Client: Apollo Android
一个Android app, 如何使用GraphQL.
本文以最流行的Apollo Android为例来说明.
添加依赖
首先, 添加依赖:
https://www.apollographql.com/docs/android/essentials/get-started-kotlin/
注意在android block里这两个东东都要加上:
compileOptions { sourceCompatibility JavaVersion.VERSION_1_8 targetCompatibility JavaVersion.VERSION_1_8 } kotlinOptions { jvmTarget = '1.8' }
下载Schema
然后, 下载schema.
可以跑一个introspection query来获取.
Apollo的Gradle插件贴心地提供了这个功能, 用
downloadApolloSchema这个task就可以.
只需要提供server的endpoint和存储schema.json文件的位置:
./gradlew downloadApolloSchema \ --endpoint="https://your.domain/graphql/endpoint" \ --schema="src/main/graphql/com/example/schema.json"
如果是需要认证的endpoint:
./gradlew downloadApolloSchema \ --endpoint="https://your.domain/graphql/endpoint" \ --schema="app/src/main/graphql/com/example" \ --header="Authorization: Bearer $TOKEN"
这里我曾经有过一个疑问, 我这个TOKEN属于哪个用户的要紧吗? -> 不要紧.
注意: 此时用的Token只是为了获取schema, 实际请求的时候还是要带具体当时的token.
添加.graphql文件, build生成代码
找Playground测试, 比如GitHub ad8 GraphQL API可以用Explorer测试: https://developer.github.com/v4/explorer/
然后把这个
.graphql文件写在schema文件旁边.
比如:
CurrentUser.graphql中:
query CurrentUser { viewer { login avatarUrl name } }
Build, 生成代码.
生成代码在生成文件的路径.
比如
CurrentUser.graphql里面是一个query, 就生成了
CurrentUserQuery文件.
进行请求调用 (协程版本)
采用协程版本的代码, 在ViewModel的scope里面:
viewModelScope.launch { val response = try { apolloClient.query(CurrentUserQuery()).toDeferred().await() } catch (e: ApolloException) { // handle protocol errors return@launch } val viewer = response.data?.viewer if (viewer == null || response.hasErrors()) { // handle application errors return@launch } _user.postValue(viewer) println("Launch site: ${viewer.login}") }
其中
toDeferred()方法将结果转换为
Deferred<T>, 是
Job的一个子类,
await()方法返回协程的结果.
Apollo Client Android的协程支持
添加了这个依赖之后:
implementation("com.apollographql.apollo:apollo-coroutines-support:2.2.3")
会有一个辅助类, 里面目前是5个扩展方法:
- Converts an [ApolloCall] to an [Flow]
- Converts an [ApolloQueryWatcher] to an [Flow].
- Converts an [ApolloCall] to an [Deferred].
- Converts an [ApolloSubscriptionCall] to an [Flow].
- Converts an [ApolloPrefetch] to [Job].
认证请求
关于认证的请求:
https://www.apollographql.com/docs/android/tutorial/10-authenticate-your-queries/
同样也是加interceptor来解决:
return ApolloClient.builder() .serverUrl("https://api.github.com/graphql") .okHttpClient( OkHttpClient.Builder() .addInterceptor(authInterceptor) .build() ) .build()
其中authInterceptor和用Retrofit时候的一样.
class AuthInterceptor constructor(private val preferencesUtils: PreferencesUtils) : Interceptor { override fun intercept(chain: Interceptor.Chain): Response { val userToken = preferencesUtils.userToken val newBuilder = 56c chain.request().newBuilder() if (userToken != null && userToken.isNotEmpty()) { newBuilder.addHeader("Authorization", "token $userToken") } newBuilder.addHeader("Accept", "application/vnd.github.v3+json") val request = newBuilder.build() return chain.proceed(request) } }
参考
相关文章推荐
- Android 6.0取消httpclient后如何使用volley
- Android 如何使用juv-rtmp-client.jar向Red5服务器发布实时视频数据
- Android 如何使用juv-rtmp-client.jar向Red5服务器发布实时视频数据
- CSDN Androidclient开展(两):基于如何详细解释Java使用Jsoup爬行动物HTML数据
- 使用react-apollo+graphql实现分页操作
- 使用react-apollo+graphql实现Mutation操作
- android视频开发之一Android 如何使用juv-rtmp-client.jar向Red5服务器发布实时视频数据
- 【Graphql实践】使用 Apollo(iOS) 访问 Github 的 Graphql API
- 如何高效率的使用DBUS作client/server架构
- Android下如何使用硬键盘快捷键。
- Android 小項目之--項目如何安裝至手機使用? (附詳細操作圖)
- 【Android游戏开发二十一】Android os设备谎言分辨率的解决方案!以及简单阐述游戏引擎如何使用!
- [016] 如何使用真机调试Android应用
- 使用WCF-Client如何调用服务端
- 如何使用Android SDK开发Android应用?
- 如何使用android手机拍照
- 如何使用HttpClient认证机制
- 如何使用ant编译Android开源voip代码sipdroid
- 如何使用android的ndk建立native的开发环境
- Android中如何使用命令行查看内嵌数据库sqlite3