الواجهات الشائعة

الواجهات الشائعة — Common Interfaces

Go مبنية على واجهات صغيرة ومحددة. المكتبة القياسية مليئة بواجهات تُستخدم في كل مكان. فهم هذه الواجهات يجعلك تكتب كوداً أكثر احترافية ومتوافقاً مع النظام البيئي لـ Go.

واجهة fmt.Stringer

أي نوع يُنفّذ String() string يتحكم في كيفية طباعته:

main.go

package main

import "fmt"

// حساب بنكي — Bank account
type Account struct {
    Owner   string
    Balance float64
    Currency string
}

// تنفيذ Stringer — Implement Stringer
func (a Account) String() string {
    return fmt.Sprintf("💰 %s: %.2f %s", a.Owner, a.Balance, a.Currency)
}

// لون — Color
type Color struct {
    R, G, B uint8
}

func (c Color) String() string {
    return fmt.Sprintf("#%02X%02X%02X", c.R, c.G, c.B)
}

func main() {
    acc := Account{Owner: "أحمد", Balance: 5420.50, Currency: "ريال"}
    fmt.Println(acc)  // يستدعي String() تلقائياً

    red := Color{R: 255, G: 0, B: 0}
    fmt.Println("الأحمر:", red)

    gold := Color{R: 212, G: 168, B: 83}
    fmt.Println("الذهبي:", gold)
}

Output:

واجهة error

واجهة error هي أبسط واجهة في Go — أسلوب واحد فقط:

type error interface {
    Error() string
}

أي نوع يُنفّذ Error() string يُعتبر خطأ:

main.go

package main

import "fmt"

// خطأ مخصص — Custom error
type ValidationError struct {
    Field   string
    Message string
}

func (e *ValidationError) Error() string {
    return fmt.Sprintf("خطأ في %s: %s", e.Field, e.Message)
}

// خطأ مخصص آخر — Another custom error
type NotFoundError struct {
    ID   int
    Type string
}

func (e *NotFoundError) Error() string {
    return fmt.Sprintf("%s رقم %d غير موجود", e.Type, e.ID)
}

// دالة تتحقق من العمر — Validate age
func validateAge(age int) error {
    if age < 0 {
        return &ValidationError{Field: "العمر", Message: "لا يمكن أن يكون سالباً"}
    }
    if age > 150 {
        return &ValidationError{Field: "العمر", Message: "قيمة غير واقعية"}
    }
    return nil
}

func main() {
    err := validateAge(-5)
    if err != nil {
        fmt.Println(err)
    }

    err2 := validateAge(200)
    if err2 != nil {
        fmt.Println(err2)
    }

    notFound := &NotFoundError{ID: 42, Type: "المستخدم"}
    fmt.Println(notFound)
}

Output:

واجهة io.Reader

io.Reader هي ربما أهم واجهة في Go. أي شيء يمكن القراءة منه (ملف، اتصال شبكة، نص) يُحقق هذه الواجهة:

type Reader interface {
    Read(p []byte) (n int, err error)
}

main.go

package main

import (
    "fmt"
    "io"
    "strings"
)

func main() {
    // strings.NewReader يُنشئ Reader من نص
    // strings.NewReader creates a Reader from a string
    reader := strings.NewReader("السلام عليكم ورحمة الله وبركاته")

    // قراءة 10 بايتات في كل مرة — Read 10 bytes at a time
    buf := make([]byte, 10)
    for {
        n, err := reader.Read(buf)
        if n > 0 {
            fmt.Printf("قرأت %d بايت: %s\n", n, string(buf[:n]))
        }
        if err == io.EOF {
            fmt.Println("— انتهى —")
            break
        }
        if err != nil {
            fmt.Println("خطأ:", err)
            break
        }
    }
}

Output:

واجهة io.Writer

مكمّل io.Reader — أي شيء يمكن الكتابة إليه:

type Writer interface {
    Write(p []byte) (n int, err error)
}

main.go

package main

import (
    "fmt"
    "os"
    "strings"
)

