GraphQL — τι είναι, γλώσσα ερωτημάτων και εφαρμογή σε κινητά έργα

Τι είναι το GraphQL;

GraphQL — είναι μια προδιαγραφή και ένα περιβάλλον εκτέλεσης για API που δίνει στον πελάτη πλήρη έλεγχο επί των λαμβανόμενων δεδομένων. Αναπτύχθηκε από μηχανικούς του Facebook για την επίλυση προβλημάτων της κινητής εφαρμογής News Feed, και η προδιαγραφή δημοσιεύθηκε ως ανοικτό πρότυπο το 2015. Από το 2018, το GraphQL τελεί υπό τη διαχείριση του GraphQL Foundation με την υποστήριξη του Linux Foundation και εταιρειών όπως οι Apollo, AWS, GitHub, SAP και άλλες.

Σε αντίθεση με το REST, όπου κάθε endpoint επιστρέφει μια σταθερή δομή δεδομένων, το GraphQL χρησιμοποιεί ένα ενιαίο endpoint που δέχεται μια συμβολοσειρά ερωτήματος. Ο πελάτης περιγράφει στο ερώτημα ποια πεδία χρειάζεται και ο διακομιστής επιστρέφει ακριβώς αυτά. Για παράδειγμα, το ερώτημα { user(id: “1”) { name email } } θα επιστρέψει μόνο το name και το email του χρήστη, χωρίς περιττά πεδία όπως address, phone ή createdAt που θα έπρεπε να ληφθούν στο REST.

Το GraphQL δεν είναι δεσμευμένο σε κάποια συγκεκριμένη βάση δεδομένων ή γλώσσα. Η προδιαγραφή καθορίζει μόνο τη μορφή των ερωτημάτων και των απαντήσεων. Υπάρχουν υλοποιήσεις διακομιστή σε Node.js (graphql-js, Apollo Server), Kotlin (graphql-kotlin, Netflix DGS Framework), Python (Graphene, Strawberry), Ruby (graphql-ruby) και άλλες γλώσσες. Οι βιβλιοθήκες πελάτη είναι διαθέσιμες για όλες τις κύριες πλατφόρμες, συμπεριλαμβανομένου του Apollo Client για iOS, Android και τον ιστό.

Πώς λειτουργεί το GraphQL

Η αρχιτεκτονική του GraphQL αποτελείται από τρία βασικά συστατικά: το σχήμα (Schema), τους επιλυτές (Resolvers) και τη μηχανή εκτέλεσης (GraphQL Engine). Το σχήμα καθορίζει ποιοι τύποι δεδομένων είναι διαθέσιμοι, ποια ερωτήματα μπορούν να εκτελεστούν και ποια ορίσματα δέχονται. Οι επιλυτές είναι συναρτήσεις στον διακομιστή που επιστρέφουν δεδομένα για κάθε πεδίο του σχήματος. Η μηχανή εκτέλεσης λαμβάνει το εισερχόμενο ερώτημα, το επικυρώνει βάσει του σχήματος, καλεί τους αντίστοιχους επιλυτές και συντάσσει την απάντηση.

Η διαδικασία επεξεργασίας ενός ερωτήματος έχει ως εξής:

• Ο πελάτης στέλνει ένα αίτημα POST στο /graphql με σώμα JSON { “query”: “...” }
• Ο διακομιστής αναλύει το ερώτημα, χτίζει ένα AST (Abstract Syntax Tree) και το επικυρώνει βάσει του σχήματος
• Η μηχανή διασχίζει το AST, καλώντας επιλυτές για κάθε πεδίο και συλλέγοντας δεδομένα
• Η απάντηση επιστρέφεται σε μορφή JSON, αντιστοιχώντας αυστηρά στη δομή του ερωτήματος

Το βασικό πλεονέκτημα της αρχιτεκτονικής GraphQL είναι η επίλυση σε επίπεδο πεδίου. Στο REST, ο προγραμματιστής είτε λαμβάνει όλα τα πεδία του πόρου (πιθανώς με περιττά), είτε καταφεύγει σε επεκτάσεις όπως ?fields=name,email. Στο GraphQL, τέτοιο φιλτράρισμα είναι ενσωματωμένο στη γλώσσα: κάθε ερώτημα καθορίζει ρητά ποια πεδία χρειάζονται και ο διακομιστής επιστρέφει ακριβώς αυτά. Αυτό είναι ιδιαίτερα σημαντικό για κινητές εφαρμογές, όπου ο όγκος των μεταδιδόμενων δεδομένων επηρεάζει άμεσα την ταχύτητα φόρτωσης και την κατανάλωση δεδομένων.

