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 } } केवल उपयोगकर्ता का नाम और ईमेल लौटाएगी, बिना address, phone या createdAt जैसे अतिरिक्त फ़ील्ड के जो REST में प्राप्त करने होते।

GraphQL किसी विशिष्ट डेटाबेस या भाषा से बंधा नहीं है। स्पेसिफिकेशन केवल क्वेरी और प्रतिक्रिया प्रारूप को परिभाषित करता है। Node.js (graphql-js, Apollo Server), Kotlin (graphql-kotlin, Netflix DGS Framework), Python (Graphene, Strawberry), Ruby (graphql-ruby) और अन्य भाषाओं में सर्वर कार्यान्वयन मौजूद हैं। क्लाइंट लाइब्रेरी सभी प्रमुख प्लेटफार्मों के लिए उपलब्ध हैं, जिसमें iOS, Android और वेब के लिए Apollo Client शामिल है।

GraphQL कैसे काम करता है

GraphQL आर्किटेक्चर में तीन मुख्य घटक होते हैं: स्कीमा (Schema), रिज़ॉल्वर (Resolvers) और GraphQL इंजन (GraphQL Engine)। स्कीमा परिभाषित करता है कि कौन से डेटा प्रकार उपलब्ध हैं, कौन सी क्वेरी निष्पादित की जा सकती हैं और वे कौन से आर्गुमेंट स्वीकार करते हैं। रिज़ॉल्वर सर्वर-साइड फ़ंक्शन हैं जो प्रत्येक स्कीमा फ़ील्ड के लिए डेटा लौटाते हैं। इंजन आने वाली क्वेरी प्राप्त करता है, स्कीमा के विरुद्ध इसकी वैधता की जांच करता है, उपयुक्त रिज़ॉल्वर को कॉल करता है और प्रतिक्रिया तैयार करता है।

क्वेरी प्रोसेसिंग प्रवाह इस प्रकार है:

• क्लाइंट JSON बॉडी { "query": "..." } के साथ /graphql पर POST अनुरोध भेजता है
• सर्वर क्वेरी को पार्स करता है, AST (Abstract Syntax Tree) बनाता है और स्कीमा के विरुद्ध इसकी वैधता की जांच करता है
• इंजन प्रत्येक फ़ील्ड के लिए रिज़ॉल्वर कॉल करते हुए AST को ट्रैवर्स करता है, डेटा एकत्र करता है
• प्रतिक्रिया JSON प्रारूप में लौटाई जाती है, जो क्वेरी संरचना से सख्ती से मेल खाती है

GraphQL आर्किटेक्चर का मुख्य लाभ फ़ील्ड-स्तरीय रिज़ॉल्यूशन है। REST में, डेवलपर को संसाधन के सभी फ़ील्ड मिलते हैं (संभवतः अतिरिक्त के साथ) या ?fields=name,email जैसे एक्सटेंशन का सहारा लेना पड़ता है। GraphQL में, ऐसी फ़िल्टरिंग भाषा में निर्मित है: प्रत्येक क्वेरी स्पष्ट रूप से निर्दिष्ट करती है कि कौन से फ़ील्ड चाहिए, और सर्वर ठीक वही लौटाता है। यह मोबाइल एप्लिकेशन के लिए विशेष रूप से महत्वपूर्ण है, जहां स्थानांतरित डेटा की मात्रा सीधे लोडिंग गति और डेटा उपयोग को प्रभावित करती है।

Query, Mutation और Subscription

GraphQL तीन प्रकार के ऑपरेशन को परिभाषित करता है, प्रत्येक एक विशिष्ट इंटरैक्शन परिदृश्य के अनुरूप है। Query — डेटा पढ़ने के लिए, REST में GET के समान। Mutation — डेटा बदलने के लिए (बनाना, अपडेट करना, हटाना), POST/PUT/DELETE के समान। Subscription — WebSocket के माध्यम से रीयल-टाइम अपडेट के लिए, जिसका क्लासिक REST में कोई सीधा समानांतर नहीं है (WebSocket या Server-Sent Events जैसे अतिरिक्त समाधान की आवश्यकता है)।

