دوال الـ Getter والـ Setter

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

بما أن الحقول غير المُصدَّرة لا يمكن الوصول إليها مباشرةً من خارج package، فأنت بحاجة إلى توفير أساليب تسمح بالوصول المنضبط. وتُسمّى هذه الأساليب عادةً getters وsetters.

في Go، convention الخاص بـ getters بسيط: استخدم اسم field مع جعل الحرف الأول كبيرًا. لا تضع البادئة "Get"، بل استخدم Balance()، وليس GetBalance():

type BankAccount struct {
    balance int  // غير مُصدَّر
}

// Getter - يُرجع القيمة
func (b *BankAccount) Balance() int {
    return b.balance
}

// Setter - يُعدِّل القيمة مع التحقق
func (b *BankAccount) SetBalance(amount int) {
    if amount >= 0 {
        b.balance = amount
    }
}

تكمن القوة الحقيقية لدوال الضبط في إضافة التحقق أو منطق الأعمال. بدلاً من السماح للتعليمات البرمجية الخارجية بتعيين أي قيمة مباشرةً، يمكنك التحكم فيما هو مسموح به:

func (b *BankAccount) Deposit(amount int) bool {
    if amount <= 0 {
        return false
    }
    b.balance += amount
    return true
}

تعمل الطريقة Deposit هذه كمحدِّد متخصص يفرض القواعد: لا يُسمح بالإيداعات السالبة. يجب أن يمرّ الكود الخارجي عبر طرقك، مما يضمن بقاء البنية دائمًا في حالة صالحة. هذا هو التغليف أثناء العمل: إخفاء البيانات مع إتاحة سلوك مُتحكَّم فيه.

التحدي

سهل

لنبنِ محوّل درجات حرارة يوضّح التغليف السليم باستخدام طُرُق getter وsetter. ستُنشئ بنية تخزّن درجة الحرارة داخليًا بوحدة Celsius، لكنها توفّر وصولًا مضبوطًا من خلال طُرُق تتضمن التحقق.

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

temperature.go: Create بنية Temperature تحتوي على حقل celsius غير مُصدَّر (float64). Implement الطرائق التالية:
- Celsius() - getter يعيد درجة الحرارة الحالية بوحدة Celsius
- SetCelsius(value float64) - setter لا يقبل إلا القيم التي تساوي أو تتجاوز الصفر المطلق absolute (-273.15). إذا كانت القيمة أقل من هذا الحد، فيجب أن تبقى درجة الحرارة دون تغيير.
- Fahrenheit() - يعيد درجة الحرارة محوّلة إلى Fahrenheit باستخدام الصيغة: (celsius * 9/5) + 32
- SetFahrenheit(value float64) - يحوّل input من Fahrenheit إلى Celsius ويخزّنه، ولكن فقط إذا كانت قيمة Celsius الناتجة تساوي أو تتجاوز -273.15
أضف أيضًا مُنشئًا NewTemperature(celsius float64) *Temperature ينشئ درجة حرارة مُهيّأة بالقيمة given (افترض أن input المُعطى للمنشئ صالح).
main.go: اقرأ قيم درجات الحرارة من input واستعرض طُرُق getter/setter. أنشئ درجة حرارة، واعرض قيمها بالوحدتين، ثم حاول تعيين قيم جديدة واعرض النتائج.

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

السطر 1: قيمة Celsius الأولية
السطر 2: قيمة Celsius الجديدة المراد تعيينها
السطر 3: قيمة Fahrenheit الجديدة المراد تعيينها

نسّق جميع مخرجات درجات الحرارة باستخدام منزلتين عشريتين. اطبع التسلسل التالي:

بعد الإنشاء: C: [celsius] F: [fahrenheit]
بعد تعيين Celsius: C: [celsius] F: [fahrenheit]
بعد تعيين Fahrenheit: C: [celsius] F: [fahrenheit]

على سبيل المثال، given 25 و-300 و212، يجب أن يكون الناتج:

C: 25.00 F: 77.00
C: 25.00 F: 77.00
C: 100.00 F: 212.00

لاحظ أن السطر الثاني يعرض قيمًا لم تتغير لأن -300 أقل من الصفر المطلق absolute، ولذلك رفضها setter. يعرض السطر الثالث درجة الحرارة بعد تعيين 212°F بنجاح، والتي تتحول إلى 100°C. هذه هي قوة setters؛ فهي تفرض قواعد تحافظ على صلاحية بياناتك.

جرّب بنفسك

package main

import (
	"fmt"
)

func main() {
	// اقرأ قيم الإدخال
	var initialCelsius float64
	var newCelsius float64
	var newFahrenheit float64
	fmt.Scanln(&initialCelsius)
	fmt.Scanln(&newCelsius)
	fmt.Scanln(&newFahrenheit)

	// TODO: أنشئ Temperature جديد باستخدام المُنشئ

	// TODO: اطبع القيم الأولية بالتنسيق "C: [celsius] F: [fahrenheit]" مع منزلتين عشريتين

	// TODO: حاول تعيين قيمة Celsius جديدة واطبع النتيجة

	// TODO: حاول تعيين قيمة Fahrenheit جديدة واطبع النتيجة
}