Query, Mutation και Subscription

Το GraphQL ορίζει τρεις τύπους λειτουργιών, καθένας από τους οποίους αντιστοιχεί σε ένα συγκεκριμένο σενάριο αλληλεπίδρασης. Query — για ανάγνωση δεδομένων, ανάλογο του GET στο REST. Mutation — για τροποποίηση δεδομένων (δημιουργία, ενημέρωση, διαγραφή), ανάλογο του POST/PUT/DELETE. Subscription — για ενημερώσεις σε πραγματικό χρόνο μέσω WebSocket, που δεν έχει άμεσο ανάλογο στο κλασικό REST (απαιτεί πρόσθετες λύσεις όπως WebSocket ή Server-Sent Events).

Η βασική σύνταξη των ερωτημάτων είναι διαισθητική:

// Απλό ερώτημα με όρισμα
query {
    user(id: "42") {
        name
        email
        avatarUrl
    }
}

// Mutation με επιστροφή τροποποιημένων δεδομένων
mutation {
    updateProfile(name: "Ιβάν") {
        id
        name
        updatedAt
    }
}

// Subscription — ακούει ενημερώσεις σε πραγματικό χρόνο
subscription {
    newMessage(chatId: "chat_1") {
        id
        text
        sender { name }
    }
}

Το Query εκτελείται παράλληλα — όλα τα πεδία στο ίδιο επίπεδο φορτώνονται ταυτόχρονα. Αυτό επιτρέπει τη φόρτωση συσχετισμένων δεδομένων (χρήστης και οι αναρτήσεις του) με ένα ερώτημα χωρίς πολλαπλά round-trips. Το Mutation εκτελείται σειριακά — οι μεταλλάξεις σε ένα ερώτημα εκτελούνται η μία μετά την άλλη με τη σειρά δήλωσης. Το Subscription δημιουργεί μια μόνιμη σύνδεση μέσω WebSocket, μέσω της οποίας ο διακομιστής στέλνει δεδομένα όταν συμβαίνει ένα συμβάν.

Οι λειτουργίες μπορούν να δέχονται μεταβλητές για τον διαχωρισμό δεδομένων από το ερώτημα, οδηγίες (@include, @skip) για υπό όρους συμπερίληψη πεδίων και τμήματα για επαναχρησιμοποίηση συνόλων πεδίων. Αυτές οι δυνατότητες καθιστούν τα ερωτήματα GraphQL ευέλικτα και επαναχρησιμοποιήσιμα, κάτι που είναι ιδιαίτερα σημαντικό σε μεγάλα έργα με πολλές οθόνες και εξαρτήματα.

Σχήμα και σύστημα τύπων GraphQL

Στην καρδιά του GraphQL βρίσκεται το σύστημα τύπων, που περιγράφει όλα τα πιθανά δεδομένα και λειτουργίες του API. Το σχήμα (Schema) είναι μια περιγραφή των τύπων που μπορεί να επιστρέψει ο διακομιστής και των ερωτημάτων που δέχεται. Το σχήμα γράφεται στη γλώσσα Schema Definition Language (SDL) και χρησιμεύει ως συμβόλαιο μεταξύ πελάτη και διακομιστή. Ο πελάτης μπορεί να λάβει το σχήμα μέσω ενδοσκόπησης — ένα ειδικό ερώτημα __schema που επιστρέφει μια πλήρη περιγραφή του API.

Παράδειγμα σχήματος για ένα ιστολόγιο:

// SDL — Schema Definition Language
type User {
    id: ID!
    name: String!
    email: String
    posts: [Post!]!
}

type Post {
    id: ID!
    title: String!
    content: String
    author: User!
}

type Query {
    user(id: ID!): User
    posts(page: Int): [Post!]!
}

Το θαυμαστικό (!) σημαίνει πεδίο non-null — θα είναι εγγυημένα παρόν στην απάντηση. Οι αγκύλες [ ] υποδηλώνουν λίστα. Το GraphQL υποστηρίζει βαθμωτούς τύπους (Int, Float, String, Boolean, ID), αντικειμενικούς τύπους, enum, union, interface και input-τύπους (για ορίσματα μεταλλάξεων). Η αυστηρή τυποποίηση αυτο-τεκμηριώνει το API και επιτρέπει στα εργαλεία πελάτη να παράγουν κώδικα: τύπους TypeScript, κλάσεις δεδομένων Kotlin, δομές Swift.

