التضمين مقابل التجميع

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

لقد تعلمت أن التضمين (embedding) يرفع الحقول (fields) والدوال (methods) إلى الـ struct الخارجية. ولكن Go تدعم أيضاً التجميع (aggregation)، حيث تقوم بتضمين struct أخرى كحقل مسمى. إن فهم متى يجب استخدام كل نهج هو مفتاح التصميم الجيد.

مع الـ تضمين (embedding)، يمكنك حذف اسم الحقل، وتصبح أعضاء النوع الداخلي قابلة للوصول إليها مباشرة:

type Writer struct{}
func (w Writer) Write() string { return "writing" }

type Document struct {
    Writer  // embedding - no field name
}

d := Document{}
d.Write()  // direct access

باستخدام التجميع (aggregation)، تمنح الحقل اسماً صريحاً، مما يتطلب استخدام ذلك الاسم للوصول إلى النوع الداخلي:

type Document struct {
    writer Writer  // التجميع - حقل مسمى
}

d := Document{writer: Writer{}}
d.writer.Write()  // يجب استخدام اسم الحقل

الفرق الرئيسي هو العلاقة التي تعبر عنها. يشير التضمين (Embedding) إلى علاقة "is-a" (هو-يكون) حيث يكتسب النوع الخارجي هوية النوع الداخلي. بينما يشير التجميع (Aggregation) إلى علاقة "has-a" (يملك) حيث يحتوي النوع الخارجي ببساطة على النوع الداخلي.

استخدم التضمين (embedding) عندما تريد أن يحقق النوع الخارجي الواجهات (interfaces) التي ينفذها النوع الداخلي، أو عندما يجعل الوصول المباشر للأساليب (methods) واجهة برمجة التطبيقات (API) أكثر وضوحاً. استخدم التجميع (aggregation) عندما يكون النوع الداخلي تفصيلاً من تفاصيل التنفيذ التي لا ينبغي كشفها، أو عندما تريد تحكماً صريحاً في كيفية الوصول إلى النوع الداخلي.

التحدي

سهل

لنقم ببناء نظام لإنشاء التقارير يوضح متى يجب استخدام التضمين (embedding) مقابل التجميع (aggregation). ستقوم بإنشاء نظام حيث يجب أن تكون بعض المكونات قابلة للوصول إليها مباشرة (التضمين) بينما يجب أن تظل المكونات الأخرى تفاصيل تنفيذ داخلية (التجميع).

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

formatter.go: قم بإنشاء هيكل Formatter مع حقل Style (سلسلة نصية) وطريقة Format(text string) string التي تعيد النص ملفوفاً بالنمط، مثل [Style] text [/Style]. سيكون هذا مساعداً داخلياً لا ينبغي كشفه مباشرة.
report.go: قم بإنشاء هيكلين يتعاملان مع إنشاء التقارير بشكل مختلف:
- هيكل Metadata مع حقلي Author و Date—يمثل هذا معلومات عامة يجب أن تكون قابلة للوصول إليها مباشرة.
- هيكل Report مع حقل Title يقوم بـ تضمين Metadata (للوصول المباشر إلى المؤلف والتاريخ) ولكنه يستخدم التجميع لـ Formatter (كتفاصيل تنفيذ داخلية مع حقل مسمى formatter).
أضف طريقة Generate() string إلى Report تستخدم المنسق الداخلي لتنسيق العنوان وتتضمن البيانات الميتا (metadata).
main.go: اقرأ تفاصيل التقرير من المدخلات، وأنشئ Report يحتوي على كل من البيانات الميتا المضمنة والمنسق المجمع. وضح الفرق من خلال الوصول إلى المؤلف مباشرة من التقرير (من خلال التضمين) ثم إنشاء التقرير المنسق (الذي يستخدم المنسق المخفي داخلياً).

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

السطر 1: عنوان التقرير
السطر 2: اسم المؤلف
السطر 3: التاريخ
السطر 4: نمط المنسق

يجب أن تعيد طريقة Format الخاصة بك:

[Style] text [/Style]

