مزرعه

raise "This is an error"

raise ArgumentError.new("This is an argument error")

begin
 raise "This is an error"
rescue
 puts "An error occurred!"
end

begin
 raise "This is an error"
rescue ex
 puts "An error occurred: #{ex.message}"
end

begin
 raise ArgumentError.new("This is an argument error")
rescue ArgumentError
 puts "An argument error occurred!"
end

# or

begin
 raise ArgumentError.new("This is an argument error")
rescue ex : ArgumentError
 puts "An argument error occurred: #{ex.message}"
end

begin
 raise ArgumentError.new("This is an argument error")
rescue ArgumentError
 puts "An argument error occurred!"
rescue
 puts "An error occurred!"
end

begin
 puts "No error occurred"
rescue
 puts "An error occurred!"
else
 puts "No error occurred"
end

begin
 raise "This is an error"
rescue
 puts "An error occurred!"
ensure
 puts "This is always executed"
end

class MyException < Exception
 def initialize
   @message = "This is my exception"
 end
end

raise MyException.new

دستورالعمل‌ها

روزی که مدت‌ها منتظرش بودید بالاخره از راه رسید و شما اکنون صاحب مفتخر یک مزرعه‌ی زیبا در آلپ هستید.

هنوز هم دوست ندارید صبح زود برای غذا دادن به گاوهایتان از خواب بیدار شوید. چون مهندس زبردستی هستید، یک غذارسان می‌سازید به اسم FEED-M-ALL.

آخرین موردی که برای تمام کردن پروژه‌تان لازم است، تکه‌کدی است که مقدار علوفه‌ای را محاسبه می‌کند که هر گاو باید دریافت کند. مهم است که هر گاو مقدار یکسانی دریافت کند؛ باید از بروز درگیری جلوگیری کنید. گاوها بسیار حساس هستند.

خوشبختانه لازم نیست خودتان همه‌ی فرمول‌های محاسبه‌ی مقدار علوفه را به دست آورید. شما از یک کتابخانه‌ی بیرونی مرموز استفاده می‌کنید که آن را در اینترنت پیدا کرده‌اید. قرار است به شادترین گاوها منجر شود. این کتابخانه کلاسی را در دسترس قرار می‌دهد که «رابط» زیر را برآورده می‌کند. در کدی که خودتان می‌نویسید به این تکیه خواهید کرد.

class FodderCalculator
  def fodder_amount! : Number 
  end

  def fattening_factor! : Number
  end
end

همان‌طور که روی کدتان کار می‌کنید، مدیریت خطا را بهبود می‌دهید تا مقاوم‌تر باشد و بعدها که در زندگی روزمره‌ی مزرعه از آن استفاده می‌کنید، دیباگ کردنش آسان‌تر شود.

1. تقسیم یکنواخت غذا

پیش از هر چیز، روی نوشتن کدی تمرکز می‌کنید که برای محاسبه‌ی مقدار علوفه‌ی هر گاو لازم است.

متدی به اسم TheFarm.divide_food پیاده‌سازی کنید که یک شیء FodderCalculator و تعداد گاوها به‌صورت یک عدد صحیح را به عنوان آرگومان می‌پذیرد. برای این کار، فرض می‌کنید تعداد گاوها همیشه بزرگ‌تر از صفر است. این متد باید مقدار غذا به ازای هر گاو را برگرداند.

برای انجام محاسبه، ابتدا باید مقدار کل علوفه‌ی همه‌ی گاوها را به دست آورید. این کار با فراخوانی متد fodder_amount! و پاس دادن تعداد گاوها انجام می‌شود. به‌علاوه، به ضریبی نیاز دارید که این مقدار باید در آن ضرب شود. این ضریب را با فراخوانی متد fattening_factor! به دست می‌آورید. با این دو مقدار و تعداد گاوها، اکنون می‌توانید مقدار غذا به ازای هر گاو را محاسبه کنید (به‌صورت float64).

اگر یکی از متدهایی که فراخوانی می‌کنید خطا برگرداند، اجرا باید متوقف شود و 0 برگردانده شود.

fodder_calculator = FodderCalculator.new(50, 1.5)
TheFarm.divide_food(fodder_calculator, 5)
# => 15.0

fodder_calculator = FodderCalculator.new(50, nil)
TheFarm.divide_food(fodder_calculator, 5)
# => 0

2. بررسی تعداد گاوها

در حین کار روی تمرین اول، متوجه شدید که کتابخانه‌ی بیرونی‌ای که استفاده می‌کنید آن‌قدر که فکر می‌کردید باکیفیت نیست. برای نمونه، نمی‌تواند ورودی‌های نامعتبر را به‌درستی مدیریت کند. می‌خواهید این محدودیت را با افزودن یک بررسی برای مقدار ورودی در کد خودتان دور بزنید.

تابعی به اسم TheFarm.validate_input_and_divide_food بنویسید که امضای آن با TheFarm.divide_food بالا یکسان است.

• اگر تعداد گاوهای داده‌شده بزرگ‌تر از ۰ باشد، تابع باید TheFarm.divide_food را فراخوانی کند و نتیجه‌ی آن فراخوانی را برگرداند.
• اگر تعداد گاوها ۰ یا کمتر باشد، تابع باید خطایی با پیام "Number of cows must be greater than 0" ایجاد کند.

TheFarm.validate_input_and_divide_food(fodderCalculator, 5)
# => 15

TheFarm.validate_input_and_divide_food(fodderCalculator, -2)
# Error: Number of cows must be greater than 0

3. بهبود مدیریت خطا

بررسی تعداد گاوها پیش از فرستادنش کار خوبی بود، اما از پیام خطای نامشخص چندان راضی نیستید. تصمیم می‌گیرید بهتر عمل کنید و یک کلاس خطای سفارشی به اسم InvalidCowsError بسازید.

خطای سفارشی باید تعداد گاوها (Int32) و یک پیام سفارشی (String) را نگه دارد و متد Expection باید داده‌ها را با قالب زیر سریالایز کند:

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

با مجهز بودن به خطای سفارشی خود، تابعی به اسم TheFarm.validate_number_of_cows پیاده‌سازی کنید که تعداد گاوها را به‌صورت یک عدد صحیح می‌گیرد و یک خطا (یا nil) برمی‌گرداند.

• اگر تعداد گاوها کمتر از ۰ باشد، تابع یک InvalidCowsError برمی‌گرداند که پیام سفارشی آن "there are no negative cows" تنظیم شده است.
• اگر تعداد گاوها ۰ باشد، تابع یک InvalidCowsError برمی‌گرداند که پیام سفارشی آن "no cows don't need food" تنظیم شده است.
• در غیر این صورت، تابع nil را برمی‌گرداند تا نشان دهد اعتبارسنجی موفق بوده است.

TheFarm.validate_number_of_cows(5)
# => nil

TheFarm.validate_number_of_cows(-5)
# => InvalidCowsError: -5 cows are invalid: there are no negative cows

پس از زحمت راه‌اندازی این تابع اعتبارسنجی، متوجه می‌شوید که دیگر غروب شده است و میزتان را ترک می‌کنید تا از تماشای غروب خورشید بر فراز کوه‌ها لذت ببرید. کار افزودن واقعی تابع اعتبارسنجی جدید به کدتان را به روز دیگری موکول می‌کنید.