عرض مصدر Refactoring/remove assignments to parameters

<noinclude>{{DISPLAYTITLE:إزالة الإسناد إلى المعاملات (Remove Assignments to Parameters)}}</noinclude>
== المشكلة ==
إسناد قيمةٍ ما إلى أحد المعاملات (parameter) داخل التابع (method body).

== الحل ==
استخدام متغيِّرٍ محليٍّ (local variable) بدلًا من المعامل.

=== مثال ===

==== قبل إعادة التصميم ====
نلاحظ وجود عمليّة إسنادٍ (من بعد الإنقاص بمقدار 2) إلى معامل التابع الوارد باسم <code>inputVal</code>:<syntaxhighlight lang="java">
int discount(int inputVal, int quantity) {
  if (inputVal > 50) {
    inputVal -= 2;
  }
  //...
}

</syntaxhighlight>

==== بعد إعادة التصميم ====
يُعرَّف متغيِّرٌ محليٌّ جديدٌ باسم <code>result</code>، وتُسنَد إليه قيمة المعامل المطلوب (وهو <code>inputVal</code>) واستخدام المتغيِّر الجديد عوضًا عنه:<syntaxhighlight lang="java">
int discount(int inputVal, int quantity) {
  int result = inputVal;
  if (inputVal > 50) {
    result -= 2;
  }
  //...
}

</syntaxhighlight>

== لم إعادة التصميم؟ ==
إنّ الهدف من إعادة التصميم بمثل هذه الحالة هو السبب ذاته وراء تجزئة المتغيِّر المؤقَّت (split temporary variable) والفرق بينهما هو التعامل مع المعاملات (parameters) هنا ومع المتغيِّرات المحليّة (variables) هناك، ويتلخَّص الهدف من إعادة التصميم بنقطتين:
* أولًا؛ إن مُرِّر المعامل عبر مرجعيّته (reference) فستُمرَّر قيمةُ المعامل (بعد تغييرها داخل التابع [method]) إلى المتغيِّر الوسيط (argument) الذي استدعى التابع، وغالبًا ما يحدث هذا دون قصدٍ ويسبِّب بعض الآثار الجانبيّة غير المرغوبة، أمّا إن كان تمرير المعامل -بلغة البرمجة المُستخدَمة- تمريرًا بالقيمة (pass by value) لا بالمرجعيّة فإنّ هذا سيُتعِب المبرمجين غير المعتادين على ذلك.
* ثانيًا؛ سيصبحُ من الصعب (بوجود الإسناداتُ المتعدِّدة وبقيمٍ مختلفةٍ إلى نفس المعامل) تحديدُ البيانات المُخزَّنة في المعامل عند نقطةٍ زمنيّةٍ مُحدَّدة، وتزداد هذه المشكلة سوءًا إن وُثِّق المعامل ومحتوياته مع اختلاف القيم الفعليّة عمّا هو متوقعٌ وجودُه في التابع.

== فوائد تطبيق الحل ==
* سيصبح كلُّ جزءٍ من شيفرة البرنامج مسؤولًا عن مهمةٍ واحدةٍ ممّا يجعل من السهل صيانة (maintain) البرنامج، إذ من الممكن إجراء أيّ تبديلٍ دون القلق حيال الآثار الجانبية التي قد تنجم عن هذا التبديل.
* سيساعد على استخراج الشيفرات المتكرِّرة إلى توابع مستقلِّة.

== آلية الحل ==
# إنشاء متغيِّرٍ محليٍّ (local vaiable) وإسناد قيمة المعامل الأوليّة (initial value) إليه.
# تبديل المعامل إلى المتغيِّر الجديد بأيِّ شيفرةٍ ترِد بعد تعليمة التصريح عنه (بالخطوة السابقة).

== انظر أيضًا ==
* [[Refactoring/extract method|استخراج التوابع]].
* [[Refactoring/replace temp with query|تبديل المتغير الوسيط إلى استدعاء]].

== مصادر ==
* [https://refactoring.guru/remove-assignments-to-parameters صفحة توثيق إزالة الإسناد إلى المعاملات في موقع refactoring.guru.]
[[تصنيف: Refactoring]]