أساسيات تضمين الـ Struct

جزء من قسم البرمجة كائنية التوجه في رحلة GO على Coddy. الدرس 35 من 107.

تضمين Struct هو آلية Go لإدراج نوع Struct داخل نوع آخر. بدلًا من استخدام اسم field، تحدد النوع ببساطة، وتروّج Go للـ fields الموجودة في Struct المضمَّن إلى Struct الخارجي.

إليك الصياغة الأساسية:

type Address struct {
    City    string
    Country string
}

type Person struct {
    Name string
    Address  // مضمّن - بدون اسم حقل
}

عند تضمين Address في Person، يمكنك الوصول إلى الحقول embedded مباشرةً على البنية الخارجية:

func main() {
    p := Person{
        Name: "Alice",
        Address: Address{
            City:    "London",
            Country: "UK",
        },
    }
    
    fmt.Println(p.City)     // London - وصول مباشر
    fmt.Println(p.Country)  // UK - وصول مباشر
    fmt.Println(p.Address.City)  // يعمل أيضاً
}

لاحظ كيف تعمل p.City دون كتابة p.Address.City صراحةً. تعمل Go تلقائيًا على ترقية fields الخاصة بالبنية embedded، مما يجعلها قابلة للوصول كما لو كانت تنتمي إلى البنية الخارجية. ولا يزال بإمكانك access إليها من خلال اسم النوع embedded عند الحاجة.

يختلف هذا عن الهياكل المتداخلة العادية، حيث يجب عليك دائمًا استخدام اسم field للوصول إلى fields الداخلية. ينشئ التضمين API أكثر تسطحًا وملاءمة، مع الحفاظ في الوقت نفسه على التجميع المنطقي للبيانات ذات الصلة.

التحدي

سهل

لنَبْنِ نظامًا لتسجيل المركبات يستخدم تضمين البُنى لإنشاء نموذج بيانات نظيف ومنظّم. ستفصل information الخاصة بجهة الاتصال عن details المركبة، مع السماح بالوصول المباشر إلى جميع fields من خلال التضمين.

ستنظّم كودك عبر ملفين:

vehicle.go: أنشئ بُنيتين تعملان معًا من خلال التضمين:
- بنية ContactInfo تحتوي على حقلي OwnerName وPhone (وكلاهما من نوع string)
- بنية Vehicle تُضمّن ContactInfo (من دون اسم field) وتضيف fields الخاصة بها: Make وModel وYear
أنشئ أيضًا method باسم Summary على Vehicle تُرجع formatted string تحتوي على جميع information الخاصة بالمركبة وجهة الاتصال.
main.go: اقرأ details المركبة والمالك من input، وأنشئ instance من Vehicle مع ContactInfo مضمّنة، وأظهر الوصول إلى fields المضمّنة مباشرةً ومن خلال اسم النوع المضمّن. اطبع ملخص المركبة في النهاية.

سيتم توفير inputs التالية:

السطر 1: اسم المالك
السطر 2: رقم الهاتف
السطر 3: Make المركبة
السطر 4: Model المركبة
السطر 5: السنة (عدد صحيح)

يجب أن تُرجع method Summary string بالتنسيق التالي:

[Year] [Make] [Model] - Owner: [OwnerName], Phone: [Phone]

في ملفك الرئيسي، أظهر ترقية field من خلال طباعة:

اسم المالك الذي تم الوصول إليه مباشرةً على Vehicle (مثلًا: v.OwnerName)
رقم الهاتف الذي تم الوصول إليه من خلال النوع المضمّن (مثلًا: v.ContactInfo.Phone)
الملخص الكامل من method Summary الخاصة بك

على سبيل المثال، عند إعطاء Alice Smith و555-1234 وToyota وCamry و2023، يجب أن يكون output كما يلي:

Alice Smith
555-1234
2023 Toyota Camry - Owner: Alice Smith, Phone: 555-1234

لاحظ كيف يعمل نمطا access كلاهما: direct access من خلال ترقية field، وaccess صريح من خلال اسم النوع المضمّن، مما يمنحك مرونة في طريقة تعاملك مع البيانات المضمّنة.

جرّب بنفسك

package main

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

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

	// اقرأ اسم المالك
	ownerName, _ := reader.ReadString('\n')
	ownerName = strings.TrimSpace(ownerName)

	// اقرأ رقم الهاتف
	phone, _ := reader.ReadString('\n')
	phone = strings.TrimSpace(phone)

	// اقرأ ماركة المركبة
	make, _ := reader.ReadString('\n')
	make = strings.TrimSpace(make)

	// اقرأ طراز المركبة
	model, _ := reader.ReadString('\n')
	model = strings.TrimSpace(model)

	// اقرأ السنة
	yearStr, _ := reader.ReadString('\n')
	yearStr = strings.TrimSpace(yearStr)
	year, _ := strconv.Atoi(yearStr)

	// TODO: أنشئ مثيلاً من Vehicle مع ContactInfo مضمّن
	// استخدم القيم المقروءة من الإدخال أعلاه

	// TODO: اطبع اسم المالك الذي يتم الوصول إليه مباشرة على Vehicle (ترقية الحقل)
	// مثال: fmt.Println(v.OwnerName)

	// TODO: اطبع الهاتف الذي يتم الوصول إليه عبر اسم النوع المضمّن
	// مثال: fmt.Println(v.ContactInfo.Phone)

	// TODO: اطبع الملخص الكامل باستخدام الدالة Summary
	// مثال: fmt.Println(v.Summary())

	// أزل هذه الأسطر بمجرد تنفيذ الحل
	_ = ownerName
	_ = phone
	_ = make
	_ = model
	_ = year
}