Actix-web Rust: पूर्ण गाइड उदाहरणों के साथ

Actix-web क्या है और इसकी आवश्यकता क्यों है?

Actix-web Rust प्रोग्रामिंग भाषा के लिए एक शक्तिशाली, व्यावहारिक और अत्यंत तेज़ वेब फ्रेमवर्क है। यह एक्टर मॉडल (Actix लाइब्रेरी) और Tokio एसिंक्रोनस रनटाइम पर आधारित है। Actix-web आपको हाई-परफॉरमेंस वेब एप्लिकेशन और API बनाने की अनुमति देता है जो प्रति सेकंड लाखों रिक्वेस्ट को संभाल सकते हैं।

Actix-web का उपयोग क्यों करें?

• परफॉरमेंस: Actix-web दुनिया के तीन सबसे तेज़ वेब फ्रेमवर्क में से एक है (TechEmpower बेंचमार्क के अनुसार), जो Go net/http और Node.js Express जैसे सॉल्यूशंस से भी आगे है।
• सुरक्षा: Rust कंपाइल टाइम पर मेमोरी सेफ्टी की गारंटी देता है, जिससे बफर ओवरफ्लो और डेटा रेस जैसी कमजोरियां खत्म हो जाती हैं।
• टाइप सेफ्टी: Rust की सख्त टाइप सिस्टम की बदौलत, कई एरर (जैसे गलत JSON फॉर्मेट) कंपाइल टाइम पर ही पकड़ में आ जाती हैं।
• एसिंक्रोनस: async/await का पूरा सपोर्ट आपको हर कनेक्शन के लिए अलग थ्रेड बनाए बिना हजारों समवर्ती कनेक्शन को संभालने देता है।
• इकोसिस्टम: Actix-web अन्य Rust क्रेट्स के साथ आसानी से इंटीग्रेट होता है: serde (सीरियलाइज़ेशन), sqlx/diesel (डेटाबेस), reqwest (HTTP क्लाइंट)।

Actix-web इनके लिए आदर्श है: REST API, माइक्रोसर्विसेज़, WebSocket सर्वर, हाई-लोड वेब एप्लिकेशन, प्रॉक्सी सर्वर।

Actix-web की इंस्टॉलेशन

चूंकि Actix-web Rust की एक लाइब्रेरी है, इसलिए इसे cargo पैकेज मैनेजर (Python के pip जैसा) के माध्यम से इंस्टॉल किया जाता है।

चरण 1. सुनिश्चित करें कि आपके पास Rust इंस्टॉल है। कमांड से जांचें:

rustc --version
cargo --version

अगर Rust इंस्टॉल नहीं है, तो इसे rustup.rs से डाउनलोड करें।

चरण 2. एक नया प्रोजेक्ट बनाएं:

cargo new my_actix_app
cd my_actix_app

चरण 3. Actix-web को डिपेंडेंसी में जोड़ें। Cargo.toml फ़ाइल खोलें और यह जोड़ें:

[dependencies]
actix-web = "4"

चरण 4. डिपेंडेंसी इंस्टॉल करें और प्रोजेक्ट बिल्ड करें:

cargo build

हो गया! अब आप अपने प्रोजेक्ट में Actix-web का उपयोग कर सकते हैं।

त्वरित शुरुआत: Actix-web पर "Hello, World!"

चलिए एक बहुत ही सरल वेब सर्वर बनाते हैं जो GET रिक्वेस्ट पर रिस्पॉन्स देता है।

उदाहरण 1: न्यूनतम सर्वर

// main.rs
use actix_web::{get, App, HttpResponse, HttpServer, Responder};

#[get("/")]
async fn hello() -> impl Responder {
    HttpResponse::Ok().body("Hello, World!")
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    HttpServer::new(|| {
        App::new()
            .service(hello)
    })
    .bind(("127.0.0.1", 8080))?
    .run()
    .await
}

चलाएं: cargo run

जांचें: ब्राउज़र में http://127.0.0.1:8080 खोलें या यह कमांड चलाएं:

curl http://127.0.0.1:8080

आपको यह रिस्पॉन्स दिखेगा: Hello, World!

Actix-web के मुख्य मेथड और फंक्शन

आइए फ्रेमवर्क के प्रमुख एलिमेंट्स को समझते हैं। हर एक के लिए विवरण, पैरामीटर और काम का उदाहरण दिया गया है।

1. #[get("/path")] — GET रिक्वेस्ट हैंडल करने का मैक्रो

क्या करता है: एक एसिंक्रोनस फंक्शन को डेकोरेट करता है, जिससे वह निर्दिष्ट पथ पर HTTP GET रिक्वेस्ट का हैंडलर बन जाता है।

पैरामीटर: पथ (स्ट्रिंग), इसमें डायनामिक सेगमेंट हो सकते हैं (जैसे, /{id})।

उदाहरण:

use actix_web::{get, HttpResponse, Responder};

#[get("/user/{id}")]
async fn get_user(path: actix_web::web::Path<String>) -> impl Responder {
    let user_id = path.into_inner();
    HttpResponse::Ok().body(format!("User ID: {}", user_id))
}

2. #[po