GraphQL pour Kotlin : bibliothèques puissantes pour créer des API

Bibliothèques GraphQL pour Kotlin : aperçu complet et guide pratique

GraphQL est un langage de requête pour API qui permet aux clients de recevoir uniquement les données dont ils ont réellement besoin. Dans l'écosystème Kotlin, il existe plusieurs bibliothèques puissantes pour travailler avec GraphQL, tant côté serveur que côté client. Dans cet article, nous examinerons trois bibliothèques clés : graphql-kotlin, KGraphQL et Apollo Kotlin, et montrerons des exemples de leur utilisation.

1. graphql-kotlin — la bibliothèque officielle d'Expedia Group

graphql-kotlin est la bibliothèque la plus mature et la mieux maintenue pour créer des serveurs GraphQL en Kotlin. Elle utilise pleinement les fonctionnalités du langage, telles que les coroutines, les classes de données et la null-safety.

Fonctionnalités principales :

• Prise en charge des coroutines Kotlin pour le traitement asynchrone
• Génération automatique du schéma à partir des classes de données
• Prise en charge intégrée des abonnements (Subscriptions) via WebSocket
• Intégration avec Spring Boot, Ktor et d'autres frameworks
• Conformité totale avec la spécification GraphQL de juin 2018

Exemple de serveur avec graphql-kotlin :

// Définition du modèle de donnéesdata class User(val id: String, val name: String, val email: String)

// Création du resolver Queryclass UserQuery : Query {    fun getUser(id: String): User? {        // Logique de récupération de l'utilisateur        return User(id = "1", name = "Ivan Petrov", email = "ivan@example.com")    }        fun users(): List<User> = listOf(        User("1", "Ivan", "ivan@example.com"),        User("2", "Maria", "maria@example.com")    )}

// Configuration et démarrage du serveurfun main() {    val schema = Schema {        query(UserQuery())    }        val server = GraphQLServer(schema)    server.start(port = 8080)}

Exemple de requête client :

query {  user(id: "1") {    name    email  }}

2. KGraphQL — une alternative légère

KGraphQL est une bibliothèque minimaliste pour créer des API GraphQL. Elle se distingue par sa simplicité de configuration et l'absence de dépendances superflues.

Caractéristiques clés :

• Taille minimale — environ 100 Ko
• Ne nécessite pas Spring Boot ni d'autres frameworks lourds
• Prise en charge du DSL pour la définition du schéma
• Possibilité d'intégration avec n'importe quel serveur HTTP

Exemple d'utilisation de KGraphQL :

// Définition du modèledata class Product(val id: Int, val title: String, val price: Double)

// Création du schéma GraphQLval schema = schema {    query("products") {        resolver { ->             listOf(                Product(1, "Ordinateur portable", 89999.99),                Product(2, "Souris", 2499.50)            )        }    }        query("product") {        resolver { id: Int ->            Product(id, "Produit #$id", 1000.0)        }    }}

// Démarrage du serveurfun main() {    val server = KGraphQLServer(schema)    server.start(port = 4000)}

3. Apollo Kotlin — la bibliothèque cliente d'Apollo

Apollo Kotlin est un client puissant pour travailler avec des API GraphQL. Il génère un code typé sécurisé basé sur le schéma GraphQL, ce qui simplifie considérablement le développement.

Avantages d'Apollo Kotlin :

• Génération de code Kotlin à partir de fichiers .graphql
• Prise en charge de la mise en cache (cache normalisé)
• Fonctionne avec les coroutines et Flow
• Gestion automatique des erreurs
• Prise en charge des mutations, requêtes et abonnements

Exemple d'utilisation d'Apollo Kotlin côté client :

// D'abord, définissez la requête dans un fichier .graphql// file: GetUser.graphql// query GetUser($id: ID!) {//   user(id: $id) {//     id//     name//     email//   }