trikot.graphql's Introduction

⚠️ Warning: this project as been moved

See the new trikot repository for releases starting from 3.0.0.

Trikot.graphql

Incubating

Multiplaform graphql query implementation.

Use Kotlinx.serialization to deserialize objects
No codegen for now

Sending a graphql request

1 - Create the models for your response

import kotlinx.serialization.Serializable

@Serializable
data class DataResponse<T>(val data: T)

@Serializable
data class FooResponse(val foo: Foo)

@Serializable
data class Foo(val __typename: String, val id: String)

2 - Create a graphql query

class FooQuery(fooId: String) :
    AbstractGraphqlQuery<DataResponse<FooResponse>>(DataResponse.serializer(FooResponse.serializer())) {

    override val variables: Map<String, Any>? =
        mutableMapOf<String, Any>("fooId" to fooId)

    override val query = """
    query(${'$'}fooId: String!) {
        foo(fooId: ${'$'}fooId) {
            id
            __typename
        }
    }
    """
}

3 - Execute your query

val query = GraphqlQueryPublisher(FooQuery("3"))
query.execute()
query.subscribe(cancellableManager) {
    print(it.data.foo.id) // 3
}

Using with Trikot.datasources

val myDataSource = GraphqlDataSource<DataResponse<FooResponse>>(GraphqlPublisherFactoryImpl())
val dataSourceState = myDataSource.read(GraphqlQueryDataSourceRequest(FooQuery("3"), "cachableId-3"))

Installation

Import dependencies

    api "com.mirego.trikot:graphql:$trikot_graphql_version"
    jvm "com.mirego.trikot:graphql-jvm:$trikot_graphql_version"
    js "com.mirego.trikot:graphql-js:$trikot_graphql_version"
    iosx64 "com.mirego.trikot:graphql-iosx64:$trikot_graphql_version"
    iosarm64 "com.mirego.trikot:graphql-iosarm64:$trikot_graphql_version"

trikot.graphql's People