fx في Go: دليل شامل مع أمثلة تطبيقية

ما هي هذه المكتبة ولماذا تحتاجها؟

fx هي إطار عمل قوي لحقن التبعيات (Dependency Injection) للغة Go، تم تطويره بواسطة شركة Uber. يوفر طريقة أنيقة لإدارة التبعيات في تطبيقات Go، من خلال أتمتة إنشاء الكائنات وربطها وإدارة دورة حياتها.

في تطبيقات Go التقليدية، غالبًا ما يواجه المطورون مشكلة "جحيم المنشئات" (constructor hell)، حيث يتطلب إنشاء كائن واحد تمرير العديد من التبعيات. يؤدي هذا إلى:

• كود ضخم مع إدارة يدوية للتبعيات
• صعوبات في الاختبار
• مشاكل في تغيير بنية التطبيق

fx يحل هذه المشاكل من خلال توفير:

• حقن تلقائي للتبعيات — الإطار يحدد بنفسه الكائنات المطلوبة وترتيب إنشائها
• إدارة دورة الحياة — تشغيل وإيقاف المكونات تلقائيًا
• النمطية — تقسيم التطبيق إلى وحدات مستقلة
• قابلية الاختبار — سهولة استبدال التبعيات الحقيقية بكائنات وهمية (mock)

fx مفيد بشكل خاص عند تطوير:

• الخدمات المصغرة (Microservices)
• تطبيقات الويب
• أدوات سطر الأوامر (CLI)
• أي تطبيق ذو بنية تبعيات معقدة

التثبيت

يتم تثبيت fx بالطريقة القياسية لمكتبات Go عبر الأمر go get:

go get go.uber.org/fx

للتحديث إلى أحدث إصدار:

go get -u go.uber.org/fx

بعد التثبيت، قم باستيراد المكتبة في الكود الخاص بك:

import "go.uber.org/fx"

يوصى أيضًا بتثبيت أداة fx لتوليد الكود (اختياري):

go install go.uber.org/fx/cmd/fx@latest

بداية سريعة مع مثال كود

لنلقِ نظرة على مثال بسيط لاستخدام fx في إنشاء خادم HTTP:

package main

import (
    "context"
    "fmt"
    "net/http"
    "go.uber.org/fx"
)

// NewHandler تنشئ معالج HTTP
func NewHandler() http.Handler {
    mux := http.NewServeMux()
    mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "مرحبًا، fx!")
    })
    return mux
}

// NewServer تنشئ خادم HTTP
func NewServer(handler http.Handler) *http.Server {
    return &http.Server{
        Addr:    ":8080",
        Handler: handler,
    }
}

// StartServer تشغل الخادم
func StartServer(lc fx.Lifecycle, server *http.Server) {
    lc.Append(fx.Hook{
        OnStart: func(ctx context.Context) error {
            go server.ListenAndServe()
            fmt.Println("تم تشغيل الخادم على المنفذ :8080")
            return nil
        },
        OnStop: func(ctx context.Context) error {
            return server.Shutdown(ctx)
        },
    })
}

func main() {
    app := fx.New(
        fx.Provide(NewHandler),
        fx.Provide(NewServer),
        fx.Invoke(StartServer),
    )
    app.Run()
}

يوضح هذا المثال الآلية الأساسية لـ fx:

• fx.Provide — تسجيل المنشئات (constructors)
• fx.Invoke — تشغيل الدوال التي تستخدم التبعيات
• fx.Lifecycle — إدارة دورة حياة المكونات

الدوال/الطرق الأساسية

1. fx.New

الوظيفة: إنشاء تطبيق fx جديد يدير التبعيات. هذه هي نقطة الدخول الرئيسية للإطار.

المعلمات:

• options ...Option — دالة متغيرة تستقبل معلمة واحدة أو أكثر من نوع Option (fx.Provide, fx.Invoke, fx.Module، إلخ)

مثال كود عملي:

package main

import (
    "go.uber.org/fx"
)

type Config struct {
    Port int
}

func NewConfig() *Config {
    retur