عرض مصدر Refactoring/introduce null object

<noinclude>{{DISPLAYTITLE: تقديم الكائن الفارغ (Introduce Null Object)}}</noinclude>
== المشكلة ==
تؤدي إعادة بعض التوابع للقيمة <code>null</code> بدلًا من الكائنات الحقيقية إلى امتلاء الشيفرة البرمجية بالعديد من نقاط التحقق من القيمة <code>null</code>.

== الحل ==
إعادة كائن فارغ يظهر السلوك الافتراضي بدلًا من <code>null</code>.

=== مثال ===

==== قبل إعادة التصميم ====
وجودة نقطة تحقق شرطية من الكائن <code>customer</code> لاتخاذ إجراء مناسب إن كانت قيمته <code>null</code>:

في لغة Java:<syntaxhighlight lang="java">
if (customer == null) {
  plan = BillingPlan.basic();
}
else {
  plan = customer.getPlan();
}
</syntaxhighlight>في لغة C#‎:<syntaxhighlight lang="c#">
if (customer == null) 
{
  plan = BillingPlan.Basic();
}
else 
{
  plan = customer.GetPlan();
}
</syntaxhighlight>في لغة PHP:<syntaxhighlight lang="php">
if ($customer == null)
  $plan = BillingPlan::basic();
else
  $plan = $customer->getPlan();
</syntaxhighlight>في لغة Python:<syntaxhighlight lang="python">
if customer == None:
    plan = BillingPlan.basic()
else:
    plan = customer.getPlan()
</syntaxhighlight>

==== بعد إعادة التصميم ====
إنشاء صنف عدمي للكائن <code>customer</code> يدعى <code>NullCustomer</code> يستبدل القيم العدمية فيه:

في لغة Java:<syntaxhighlight lang="java">
class NullCustomer extends Customer {
  boolean isNull() {
    return true;
  }
  Plan getPlan() {
    return new NullPlan();
  }
  // بعض وظائف NULL الأخرى.
}

// استبدل القيم الفارغة بالكائن Null.
customer = (order.customer != null) ?
  order.customer : new NullCustomer();

// استخدام كائن Null كما لو كان صنف فرعي عادي.
plan = customer.getPlan();
</syntaxhighlight>في لغة C#‎:<syntaxhighlight lang="c#">
public sealed class NullCustomer: Customer 
{
  public override bool IsNull 
  {
    get { return true; }
  }
  
  public override Plan GetPlan() 
  {
    return new NullPlan();
  }
  // بعض وظائف NULL الأخرى.
}

// استبدل القيم الفارغة بالكائن Null.
customer = order.customer ?? new NullCustomer();

// استخدام كائن Null كما لو كان صنف فرعي عادي.
plan = customer.GetPlan();
</syntaxhighlight>في لغة PHP:<syntaxhighlight lang="php">
class NullCustomer extends Customer {
  function isNull() {
    return true;
  }
  function getPlan() {
    return new NullPlan();
  }
  // بعض وظائف NULL الأخرى.

// استبدل القيم الفارغة بالكائن Null.
$customer = ($order->customer != null) ?
  $order->customer :
  new NullCustomer();

// استخدام كائن Null كما لو كان صنف فرعي عادي.
$plan = $customer->getPlan();
</syntaxhighlight>في لغة Python:<syntaxhighlight lang="python">
class NullCustomer(Customer):

    def isNull(self):
        return True
    
    def getPlan(self):
        return self.NullPlan()
        
    # بعض وظائف NULL الأخرى.

# استبدل القيم الفارغة بالكائن Null.
customer = order.customer if order.customer != None else NullCustomer()

# استخدام كائن Null كما لو كان صنف فرعي عادي.
plan = customer.getPlan()
</syntaxhighlight>

== لم إعادة التصميم؟ ==
تُحيل العشرات من نقاط التحقق من القيمة <code>null</code> الشيفرةَ البرمجية أطول وأقبح.

== مساوئ تطبيق الحل ==
* يجب إنشاء صنف جديد آخر للتخلص من الشرطيات.

== آلية الحل ==
# أنشئ صنفًا فرعيًّا للصنف المعني يقوم بدور كائن فارغ.
# في كلا الصنفين، أنشئ التابع <code>isNull()‎</code> الذي يعيد <code>true</code> لكائن فارغ و <code>false</code> للصنف الحقيقي.
# ابحث عن جميع الأماكن التي يمكن أن تُعيد فيها <code>null</code> للشيفرة بدلًا من كائنٍ حقيقيٍ، وغيَّر الشيفرة البرمجية بحيث تُعيد كائنًا فارغًا.
# ابحث عن جميع الأماكن حيث تُقارن متغيرات الصنف الحقيقي مع <code>null</code>، واستبدل نقاط التحقق هذه باستدعاءات للتابع <code>isNull()‎.</code>
#* إذا نُفّذَت توابع الصنف الأصلي داخل هذه الكتل الشرطية عندما لا تساوي قيمة ما <code>null</code>، أعِد تعريف هذه التوابع في الصنف الفارغ وأدرج فيه الشيفرة البرمجية من الجزء <code>else</code> من الشرط. ثم يمكنك حذف كامل الشرط وتنفيذ تغيير السلوك عبر التعددية الشكلية.
#* إذا لم تكن الأمور بهذه البساطة ولا يمكن إعادة تعريف التوابع، فتحقق من إذا كان يمكنك ببساطة استخراج العوامل التي كان من المفترض تنفيذها في حالة القيمة <code>null</code> إلى توابع جديدة للكائن الفارغ. واستدعِ هذه التوابع بدلًا من الشيفرة البرمجية القديمة في <code>else</code> كعمليات افتراضية.

== انظر أيضًا ==
* [[Refactoring/replace conditional with polymorphism|تبديل الشرطيات بالتعدديّة الشكليّة]].
* [[Refactoring/switch statements|استخدام التعليمة Switch]].
* [[Refactoring/temporary field|الحقول المؤقتة]].

== مصادر ==
* [https://refactoring.guru/introduce-null-object صفحة توثيق تقديم الكائن الفارغ في موقع refactoring.guru].
[[تصنيف:Refactoring]]
[[تصنيف:Refactoring Techniques]]
[[تصنيف:Refactoring Simplifying Conditional Expressions]]