الحقول المصدرة وغير المصدرة

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

في Go، يتم التحكم في التغليف على مستوى البنية من خلال حالة أحرف أسماء الحقول. تحدد هذه القاعدة البسيطة ما إذا كان يمكن الوصول إلى الحقول من خارج الحزمة التي تم تعريف البنية فيها.

Fields التي تبدأ بـحرف كبير هي exported: accessible من أي حزمة. Fields التي تبدأ بـlowercase هي غير مُصدَّرة: accessible فقط ضمن الحزمة نفسها:

// في الحزمة "user"
type User struct {
    Name     string  // مُصدَّر - يمكن الوصول إليه في كل مكان
    Email    string  // مُصدَّر - يمكن الوصول إليه في كل مكان
    password string  // غير مُصدَّر - يمكن الوصول إليه فقط في حزمة "user"
    age      int     // غير مُصدَّر - يمكن الوصول إليه فقط في حزمة "user"
}

عندما تستورد حزمة أخرى هذا الهيكل وتستخدمه، لا يمكنها التفاعل إلا مع الحقول Exported:

// في الحزمة "main"
import "user"

func main() {
    u := user.User{
        Name:  "Alice",      // يعمل
        Email: "a@mail.com", // يعمل
        // password: "secret", // خطأ في الترجمة: حقل غير معروف
    }
    
    fmt.Println(u.Name)     // يعمل
    // fmt.Println(u.password) // خطأ في الترجمة: لا يمكن الإشارة إلى حقل غير مُصدَّر
}

تحمي هذه الآلية البيانات الحساسة وتفاصيل التنفيذ الداخلية. لا يمكن قراءة password أو تعديل field ‏cannot مباشرةً من خارج الحزمة، مما يجبر الشيفرات الأخرى على استخدام الأساليب التي توفرها. هذا هو نهج Go لتحقيق إخفاء البيانات: مبدأ أساسي من مبادئ التغليف في البرمجة كائنية التوجه.

التحدي

سهل

لنَبْنِ نظامًا للحسابات المصرفية يوضّح التغليف من خلال الحقول Exported وunexported. ستنشئ حزمة تحمي البيانات المالية الحساسة، مع إتاحة المعلومات العامة الآمنة.

ستنظّم الشيفرة البرمجية عبر ملفين:

account.go: أنشئ بنية BankAccount في الحزمة main لنمذجة حساب مصرفي حقيقي مع حماية مناسبة للبيانات:
- HolderName (Exported) - اسم صاحب الحساب، وهو آمن للعرض علنًا
- AccountType (Exported) - نوع الحساب (مثل "Savings" و"Checking")
- balance (unexported) - الرصيد الفعلي، والذي ينبغي حمايته
- pin (unexported) - رمز PIN الخاص بالحساب، وهو بيانات شديدة الحساسية
أضف constructor function باسم NewBankAccount يأخذ اسم صاحب الحساب ونوع الحساب والرصيد initial ورمز PIN، ثم يعيد مؤشرًا إلى BankAccount جديدة. أضف أيضًا method باسم GetPublicInfo() string يعيد التنسيق التالي: Account: [HolderName] ([AccountType])
main.go: اقرأ تفاصيل الحساب من الإدخال، وأنشئ BankAccount باستخدام constructor، ثم اعرض التغليف. اطبع المعلومات العامة باستخدام method، ثم نفّذ accessed مباشرة واطبع كل field من الحقول Exported في أسطر منفصلة. الحقول unexported (balance وpin) محمية. لا يمكنك تعيينها إلا من خلال constructor.

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

السطر 1: اسم صاحب الحساب
السطر 2: نوع الحساب
السطر 3: الرصيد initial (على هيئة float)
السطر 4: رمز PIN

على سبيل المثال، عند إعطاء Alice Johnson وSavings و5000.50 و1234، ينبغي أن يكون الناتج كما يلي:

Account: Alice Johnson (Savings)
Holder: Alice Johnson
Type: Savings

لاحظ أن الرصيد ورمز PIN لا يظهران أبدًا في الناتج: إذ إنهما مخفيان بأمان داخل البنية، ولا يمكن الوصول إليهما إلا داخل الحزمة. هذا هو التغليف قيد التنفيذ: تتم حماية البيانات الحساسة، بينما تظل المعلومات العامة accessible.

جرّب بنفسك

package main

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

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

	// اقرأ اسم صاحب الحساب
	holderName, _ := reader.ReadString('\n')
	holderName = strings.TrimSpace(holderName)

	// اقرأ نوع الحساب
	accountType, _ := reader.ReadString('\n')
	accountType = strings.TrimSpace(accountType)

	// اقرأ الرصيد الأولي
	balanceStr, _ := reader.ReadString('\n')
	balanceStr = strings.TrimSpace(balanceStr)
	balance, _ := strconv.ParseFloat(balanceStr, 64)

	// اقرأ PIN
	pinStr, _ := reader.ReadString('\n')
	pin := strings.TrimSpace(pinStr)

	// TODO: أنشئ BankAccount جديد باستخدام المُنشئ
	// account := NewBankAccount(...)

	// TODO: اطبع المعلومات العامة باستخدام الدالة GetPublicInfo()

	// TODO: اطبع اسم صاحب الحساب بالوصول مباشرة إلى الحقل المُصدَّر
	// fmt.Println("Holder:", ...)

	// TODO: اطبع نوع الحساب بالوصول مباشرة إلى الحقل المُصدَّر
	// fmt.Println("Type:", ...)

	// Note: balance و pin غير مُصدَّرين - لا يمكن الوصول إليهما مباشرة هنا
	// إنها مُغلَّفة بأمان داخل الـ struct

	_ = balance // احذف هذا السطر عندما تستخدم balance
	_ = pin     // احذف هذا السطر عندما تستخدم pin
}