Ενδοσκόπηση — μια μοναδική δυνατότητα του GraphQL που απουσιάζει από το REST. Ο πελάτης μπορεί να στείλει ένα ερώτημα στο σχήμα και να λάβει μια πλήρη περιγραφή όλων των τύπων, πεδίων, ορισμάτων και οδηγιών. Αυτό αποτελεί τη βάση εργαλείων όπως το GraphiQL και το Apollo Studio, που παράγουν αυτόματα τεκμηρίωση και αυτόματη συμπλήρωση για προγραμματιστές. Η ενδοσκόπηση επιτρέπει επίσης τη σύνταξη αυτοματοποιημένων δοκιμών που ελέγχουν τη συμμόρφωση του σχήματος με την αναμενόμενη δομή.

Σύγκριση GraphQL με REST

Η επιλογή μεταξύ GraphQL και REST είναι ένα από τα βασικά αρχιτεκτονικά ερωτήματα κατά τον σχεδιασμό API. Και οι δύο προσεγγίσεις έχουν τα δυνατά και αδύνατα σημεία τους, και η επιλογή εξαρτάται από τις συγκεκριμένες απαιτήσεις του έργου. Το REST υπερέχει σε απλότητα και καθολικότητα, το GraphQL σε ευελιξία και αποδοτικότητα ερωτημάτων. Ας δούμε τον συγκριτικό πίνακα.

Το κύριο μειονέκτημα του GraphQL είναι η δυσκολία προσωρινής αποθήκευσης. Στο REST, η HTTP προσωρινή αποθήκευση λειτουργεί σε επίπεδο URL: ένα αίτημα στο /api/users/42 επιστρέφει πάντα την ίδια δομή και η απάντηση μπορεί να αποθηκευτεί προσωρινά βάσει URL. Στο GraphQL, όλα τα αιτήματα πηγαίνουν σε ένα endpoint, η δομή της απάντησης εξαρτάται από το σώμα του αιτήματος. Για την επίλυση αυτού του προβλήματος, το Apollo Client χρησιμοποιεί μια κανονικοποιημένη προσωρινή μνήμη από την πλευρά του πελάτη που διαχωρίζει τις απαντήσεις σε ξεχωριστές οντότητες βάσει id και τις ενημερώνει αυτόματα όταν λαμβάνει νέα δεδομένα.

Μια άλλη σημαντική πτυχή είναι το πρόβλημα N+1. Κατά την αίτηση ένθετων δεδομένων (για παράδειγμα, αναρτήσεις χρήστη και σχόλια σε κάθε ανάρτηση), το GraphQL μπορεί να εκτελέσει ξεχωριστό ερώτημα SQL για κάθε στοιχείο της λίστας. Αυτό επιλύεται με το DataLoader — ένα βοηθητικό πρόγραμμα για ομαδοποίηση και προσωρινή αποθήκευση ερωτημάτων βάσεων δεδομένων που ομαδοποιεί μεμονωμένα ερωτήματα σε ένα μαζικό ερώτημα. Στο REST, αυτό το πρόβλημα είναι λιγότερο έντονο, καθώς ο προγραμματιστής ελέγχει τη δομή της απάντησης στον διακομιστή.

Παραδείγματα ερωτημάτων GraphQL

Ας εξετάσουμε πρακτικά παραδείγματα χρήσης του GraphQL σε μια κινητή εφαρμογή σε Kotlin με Apollo Client. Τα παραδείγματα παρουσιάζουν τυπικά σενάρια: φόρτωση δεδομένων για την οθόνη προφίλ (query), δημιουργία νέας ανάρτησης (mutation) και εγγραφή σε νέα σχόλια (subscription). Κάθε παράδειγμα περιλαμβάνει τόσο το ερώτημα GraphQL όσο και τον κώδικα από την πλευρά του πελάτη.

Query: φόρτωση προφίλ με αναρτήσεις

Ένα ερώτημα GraphQL φορτώνει τον χρήστη, τις τελευταίες αναρτήσεις του και τον συνολικό αριθμό ακολούθων. Στο REST θα χρειάζονταν τουλάχιστον 2-3 αιτήματα: /users/42, /users/42/posts, /users/42/stats. Το GraphQL τα συνδυάζει σε ένα round-trip, μειώνοντας τον χρόνο φόρτωσης της οθόνης σε αργές συνδέσεις.

// Ερώτημα GraphQL (σε αρχείο .graphql)
query ProfileScreen($userId: ID!) {
    user(id: $userId) {
        name
        bio
        avatarUrl
        posts(limit: 10) {
            id
            title
            createdAt
        }
        followersCount
        followingCount
    }
}

