Go (Golang) के लिए Gorilla WebSocket लाइब्रेरी: एक संपूर्ण गाइड

Gorilla WebSocket: Go पर रीयल-टाइम के लिए एक शक्तिशाली उपकरण

आधुनिक वेब डेवलपमेंट में, रीयल-टाइम डेटा आदान-प्रदान की आवश्यकता तेजी से महत्वपूर्ण होती जा रही है। चाहे वह चैट हों, ऑनलाइन गेम हों, सर्वर मॉनिटरिंग हो या स्टॉक कोट्स हों — WebSocket क्लाइंट और सर्वर के बीच द्वि-दिशात्मक संचार के लिए डी-फैक्टो मानक है। Go (Golang) भाषा के लिए, WebSocket के साथ काम करने के लिए सबसे लोकप्रिय और स्थिर लाइब्रेरी में से एक Gorilla WebSocket है।

gorilla/websocket लाइब्रेरी Gorilla Toolkit इकोसिस्टम का हिस्सा है — जो Go पर वेब डेवलपमेंट के लिए उच्च गुणवत्ता वाले पैकेजों का एक सेट है। यह WebSocket सर्वर और क्लाइंट बनाने के लिए सुविधाओं का एक पूरा सेट प्रदान करती है, सभी प्रमुख प्रोटोकॉल (RFC 6455) का समर्थन करती है, और उपयोग में सरलता के लिए जानी जाती है।

Gorilla WebSocket की मुख्य विशेषताएं

• WebSocket प्रोटोकॉल का पूर्ण समर्थन — टेक्स्ट और बाइनरी फ्रेम के साथ काम करना, संदेश विखंडन, कंट्रोल फ्रेम (ping/pong)।
• सुविधाजनक API — ReadMessage और WriteMessage फंक्शन के साथ न्यूनतम इंटरफ़ेस।
• TLS/SSL समर्थन — सुरक्षित WebSocket कनेक्शन (wss://)।
• लचीला कॉन्फ़िगरेशन — टाइमआउट, बफर आकार सेट करने, अनुरोधों की उत्पत्ति की जाँच करने की क्षमता।
• HTTP के साथ संगतता — किसी भी Go HTTP सर्वर (net/http) के साथ आसानी से एकीकृत होता है।
• कॉन्टेक्स्ट के साथ काम करना — संचालन रद्द करने के लिए context.Context का समर्थन।

लाइब्रेरी की स्थापना

Gorilla WebSocket स्थापित करने के लिए, टर्मिनल में निम्न कमांड चलाएँ:

go get github.com/gorilla/websocket

इसके बाद, अपनी Go फ़ाइल में इम्पोर्ट जोड़ें:

import "github.com/gorilla/websocket"

WebSocket सर्वर का मूल उदाहरण

आइए एक सरल इको सर्वर देखें जो WebSocket कनेक्शन स्वीकार करता है और प्राप्त संदेशों को वापस भेजता है।

package main

import (    "log"    "net/http"

    "github.com/gorilla/websocket")

var upgrader = websocket.Upgrader{    CheckOrigin: func(r *http.Request) bool {        return true // सभी स्रोतों की अनुमति दें (डेवलपमेंट के लिए)    },}

func echoHandler(w http.ResponseWriter, r *http.Request) {    conn, err := upgrader.Upgrade(w, r, nil)    if err != nil {        log.Print("Upgrade failed:", err)        return    }    defer conn.Close()

    for {        messageType, message, err := conn.ReadMessage()        if err != nil {            log.Println("Read error:", err)            break        }        log.Printf("Received: %s", message)

        if err := conn.WriteMessage(messageType, message); err != nil {            log.Println("Write error:", err)            break        }    }}

func main() {    http.HandleFunc("/echo", echoHandler)    log.Println("Server started on :8080")    log.Fatal(http.ListenAndServe(":8080", nil))}

कोड की विस्तृत व्याख्या

1. Upgrader — यह एक स्ट्रक्चर है जो सामान्य HTTP अनुरोध को WebSocket कनेक्शन में बदलता है। उदाहरण में हम किसी भी स्रोत से अनुरोधों की अनुमति देते हैं (फ़ील्ड CheckOrigin)। प्रोडक्शन में विशिष्ट डोमेन की जाँच करनी चाहिए।
2. Upgrade — मुख्य मेथड जो http.ResponseWriter और *http.Request लेता है और *websocket.Conn लौटाता है।
3. ReadMessage — एक ब्लॉकिंग कॉल जो क्लाइंट से नए संदेश की प्रतीक्षा करता है। यह संदेश का प्रकार (टेक्स्ट या बाइनरी डेटा) और डेटा स्वयं लौटाता है।
4. WriteMessage — क्लाइंट को वापस संदेश भेजता है। इस मामले में, हम वही लौटाते हैं जो हमें प्राप्त हुआ।

WebSocket क्लाइंट (Gorilla)

लाइब्रेरी क्लाइंट को भी अनुमति देती है