30 मिनट में Kotlin पर REST API कैसे लिखें: व्यवहार में

30 मिनट में Kotlin पर REST API कैसे लिखें: व्यवहार में

Kotlin एक आधुनिक प्रोग्रामिंग भाषा है जो बैकएंड डेवलपमेंट में तेजी से लोकप्रिय हो रही है। संक्षिप्त सिंटैक्स, Java के साथ पूर्ण संगतता और Ktor फ्रेमवर्क जैसे शक्तिशाली टूल के कारण, REST API बनाना एक तेज़ और सुखद प्रक्रिया बन जाती है। इस लेख में हम व्यवहार में दिखाएंगे कि कैसे सिर्फ आधे घंटे में Kotlin पर एक सरल लेकिन पूर्ण REST API लिखा जाए। आप सीखेंगे कि प्रोजेक्ट कैसे सेट करें, एंडपॉइंट कैसे बनाएं, JSON को प्रोसेस करें और सर्वर शुरू करें।

यह लेख उन डेवलपर्स के लिए है जो Kotlin की मूल बातों से परिचित हैं, लेकिन इसके लिए बैकएंड डेवलपमेंट के गहन ज्ञान की आवश्यकता नहीं है। सभी कोड विस्तृत स्पष्टीकरण के साथ होंगे।

1. प्रोजेक्ट सेटअप और निर्भरताएँ जोड़ना

शुरू करने के लिए हमें एक नया Kotlin प्रोजेक्ट बनाना होगा। हम Gradle का उपयोग करेंगे - Kotlin के लिए सबसे लोकप्रिय बिल्ड सिस्टम। यदि आप IntelliJ IDEA का उपयोग कर रहे हैं, तो "New Project" -> "Kotlin" -> "JVM | IDEA" चुनें। अन्यथा, मैन्युअल रूप से एक प्रोजेक्ट फ़ोल्डर बनाएं।

सबसे पहले build.gradle.kts फ़ाइल खोलें और Ktor और JSON सीरियलाइज़ेशन के लिए निम्नलिखित निर्भरताएँ जोड़ें:

plugins {    kotlin("jvm") version "1.9.22"    kotlin("plugin.serialization") version "1.9.22"    application}

repositories {    mavenCentral()}

dependencies {    implementation("io.ktor:ktor-server-core:2.3.7")    implementation("io.ktor:ktor-server-netty:2.3.7")    implementation("io.ktor:ktor-server-content-negotiation:2.3.7")    implementation("io.ktor:ktor-serialization-kotlinx-json:2.3.7")    implementation("ch.qos.logback:logback-classic:1.4.14")}

application {    mainClass.set("ApplicationKt")}

Gradle सिंक्रोनाइज़ेशन के बाद हम कोड लिखने के लिए तैयार हैं। ध्यान दें कि हम JSON के साथ काम करने के लिए kotlinx.serialization प्लगइन का उपयोग कर रहे हैं - यह Kotlin में मानक तरीका है।

2. डेटा मॉडल और मुख्य सर्वर फ़ाइल बनाना

REST API के लिए हमें एक डेटा मॉडल चाहिए। मान लीजिए यह एक सरल कार्य सूची (ToDo) है। Todo.kt फ़ाइल बनाएं:

import kotlinx.serialization.Serializable

@Serializabledata class Todo(    val id: Int,    val title: String,    val completed: Boolean = false)

अब मुख्य फ़ाइल Application.kt (या Main.kt) बनाएं। इसमें हम सर्वर कॉन्फ़िगर करेंगे और इसे शुरू करेंगे:

import io.ktor.server.engine.*import io.ktor.server.netty.*import io.ktor.server.application.*import io.ktor.server.routing.*import io.ktor.server.response.*import io.ktor.server.request.*import io.ktor.serialization.kotlinx.json.*import io.ktor.server.plugins.contentnegotiation.*

fun main() {    embeddedServer(Netty, port = 8080, host = "0.0.0.0") {        configureSerialization()        configureRouting()    }.start(wait = true)}

fun Application.configureSerialization() {    install(ContentNegotiation) {        json()    }}

fun Application.configureRouting() {    routing {        get("/") {            call.respondText("Hello, REST API on Kotlin!")        }    }}

यह कोड पोर्ट 8080 पर सर्वर शुरू करता है। हमने स्वचालित JSON सीरियलाइज़ेशन/डीसीरियलाइज़ेशन के लिए ContentNegotiation मॉड्यूल जोड़ा है। एप्लिकेशन चलाएं - आपको ब्राउज़र में http://localhost:8080 पर एक स्वागत संदेश दिखना चाहिए।

3. CRUD एंडपॉइंट का कार्यान्वयन (Create, Read, Update, Delete)

अब कार्यों को प्रबंधित करने के लिए पूर्ण REST रूट जोड़ते हैं। हम मेमोरी में डेटा संग्रहीत करने के लिए mutableListOf सूची का उपयोग करेंगे (वास्तविक प्रोजेक्ट में आप इसे डेटाबेस से बदल देंगे)।

TodoRepository.kt फ़ाइल बनाएं:

import kotlinx.coroutines.sync.Muteximport kotlinx.coroutines.sync.withLock

class TodoRepositor