عرض مصدر Refactoring/replace parameter with explicit methods

<noinclude>{{DISPLAYTITLE: استبدال المعامل بتوابع صريحة (Replace Parameter with Explicit Methods)}}</noinclude> 
== المشكلة ==
ينقسم التابع إلى أجزاء، كل منها يتم تشغيله اعتمادًا على قيمة المعامل.

== الحل ==
استخراج الأجزاء الفردية من التابع إلى توابعها الخاصة واستدعائها بدلًا من استدعاء التابع الأصلي.

=== مثال ===

==== قبل إعادة التصميم ====
وجود تابع يدعى <code>()setValue</code> يضبط قيمة الارتفاع والعرض بناءً على تمرير سلسلة نصية صريحة بذلك:

في لغة Java:<syntaxhighlight lang="java">
void setValue(String name, int value) {
  if (name.equals("height")) {
    height = value;
    return;
  }
  if (name.equals("width")) {
    width = value;
    return;
  }
  Assert.shouldNeverReachHere();
}
</syntaxhighlight>في لغة C#‎:<syntaxhighlight lang="c#">
void SetValue(string name, int value) 
{
  if (name.Equals("height")) 
  {
    height = value;
    return;
  }
  if (name.Equals("width")) 
  {
    width = value;
    return;
  }
  Assert.Fail();
}
</syntaxhighlight>في لغة PHP:<syntaxhighlight lang="php">
function setValue($name, $value) {
  if ($name === "height") {
    $this->height = $value;
    return;
  }
  if ($name === "width") {
    $this->width = $value;
    return;
  }
  assert("Should never reach here");
}
</syntaxhighlight>في لغة Python:<syntaxhighlight lang="python">
def output(self, type):
    if name == "banner"
        # Print the banner.
        # ...
    if name == "info"
        # Print the info.
        # ...
</syntaxhighlight>

==== بعد إعادة التصميم ====
استخراج التابع السابق إلى تابعين <code>()setHeight</code> و <code>()setWidth</code> يضبط الأول قيمة الارتفاع والثاني قيمة العرض:

في لغة Java:<syntaxhighlight lang="java">
void setHeight(int arg) {
  height = arg;
}
void setWidth(int arg) {
  width = arg;
}
</syntaxhighlight>في لغة C#‎:<syntaxhighlight lang="c#">
void SetHeight(int arg) 
{
  height = arg;
}
void SetWidth(int arg) 
{
  width = arg;
}
</syntaxhighlight>في لغة PHP:<syntaxhighlight lang="php">
function setHeight($arg) {
  $this->height = $arg;
}
function setWidth($arg) {
  $this->width = $arg;
}
</syntaxhighlight>في لغة Python:<syntaxhighlight lang="python">
def outputBanner(self):
    # Print the banner.
    # ...

def outputInfo(self):
    # Print the info.
    # ...
</syntaxhighlight>

== لم إعادة التصميم؟ ==
يعتمد تضخُّم التابع الذي يحتوي على بدائل على المعامل بشكل هائل. تُشغَّل الشيفرة غير التافهة في كل فرع ونادرًا جدًا ما تضاف بدائل جديدة.

== فوائد تطبيق الحل ==
* تحسين إمكانية قراءة الشيفرة البرمجية. فإنه من الأسهل بكثير فهم الغرض من <code>startEngine()</code>‎ عن <code>setValue("engineEnabled", true)‎</code>.

== متى يترك هذا الحل؟ ==
* لا يُستبدل المعامل بتوابع صريحة إذا كان من النادر تغيير التابع ولا تُضاف بدائل جديدة داخله.

== آلية الحل ==
# أنشئ تابعًا منفصلًا لكل بديل لهذا التابع. شغِّل هذه التوابع بناءً على قيمة المعامل في التابع الرئيسي.
# ابحث عن كل الأماكن التي يُستدعى فيها التابع الأصلي. ضع في هذه الأماكن استدعاءً لأحد البدائل الجديدة المعتمدة على المعامل.
# عندما لا يتبقى أية استدعاءات إلى التابع الأصلي، احذفه.

== انظر أيضًا ==
* [[Refactoring/parameterize method|تحويل التوابع إلى معاملات (Parameterize Method)]].
* [[Refactoring/replace conditional with polymorphism|تبديل الشرطيات بالتعدديّة الشكليّة (Replace Conditional with Polymorphism)]].
* [[Refactoring/switch statements|استخدام التعليمة Switch]].
* [[Refactoring/switch statements|التابع الطويل]].

== مصادر ==
* [https://refactoring.guru/replace-parameter-with-explicit-methods صفحة توثيق استبدال المعامل بتوابع صريحة في موقع refactoring.guru].
[[تصنيف:Refactoring]]
[[تصنيف:Refactoring Techniques]]
[[تصنيف:Refactoring Simplifying Method Calls]]