// Κλήση από την πλευρά του πελάτη (Apollo Client + Kotlin)
val response = apolloClient
    .query(ProfileScreenQuery(userId = "42"))
    .execute()
binding.nameText.text = response.data?.user?.name

Mutation: δημιουργία νέας ανάρτησης

Η μετάλλαξη όχι μόνο δημιουργεί τον πόρο, αλλά επιστρέφει και τα τρέχοντα δεδομένα του για ενημέρωση του UI. Το πεδίο __typename χρησιμοποιείται από το Apollo Client για κανονικοποίηση της προσωρινής μνήμης — ο πελάτης ενημερώνει αυτόματα την εγγραφή Post στην προσωρινή μνήμη όταν λαμβάνει επιτυχή απάντηση μετάλλαξης.

// Μετάλλαξη GraphQL
mutation CreatePost($input: CreatePostInput!) {
    createPost(input: $input) {
        id
        title
        createdAt
        author {
            id
            name
        }
    }
}

// Κλήση μετάλλαξης με input-τύπο
val input = CreatePostInput(
    title = "Νέα ανάρτηση για το GraphQL",
    content = "Το GraphQL απλοποιεί την εργασία με API..."
)
val result = apolloClient
    .mutation(CreatePostMutation(input))
    .execute()

Ένα σημαντικό πλεονέκτημα του GraphQL έναντι του REST στο πλαίσιο της κινητής ανάπτυξης είναι η αυτόματη δημιουργία κώδικα. Το Apollo Client για Kotlin (Apollo GraphQL) δημιουργεί τύπο-ασφαλείς κλάσεις από αρχεία .graphql στο στάδιο της μεταγλώττισης. Εάν ο διακομιστής αλλάξει το σχήμα, το έργο δεν θα μεταγλωττιστεί έως ότου ενημερωθούν τα ερωτήματα. Αυτό αποτρέπει σφάλματα χρόνου εκτέλεσης, χαρακτηριστικά του REST, όπου μια αλλαγή στη δομή της απάντησης μπορεί να περάσει απαρατήρητη κατά την ανάπτυξη.

Οικοσύστημα: Apollo, Relay και εργαλεία

Το οικοσύστημα GraphQL περιλαμβάνει πολλές βασικές βιβλιοθήκες και εργαλεία που απλοποιούν την ανάπτυξη και λειτουργία. Apollo Client — η πιο δημοφιλής βιβλιοθήκη πελάτη, που υποστηρίζει React, iOS, Android και Kotlin Multiplatform. Relay από το Facebook — μια εναλλακτική λύση για εφαρμογές React με μοναδική προσέγγιση στη διαχείριση δεδομένων και προσωρινή αποθήκευση. Η επιλογή μεταξύ Apollo και Relay εξαρτάται από την πλατφόρμα και τις απαιτήσεις απόδοσης.

Στην πλευρά του διακομιστή ηγούνται τα Apollo Server (Node.js), Netflix DGS Framework (Kotlin/Java) και graphql-ruby. Για την ανάπτυξη σχήματος και δοκιμή ερωτημάτων χρησιμοποιείται το GraphiQL — ένα διαδραστικό IDE ενσωματωμένο στο πρόγραμμα περιήγησης. Το Apollo Studio παρέχει μετρήσεις απόδοσης, ανίχνευση ερωτημάτων και διαχείριση σχήματος για το περιβάλλον παραγωγής. Ξεχωριστά, αξίζει να αναφερθεί το GraphQL Code Generator — ένα εργαλείο που δημιουργεί τύπους TypeScript, Kotlin, Swift και Dart από σχήματα SDL.

Για την κινητή ανάπτυξη, ιδιαίτερο ενδιαφέρον παρουσιάζει το Apollo Kotlin (Apollo GraphQL) — μια βιβλιοθήκη πλήρως γραμμένη σε Kotlin με υποστήριξη για coroutine, Flow και Multiplatform. Επιτρέπει τη χρήση των ίδιων ερωτημάτων GraphQL για Android και iOS σε έργα Kotlin Multiplatform. Το Apollo Kotlin κανονικοποιεί την προσωρινή μνήμη, υποστηρίζει σφάλματα σε επίπεδο πεδίου (partial errors) και δημιουργεί αυτόματα μοντέλα δεδομένων από αρχεία .graphql. Αυτό καθιστά το GraphQL την προτιμώμενη επιλογή για μεγάλα κινητά έργα όπου η ταχύτητα ανάπτυξης και η ασφάλεια τύπων είναι σημαντικές.