GraphQL is a query language for APIs that allows you to specify the data you want from a server in a declarative way. Apollo GraphQL is a popular GraphQL client that generates Kotlin and Java models from GraphQL queries and executes them against a GraphQL server. In this blog post, I will show you how to set up Apollo GraphQL in your Android Kotlin project and how to use it to perform queries, mutations and subscriptions.
Setting up Apollo GraphQL
To use Apollo GraphQL in your Android Kotlin project, you need to add the following dependencies to your build.gradle.kts file:
plugins { id("com.apollographql.apollo3") version "3.8.1" } dependencies { implementation("com.apollographql.apollo3:apollo-runtime:3.8.1") }
You also need to set the package name for the generated models in your apollo block:
apollo { service("service") { packageName.set("com.example") } }
Apollo GraphQL supports three types of files:
- .graphqls schema files: describe the types in your backend using the GraphQL syntax.
- .json schema files: describe the types in your backend using the JSON syntax.
- .graphql executable files: describe your queries and operations in the GraphQL syntax.
By default, Apollo GraphQL requires a schema in your module’s src/main/graphql directory. You can download a schema using introspection with the ./gradlew downloadApolloSchema task.
Writing and executing queries
To write a query, you need to create a .graphql file in your src/main/graphql directory with the following syntax:
query GetPosts($limit: Int) { posts(limit: $limit) { id title author { name } } }
This query will fetch a list of posts with their id, title and author name, and accept a limit argument to limit the number of posts.
Apollo GraphQL will generate a Kotlin class for this query with the same name as the file (GetPostsQuery) and a data class for each type (Post, Author). You can use these classes to execute the query using an ApolloClient instance:
val apolloClient = ApolloClient.Builder() .serverUrl("https://example.com/graphql") .build() val query = GetPostsQuery(limit = 10) apolloClient.query(query).execute().let { response -> if (response.isSuccessfull) { // handle success val posts = response.data?.posts // do something with posts } else { // handle error val error = response.errors?.firstOrNull() // do something with error } }
The execute() method returns an ApolloResponse object that contains either data or errors. You can access the data as query-specific Kotlin types and handle any errors that may occur.
Writing and executing mutations
To write a mutation, you need to create a .graphql file in your src/main/graphql directory with the following syntax:
mutation CreatePost($title: String!, $authorId: ID!) { createPost(input: {title: $title, authorId: $authorId}) { id title author { name } } }
This mutation will create a new post with the given title and author id, and return the created post with its id, title and author name.
Apollo GraphQL will generate a Kotlin class for this mutation with the same name as the file (CreatePostMutation) and a data class for each type (Post, Author). You can use these classes to execute the mutation using an ApolloClient instance:
val apolloClient = ApolloClient.Builder() .serverUrl("https://example.com/graphql") .build() val mutation = CreatePostMutation(title = "Hello world", authorId = "1") apolloClient.mutate(mutation).execute().let { response -> if (response.isSuccessfull) { // handle success val post = response.data?.createPost // do something with post } else { // handle error val error = response.errors?.firstOrNull() // do something with error } }
The execute() method returns an ApolloResponse object that contains either data or errors. You can access the data as mutation-specific Kotlin types and handle any errors that may occur.
Writing and executing subscriptions
To write a subscription, you need to create a .graphql file in your src/main/graphql directory with the following syntax:
subscription OnPostCreated { postCreated { id title author { name } } }
This subscription will listen for new posts created on the server and return the new post with its id, title and author name.
Apollo GraphQL will generate a Kotlin class for this subscription with the same name as the file (OnPostCreatedSubscription) and a data class for each type (Post, Author). You can use these classes to execute the subscription using an ApolloClient instance:
val apolloClient = ApolloClient.Builder() .serverUrl("wss://example.com/graphql") .build() val subscription = OnPostCreatedSubscription() apolloClient.subscribe(subscription).execute().collect { response -> if (response.isSuccessfull) { // handle success val post = response.data?.postCreated // do something with post } else { // handle error val error = response.errors?.firstOrNull() // do something with error } }
The execute() method returns a Flow of ApolloResponse objects that emit data or errors. You can collect the data as subscription-specific Kotlin types and handle any errors that may occur.
Conclusion
In this blog post, I showed you how to use Apollo GraphQL in your Android Kotlin project and how to perform queries, mutations and subscriptions. Apollo GraphQL is a powerful and type-safe GraphQL client that makes it easy to work with GraphQL APIs. You can learn more about Apollo GraphQL from their official documentation12 or their GitHub repository3. I hope you enjoyed this blog post and found it useful. Happy coding! 🚀
How did I do? 😊
Amazon Fire 10 HD Kids tablet (newest model) ages 3-7 | Bright 10.1" HD screen with included ad-free and exclusive content, robust parental controls, 13-hr battery, 32 GB, Pink
$109.99 (as of December 22, 2024 12:06 GMT -05:00 - More infoProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)
Amazon Fire HD 10 tablet (newest model) built for relaxation, 10.1" vibrant Full HD screen, octa-core processor, 3 GB RAM, 64 GB, Black
$67.49 (as of December 22, 2024 12:06 GMT -05:00 - More infoProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)
NSPENCM 85W Mac Book Pro Charger, Replacement AC 85w 2T-Tip Connector Power Adapter,Laptop Charger Compatible with MacBook pro & Mac Book Pro 13 inch-15 inch Retina After Mid 2012
$19.99 (as of December 22, 2024 12:06 GMT -05:00 - More infoProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)
New Amazon Fire HD 8 Kids Pro tablet, ages 6-12. Bright 8" HD screen, includes ad-free content, parental controls, 13-hr battery, slim case for older kids, 32GB, Jungle Cat, (2024 release)
$69.99 (as of December 22, 2024 12:06 GMT -05:00 - More infoProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)
Amazon Fire 7 Kids tablet (newest model) ages 3-7. Top-selling 7" kids tablet on Amazon. Includes 6 months of ad-free and exclusive content, easy parental controls, 10-hr battery, 16 GB, Blue
$49.99 (as of December 22, 2024 12:06 GMT -05:00 - More infoProduct prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on [relevant Amazon Site(s), as applicable] at the time of purchase will apply to the purchase of this product.)
Author: John Rowan
I am a Senior Android Engineer and I love everything to do with computers. My specialty is Android programming but I actually love to code in any language specifically learning new things.Share this:
