أساسيات الـ Reflection

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

الانعكاس (Reflection) يسمح للبرنامج بفحص وتعديل بنيته الخاصة أثناء وقت التشغيل (runtime). توفر حزمة reflect في لغة Go هذه الإمكانية، مما يتيح لك فحص الأنواع، وقراءة حقول الـ struct، واستدعاء الدوال (methods) بشكل ديناميكي.

النوعان الأساسيان في الانعكاس (reflection) هما reflect.Type و reflect.Value. يمكنك الحصول عليهما باستخدام reflect.TypeOf() و reflect.ValueOf():

import "reflect"

type Person struct {
    Name string
    Age  int
}

p := Person{Name: "Alice", Age: 30}

t := reflect.TypeOf(p)
v := reflect.ValueOf(p)

fmt.Println(t.Name())       // Person
fmt.Println(t.Kind())       // struct
fmt.Println(v.NumField())   // 2

يمكنك التكرار عبر حقول الـ struct لفحص أسمائها وأنواعها وقيمها:

for i := 0; i < t.NumField(); i++ {
    field := t.Field(i)
    value := v.Field(i)
    fmt.Printf("%s: %v\n", field.Name, value)
}
// المخرجات:
// Name: Alice
// Age: 30

يعد الانعكاس (Reflection) قوياً ولكنه يأتي مع مقايضات: فهو يتجاوز التحقق من النوع في وقت التجميع (compile-time type checking)، ويعمل بشكل أبطأ من الوصول المباشر، ويجعل الكود أصعب في الفهم. استخدمه باعتدال لمهام مثل JSON marshaling، أو ORM mapping، أو بناء أدوات عامة حيث لا يكون النوع معروفاً في وقت التجميع (compile time).

التحدي

سهل

لنقم ببناء فاحص للهياكل (struct inspector) يستخدم الانعكاس (reflection) لفحص أي هيكل والإبلاغ عن بنيته! هذه حالة استخدام عملية للانعكاس — إنشاء أدوات مساعدة تعمل مع أنواع غير معروفة في وقت التجميع (compile time).

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

inspector.go: أنشئ أداة الفحص القائمة على الانعكاس.
قم ببناء دالة InspectStruct(v any) string تستخدم حزمة reflect لفحص أي هيكل يتم تمريره إليها. يجب أن تعيد الدالة تقريراً منسقاً يحتوي على:
- اسم نوع الهيكل (struct's type name)
- نوع الهيكل (kind) (يجب أن يكون "struct")
- عدد الحقول
- لكل حقل: اسم الحقل، نوعه، وقيمته الحالية
يجب أن يكون تنسيق المخرجات كالتالي:
```
Type: [TypeName]
Kind: struct
Fields: [count]
- [FieldName] ([FieldType]): [Value]
- [FieldName] ([FieldType]): [Value]
...
```
استخدم reflect.TypeOf() للحصول على معلومات النوع و reflect.ValueOf() للوصول إلى قيم الحقول. قم بالمرور عبر الحقول باستخدام NumField() و Field(i) على النوع للحصول على البيانات الوصفية (metadata)، و Field(i) على القيمة للحصول على القيم الفعلية.
main.go: قم بتعريف هياكل عينة واستخدم الفاحص الخاص بك.
اقرأ نوع الهيكل (product أو employee) وقيم حقوله، ثم أنشئ الهيكل المناسب وافحصه.

بالنسبة لـ product: أنشئ هيكل Product مع حقول Name (string)، و Price (float64)، و InStock (bool). اقرأ الاسم، والسعر، وحالة التوفر في المخزون.

بالنسبة لـ employee: أنشئ هيكل Employee مع حقول ID (int)، و Name (string)، و Department (string). اقرأ المعرف (ID)، والاسم، والقسم.

قم بتمرير الهيكل الذي تم إنشاؤه إلى InspectStruct واطبع النتيجة.

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

السطر 1: نوع الهيكل (product أو employee)
الأسطر التالية: قيم الحقول لنوع الهيكل هذا

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

product
Laptop
999.99
true

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

Type: Product
Kind: struct
Fields: 3
- Name (string): Laptop
- Price (float64): 999.99
- InStock (bool): true

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

employee
42
Alice Johnson
Engineering

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

Type: Employee
Kind: struct
Fields: 3
- ID (int): 42
- Name (string): Alice Johnson
- Department (string): Engineering

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

product
Headphones
79.50
false

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

Type: Product
Kind: struct
Fields: 3
- Name (string): Headphones
- Price (float64): 79.5
- InStock (bool): false

لاحظ كيف يعمل الفاحص الخاص بك مع أنواع هياكل مختلفة دون معرفة بنيتها مسبقاً — هذه هي قوة الانعكاس! نفس الدالة InspectStruct تتعامل مع كل من هياكل Product و Employee ديناميكياً.

ورقة مرجعية

تتيح حزمة reflect للبرامج فحص ومعالجة هيكلها الخاص في وقت التشغيل (runtime).

النوعان الأساسيان هما reflect.Type و reflect.Value، ويتم الحصول عليهما باستخدام reflect.TypeOf() و reflect.ValueOf():

import "reflect"

type Person struct {
    Name string
    Age  int
}

p := Person{Name: "Alice", Age: 30}

t := reflect.TypeOf(p)
v := reflect.ValueOf(p)

fmt.Println(t.Name())       // Person
fmt.Println(t.Kind())       // struct
fmt.Println(v.NumField())   // 2

قم بالتكرار عبر حقول الهيكل (struct) لفحص أسمائها وأنواعها وقيمها:

for i := 0; i < t.NumField(); i++ {
    field := t.Field(i)
    value := v.Field(i)
    fmt.Printf("%s: %v\n", field.Name, value)
}
// Output:
// Name: Alice
// Age: 30

يتجاوز الانعكاس (Reflection) فحص النوع في وقت التجميع (compile-time)، ويعمل بشكل أبطأ من الوصول المباشر، ويجعل فهم الكود أكثر صعوبة. استخدمه لمهام مثل ترميز JSON (JSON marshaling)، أو خرائط ORM، أو بناء أدوات عامة حيث لا يكون النوع معروفاً في وقت التجميع.

جرّب بنفسك

package main

import (
	"bufio"
	"fmt"
	"os"
	"strconv"
	"strings"
)

// هيكل Product مع حقول Name و Price و InStock
type Product struct {
	Name    string
	Price   float64
	InStock bool
}

// هيكل Employee مع حقول ID و Name و Department
type Employee struct {
	ID         int
	Name       string
	Department string
}

func main() {
	reader := bufio.NewReader(os.Stdin)

	// قراءة نوع الـ struct
	structType, _ := reader.ReadString('\n')
	structType = strings.TrimSpace(structType)

	if structType == "product" {
		// قراءة حقول المنتج
		name, _ := reader.ReadString('\n')
		name = strings.TrimSpace(name)

		priceStr, _ := reader.ReadString('\n')
		priceStr = strings.TrimSpace(priceStr)
		price, _ := strconv.ParseFloat(priceStr, 64)

		inStockStr, _ := reader.ReadString('\n')
		inStockStr = strings.TrimSpace(inStockStr)
		inStock, _ := strconv.ParseBool(inStockStr)

		// TODO: إنشاء هيكل Product بالقيم المقروءة
		// TODO: استدعاء InspectStruct مع المنتج وطباعة النتيجة

	} else if structType == "employee" {
		// قراءة حقول الموظف
		idStr, _ := reader.ReadString('\n')
		idStr = strings.TrimSpace(idStr)
		id, _ := strconv.Atoi(idStr)

		name, _ := reader.ReadString('\n')
		name = strings.TrimSpace(name)

		department, _ := reader.ReadString('\n')
		department = strings.TrimSpace(department)

		// TODO: إنشاء هيكل Employee بالقيم المقروءة
		// TODO: استدعاء InspectStruct مع الموظف وطباعة النتيجة

	}
}