واجهة http.Handler

جزء من قسم Object Oriented Programming في رحلة GO على Coddy — الدرس 77 من 107.

تعد واجهة http.Handler هي الأساس لبنية خادم الويب في لغة Go. فهي تحدد كيفية معالجة طلبات HTTP، وأي نوع يقوم بتنفيذ هذه الواجهة يمكنه خدمة طلبات الويب.

الواجهة بسيطة بشكل ملحوظ:

type Handler interface {
    ServeHTTP(ResponseWriter, *Request)
}

أي نوع يحتوي على طريقة ServeHTTP يمكنه معالجة طلبات HTTP. إليك معالج مخصص:

type GreetHandler struct {
    Greeting string
}

func (h GreetHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "%s, visitor!", h.Greeting)
}

يمكنك استخدام هذا المعالج مباشرة مع خادم:

handler := GreetHandler{Greeting: "Welcome"}
http.Handle("/greet", handler)

للحالات الأبسط، توفر لغة Go الـ http.HandlerFunc، وهو نوع يتيح لك تحويل وظيفة (function) عادية إلى معالج (handler):

func hello(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Hello!")
}

http.Handle("/hello", http.HandlerFunc(hello))

تتضح قوة هذه الواجهة عندما تدرك أن المعالجات (handlers) يمكنها تغليف معالجات أخرى. يتيح ذلك أنماط البرمجيات الوسيطة (middleware patterns) حيث يمكنك إضافة تسجيل البيانات (logging)، أو المصادقة (authentication)، أو غيرها من الاهتمامات الشاملة (cross-cutting concerns) دون تعديل منطق المعالج الأصلي.

التحدي

سهل

لنقم ببناء نظام معالج HTTP بسيط يحاكي كيفية معالجة طلبات الويب! نظرًا لأنه لا يمكننا تشغيل خادم HTTP فعلي في هذه البيئة، فستقوم بإنشاء معالجات (handlers) تنفذ واجهة http.Handler وتوضح كيفية معالجتها للطلبات من خلال العمل مع كائنات طلب/استجابة وهمية (mock objects).

ستقوم بتنظيم الكود الخاص بك عبر ملفين:

handlers.go: حدد معالجات HTTP المخصصة لك.
قم بإنشاء هيكل MockResponseWriter يلتقط ما سيتم كتابته في استجابة HTTP. يجب أن يخزن جسم الاستجابة كسلسلة نصية (string) وينفذ طريقة Write(data []byte) (int, error) التي تضيف البيانات إلى الجسم. أضف طريقة Body() string لاسترداد الاستجابة المتراكمة.

قم بإنشاء هيكل MockRequest مع حقول نصية Path و Method لمحاكاة طلب HTTP.

الآن قم بإنشاء هيكلين للمعالجات ينفذان نمط واجهة http.Handler (مع طريقة ServeHTTP تأخذ *MockResponseWriter و *MockRequest):
- WelcomeHandler مع حقل Message - يكتب الرسالة متبوعة بمسار الطلب.
- MethodHandler - يكتب استجابات مختلفة بناءً على طريقة الطلب: "Fetching data" لـ GET، و "Creating resource" لـ POST، و "Method not supported" لأي شيء آخر.
main.go: معالجة الطلبات من خلال المعالجات الخاصة بك.
اقرأ نوع المعالج (welcome أو method)، ثم اقرأ تفاصيل الطلب. بالنسبة لمعالج الترحيب (welcome handler)، اقرأ أيضًا رسالة الترحيب.

قم بإنشاء المعالج المناسب، وابنِ طلبًا وهميًا، واستدعِ ServeHTTP لمعالجته. اطبع جسم الاستجابة.

سيتم توفير المدخلات التالية:

السطر 1: نوع المعالج (welcome أو method)
السطر 2: مسار الطلب
السطر 3: طريقة الطلب
السطر 4 (فقط لـ welcome): رسالة الترحيب

على سبيل المثال، إذا كان المدخل:

welcome
/home
GET
Hello from

يجب أن يكون مخرجك:

Hello from /home

وإذا كان المدخل:

method
/api/users
POST

يجب أن يكون مخرجك:

Creating resource

وإذا كان المدخل:

method
/api/data
GET

يجب أن يكون مخرجك:

Fetching data

وإذا كان المدخل:

method
/api/items
DELETE

يجب أن يكون مخرجك:

Method not supported

يوضح هذا التحدي المفهوم الأساسي لواجهة http.Handler—أي نوع يحتوي على طريقة ServeHTTP يمكنه معالجة الطلبات. في التطبيقات الحقيقية، تأتي http.ResponseWriter و *http.Request من مكتبة Go القياسية، لكن نمط تنفيذ المعالجات يظل كما هو تمامًا.

ورقة مرجعية

واجهة http.Handler هي أساس بنية خادم الويب في لغة Go:

type Handler interface {
    ServeHTTP(ResponseWriter, *Request)
}

أي نوع يحتوي على طريقة ServeHTTP يمكنه معالجة طلبات HTTP:

type GreetHandler struct {
    Greeting string
}

func (h GreetHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "%s, visitor!", h.Greeting)
}

قم بتسجيل معالج (handler) مع الخادم:

handler := GreetHandler{Greeting: "Welcome"}
http.Handle("/greet", handler)

للحالات الأبسط، استخدم http.HandlerFunc لتحويل دالة إلى معالج:

func hello(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintf(w, "Hello!")
}

http.Handle("/hello", http.HandlerFunc(hello))

يمكن للمعالجات تغليف معالجات أخرى، مما يسمح بأنماط البرمجيات الوسيطة (middleware) للتسجيل (logging)، أو المصادقة (authentication)، أو غيرها من الاهتمامات المشتركة.

جرّب بنفسك

package main

import (
	"bufio"
	"fmt"
	"os"
)

func main() {
	scanner := bufio.NewScanner(os.Stdin)
	
	// قراءة نوع المعالج
	scanner.Scan()
	handlerType := scanner.Text()
	
	// قراءة مسار الطلب
	scanner.Scan()
	path := scanner.Text()
	
	// قراءة طريقة الطلب
	scanner.Scan()
	method := scanner.Text()
	
	// إنشاء طلب وهمي
	request := &MockRequest{
		Path:   path,
		Method: method,
	}
	
	// إنشاء كاتب استجابة وهمي
	response := &MockResponseWriter{}
	
	// TODO: بناءً على handlerType، قم بإنشاء المعالج المناسب
	// إذا كان handlerType هو "welcome"، اقرأ رسالة الترحيب وأنشئ WelcomeHandler
	// إذا كان handlerType هو "method"، أنشئ MethodHandler
	// استدعِ ServeHTTP على المعالج مع الاستجابة والطلب
	
	if handlerType == "welcome" {
		scanner.Scan()
		message := scanner.Text()
		// TODO: قم بإنشاء WelcomeHandler مع الرسالة واستدعِ ServeHTTP
		_ = message // قم بإزالة هذا السطر عند التنفيذ
	} else if handlerType == "method" {
		// TODO: قم بإنشاء MethodHandler واستدعِ ServeHTTP
	}
	
	// طباعة جسم الاستجابة
	fmt.Println(response.Body())
}