المزرعة

type error interface {
  Error() string
}

func DoSomething() (int, error) {
  // ...
}

func DoSomething() (SomeStruct, int, error) {
  // ...
  return SomeStruct{}, 0, errors.New("failed to calculate result")
}

import "errors"

var ErrNotFound = errors.New("resource was not found")

func DoSomething() error {
  // ...
  return ErrNotFound
}

func Foo() (int, error) {
  return 10, nil
}

func processUserFile() error {
	file, err := os.Open("./users.csv")
	if err != nil {
		return err
	}

	// do something with file
}

type MyCustomError struct {
  message string
  details string
}

func (e *MyCustomError) Error() string {
  return fmt.Sprintf("%s, details: %s", e.message, e.details)
}

func someFunction() error {
  // ...
  return &MyCustomError{
    message: "...",
    details: "...",
  }
}

التعليمات

جاء أخيرًا اليوم الذي انتظرته طويلًا، وأصبحت الآن المالك الفخور بمزرعة جميلة في جبال الألب.

ما زلت لا تحب الاستيقاظ مبكرًا جدًا في الصباح لإطعام أبقارك. ولأنك مهندس بارع، تصنع موزّعًا للطعام اسمه FEED-M-ALL.

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

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

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

type FodderCalculator interface {
	FodderAmount(int) (float64, error)
	FatteningFactor() (float64, error)
}

1. قسّم الطعام بالتساوي

أولًا، تركّز على كتابة الكود اللازم لحساب مقدار العلف لكل بقرة.

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

لإجراء الحساب، تحتاج أولًا إلى جلب المقدار الكلي للعلف الخاص بكل الأبقار. يتم ذلك باستدعاء طريقة FodderAmount وتمرير عدد الأبقار. بالإضافة إلى ذلك، تحتاج إلى معامل ضرب يجب ضرب هذا المقدار فيه. تحصل على معامل الضرب هذا باستدعاء طريقة FatteningFactor. بهاتين القيمتين وعدد الأبقار، يمكنك الآن حساب مقدار الطعام لكل بقرة (كقيمة float64). وهذا ما ينبغي أن تُرجعه دالة DivideFood.

إذا أرجعت إحدى الطرق التي تستدعيها خطأً، فينبغي أن يتوقف التنفيذ وأن يُرجع ذلك الخطأ (كما هو) من دالة DivideFood.

// For this example, we assume FodderAmount returns 50
// and FatteningFactor returns 1.5.
DivideFood(fodderCalculator, 5)
// => 15 <nil>

// Now assuming FodderAmount returns an error with message "something went wrong".
DivideFood(fodderCalculator, 5)
// => 0 "something went wrong"

2. تحقّق من عدد الأبقار

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

اكتب دالة ValidateInputAndDivideFood لها التوقيع نفسه الذي لدالة DivideFood أعلاه.

• إذا كان عدد الأبقار المُمرَّر أكبر من 0، فينبغي أن تستدعي الدالة DivideFood وتُرجع نتائج ذلك الاستدعاء.
• إذا كان عدد الأبقار 0 أو أقل، فينبغي أن تُرجع الدالة خطأً برسالة "invalid number of cows".

ValidateInputAndDivideFood(fodderCalculator, 5)
// => 15 <nil>

ValidateInputAndDivideFood(fodderCalculator, -2)
// => 0 "invalid number of cows"

3. حسّن معالجة الأخطاء

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

ينبغي أن يحمل الخطأ المخصص عدد الأبقار (int) ورسالة مخصصة (string)، وينبغي أن تُسلسل طريقة Error البيانات بالصيغة التالية:

{number of cows} cows are invalid: {custom message}

وبعد أن أصبح لديك خطأك المخصص، نفّذ دالة ValidateNumberOfCows تستقبل عدد الأبقار كعدد صحيح وتُرجع خطأً (أو nil).

• إذا كان عدد الأبقار أقل من 0، تُرجع الدالة InvalidCowsError برسالة مخصصة قيمتها "there are no negative cows".
• إذا كان عدد الأبقار 0، تُرجع الدالة InvalidCowsError برسالة مخصصة قيمتها "no cows don't need food".
• بخلاف ذلك، تُرجع الدالة nil للإشارة إلى أن التحقق نجح.

err := ValidateNumberOfCows(-5)
err.Error()
// => "-5 cows are invalid: there are no negative cows"

بعد العمل الشاق في إعداد دالة التحقق هذه، تلاحظ أن المساء قد حلّ، فتترك مكتبك لتستمتع بغروب الشمس فوق الجبال. وتؤجل إلى يوم آخر مهمة إضافة دالة التحقق الجديدة فعليًا إلى الكود.