// عدّاد الكلمات — Word counter (implements io.Writer)
type WordCounter struct {
    Count int
}

func (wc *WordCounter) Write(p []byte) (int, error) {
    words := strings.Fields(string(p))
    wc.Count += len(words)
    return len(p), nil
}

func main() {
    // os.Stdout يُحقق io.Writer
    // os.Stdout implements io.Writer
    fmt.Fprintln(os.Stdout, "هذا يُطبع مباشرة عبر io.Writer")

    // عدّاد كلمات مخصص — Custom word counter
    wc := &WordCounter{}
    fmt.Fprint(wc, "هذه جملة من خمس كلمات")
    fmt.Fprint(wc, "وهذه ثلاث كلمات")
    fmt.Printf("عدد الكلمات الكلي: %d\n", wc.Count)
}

Output:

واجهة sort.Interface

لترتيب أي مجموعة بيانات، نفّذ ثلاثة أساليب:

type Interface interface {
    Len() int
    Less(i, j int) bool
    Swap(i, j int)
}

main.go

package main

import (
    "fmt"
    "sort"
)

// طالب — Student
type Student struct {
    Name  string
    Grade float64
}

// قائمة الطلاب — Student list (implements sort.Interface)
type ByGrade []Student

func (s ByGrade) Len() int           { return len(s) }
func (s ByGrade) Less(i, j int) bool { return s[i].Grade > s[j].Grade } // ترتيب تنازلي — descending
func (s ByGrade) Swap(i, j int)      { s[i], s[j] = s[j], s[i] }

func main() {
    students := []Student{
        {Name: "أحمد", Grade: 85.5},
        {Name: "فاطمة", Grade: 92.3},
        {Name: "عمر", Grade: 78.0},
        {Name: "نورة", Grade: 95.1},
        {Name: "خالد", Grade: 88.7},
    }

    fmt.Println("قبل الترتيب:")
    for _, s := range students {
        fmt.Printf("  %s: %.1f\n", s.Name, s.Grade)
    }

    sort.Sort(ByGrade(students))

    fmt.Println("\nبعد الترتيب (الأعلى أولاً):")
    for i, s := range students {
        fmt.Printf("  %d. %s: %.1f\n", i+1, s.Name, s.Grade)
    }
}

Output:

نصيحة: منذ Go 1.8 يمكنك استخدام sort.Slice كبديل أبسط بدون تنفيذ الواجهة الكاملة. لكن فهم sort.Interface مهم للواجهات بشكل عام.

نمط القبول بواجهة والإرجاع ببنية

من أشهر أنماط Go: دوالك يجب أن تقبل واجهات وتُرجع أنواعاً محددة:

// ✅ قبول واجهة — يعمل مع أي Reader
func ProcessData(r io.Reader) (*Result, error) { ... }

// ❌ قبول نوع محدد — يعمل فقط مع *os.File
func ProcessData(f *os.File) (*Result, error) { ... }

هذا النمط يجعل كودك أكثر مرونة وقابلية للاختبار.

تحدي — Challenge

package main

import (
    "fmt"
    "sort"
)

// لاعب — Player
type Player struct {
    Name  string
    Score int
}

// قائمة اللاعبين — Player list
type ByScore []Player

// نفّذ sort.Interface: Len و Less و Swap
// رتّب تنازلياً (الأعلى أولاً)
func (p ByScore) Len() int           { return 0 } // اكتب الكود هنا
func (p ByScore) Less(i, j int) bool { return false } // اكتب الكود هنا
func (p ByScore) Swap(i, j int)      {} // اكتب الكود هنا

func main() {
    players := []Player{
        {Name: "محمد", Score: 85},
        {Name: "سارة", Score: 93},
        {Name: "علي", Score: 97},
    }
    sort.Sort(ByScore(players))
    fmt.Println("النتائج مرتبة:")
    for i, p := range players {
        fmt.Printf("%d. %s: %d\n", i+1, p.Name, p.Score)
    }
}