मूल क्वेरी सिंटैक्स सहज है:

// आर्गुमेंट के साथ सरल क्वेरी
query {
    user(id: "42") {
        name
        email
        avatarUrl
    }
}

// म्यूटेशन जो संशोधित डेटा लौटाता है
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 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 और इनपुट प्रकार (म्यूटेशन आर्गुमेंट के लिए) का समर्थन करता है। सख्त टाइपिंग 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 क्वेरी के उदाहरण

आइए Apollo Client के साथ Kotlin मोबाइल एप्लिकेशन में GraphQL के व्यावहारिक उदाहरण देखें। उदाहरण विशिष्ट परिदृश्य दर्शाते हैं: प्रोफ़ाइल स्क्रीन के लिए डेटा लोड करना (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()

मोबाइल डेवलपमेंट के संदर्भ में REST पर GraphQL का एक महत्वपूर्ण लाभ स्वचालित कोड जनरेशन है। Kotlin के लिए Apollo Client (Apollo GraphQL) बिल्ड समय पर .graphql फ़ाइलों से टाइप-सेफ क्लास उत्पन्न करता है। यदि सर्वर स्कीमा बदलता है, तो क्वेरी अपडेट होने तक प्रोजेक्ट बिल्ड नहीं होगा। यह REST में विशिष्ट रनटाइम त्रुटियों को रोकता है, जहां प्रतिक्रिया संरचना में परिवर्तन डेवलपमेंट के दौरान ध्यान में नहीं आ सकता।

इकोसिस्टम: Apollo, Relay और उपकरण

GraphQL इकोसिस्टम में कई प्रमुख लाइब्रेरी और उपकरण शामिल हैं जो डेवलपमेंट और संचालन को सरल बनाते हैं। Apollo Client सबसे लोकप्रिय क्लाइंट लाइब्रेरी है, जो React, iOS, Android और Kotlin Multiplatform का समर्थन करती है। Facebook का Relay डेटा प्रबंधन और कैशिंग के अनूठे दृष्टिकोण के साथ React एप्लिकेशन के लिए एक विकल्प है। Apollo और Relay के बीच चुनाव प्लेटफॉर्म और प्रदर्शन आवश्यकताओं पर निर्भर करता है।

सर्वर साइड पर, अग्रणी हैं Apollo Server (Node.js), Netflix DGS Framework (Kotlin/Java) और graphql-ruby। स्कीमा डेवलपमेंट और क्वेरी परीक्षण के लिए GraphiQL का उपयोग किया जाता है — ब्राउज़र में निर्मित एक इंटरैक्टिव IDE। Apollo Studio प्रदर्शन मेट्रिक्स, क्वेरी ट्रेसिंग और प्रोडक्शन वातावरण के लिए स्कीमा प्रबंधन प्रदान करता है। अलग से उल्लेखनीय है GraphQL Code Generator — एक उपकरण जो SDL स्कीमा से TypeScript, Kotlin, Swift और Dart प्रकार उत्पन्न करता है।

मोबाइल डेवलपमेंट के लिए, Apollo Kotlin (Apollo GraphQL) विशेष रुचि रखता है — एक लाइब्रेरी जो पूरी तरह से Kotlin में लिखी गई है जिसमें कोरूटीन, Flow और Multiplatform का समर्थन है। यह Kotlin Multiplatform प्रोजेक्ट में Android और iOS के लिए एकीकृत GraphQL क्वेरी का उपयोग करने की अनुमति देती है। Apollo Kotlin कैश को सामान्यीकृत करता है, फ़ील्ड-स्तरीय त्रुटियों (आंशिक त्रुटियां) का समर्थन करता है और .graphql फ़ाइलों से स्वचालित रूप से डेटा मॉडल उत्पन्न करता है। यह GraphQL को बड़े मोबाइल प्रोजेक्ट के लिए पसंदीदा विकल्प बनाता है जहां डेवलपमेंट गति और टाइप सुरक्षा महत्वपूर्ण हैं।