يجب أن تعيد طريقة Generate الخاصة بك:

[formatted title]
Author: [Author], Date: [Date]

في ملفك الرئيسي، اطبع ثلاثة أسطر:

المؤلف الذي تم الوصول إليه مباشرة من Report (مما يوضح أن التضمين يرفع مستوى الحقل)
التاريخ الذي تم الوصول إليه من خلال اسم النوع المضمن (report.Metadata.Date)
نتيجة استدعاء Generate()

على سبيل المثال، إذا كانت المدخلات Quarterly Results، و Jane Doe، و 2024-01-15، و BOLD، يجب أن يكون مخرجك:

Jane Doe
2024-01-15
[BOLD] Quarterly Results [/BOLD]
Author: Jane Doe, Date: 2024-01-15

لاحظ كيف يمكن الوصول إلى Author و Date مباشرة من التقرير من خلال التضمين، بينما يظل المنسق مخفياً—لا يمكنك استدعاء report.Format() مباشرة لأنه مجمع مع حقل مسمى. يوضح هذا علاقة "is-a" مقابل "has-a" في الممارسة العملية.

ورقة مرجعية

تدعم لغة Go طريقتين لتضمين هيكل (struct) داخل آخر: التضمين (embedding) و التجميع (aggregation).

يتجاهل التضمين اسم الحقل، مما يؤدي إلى ترقية حقول وطرق النوع الداخلي إلى الهيكل الخارجي:

type Writer struct{}
func (w Writer) Write() string { return "writing" }

type Document struct {
    Writer  // تضمين - لا يوجد اسم حقل
}

d := Document{}
d.Write()  // وصول مباشر إلى الطريقة المضمنة

يستخدم التجميع اسم حقل صريح، مما يتطلب استخدام هذا الاسم للوصول إلى النوع الداخلي:

type Document struct {
    writer Writer  // تجميع - حقل مسمى
}

d := Document{writer: Writer{}}
d.writer.Write()  // يجب استخدام اسم الحقل

متى تستخدم كل منهما:

التضمين: يعبر عن علاقة "هو-يكون" (is-a). استخدمه عندما يجب أن يستوفي النوع الخارجي واجهات (interfaces) النوع الداخلي، أو عندما يحسن الوصول المباشر للطرق من واجهة برمجة التطبيقات (API).
التجميع: يعبر عن علاقة "لديه-أو-يملك" (has-a). استخدمه عندما يكون النوع الداخلي تفصيلاً برمجياً لا ينبغي كشفه، أو عندما تريد تحكماً صريحاً في الوصول.

مع التضمين، لا يزال بإمكانك الوصول إلى الحقول من خلال اسم النوع المضمن إذا لزم الأمر:

type Metadata struct {
    Author string
}

type Report struct {
    Metadata  // مضمن
}

r := Report{Metadata: Metadata{Author: "Jane"}}
r.Author              // وصول مباشر عبر الترقية
r.Metadata.Author     // وصول صريح عبر اسم النوع

جرّب بنفسك

package main

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

func main() {
	scanner := bufio.NewScanner(os.Stdin)
	
	scanner.Scan()
	title := scanner.Text()
	
	scanner.Scan()
	author := scanner.Text()
	
	scanner.Scan()
	date := scanner.Text()
	
	scanner.Scan()
	style := scanner.Text()
	
	// TODO: أنشئ struct باسم Metadata مع author و date
	
	// TODO: أنشئ Formatter بالـ style المعطى
	
	// TODO: أنشئ Report يدمج Metadata ويجمع Formatter
	
	// TODO: اطبع author الذي يتم الوصول إليه مباشرة من Report (الدمج يرفع مستوى الحقل)
	
	// TODO: اطبع date الذي يتم الوصول إليه من خلال اسم النوع المدمج (report.Metadata.Date)
	
	// TODO: اطبع نتيجة استدعاء Generate()
	
	// تعطيل تحذيرات المتغيرات غير المستخدمة (قم بإزالتها عند استخدام المتغيرات)
	_ = title
	_ = author
	_ = date
	_ = style
}