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

<noinclude>{{DISPLAYTITLE: تعريف كائن المُعامل (Introduce Parameter Object)}}</noinclude> 
== المشكلة ==
تحتوي التوابع على نفس المجموعة المتكررة من المعاملات.

== الحل ==
استبدال هذه المعاملات بكائنٍ واحد.

=== مثال ===

==== قبل إعادة التصميم ====
تمرير نفس مجموعة المعاملات إلى توابع الصنف <code>Customer</code>:[[ملف:Introduce Parameter Object - Before.png|بديل=تحتوي التوابع على نفس المجموعة المتكررة من المعاملات.|بدون|تصغير|تحتوي التوابع على نفس المجموعة المتكررة من المعاملات.]]

==== بعد إعادة التصميم ====
تبديل كائن واحد بتلك المعاملات وتمريره إلى توابع الصنف <code>Customer</code> التي تشترك بنفس مجموعة المعاملات:[[ملف:Introduce Parameter Object - After.png|بديل=استبدال هذه المعاملات بكائنٍ واحد.|بدون|تصغير|استبدال هذه المعاملات بكائنٍ واحد.]]

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

== فوائد تطبيق الحل ==
* تصبح الشيفرة أكثر قابلية للقراءة؛ ويصبح كائنٌ واحدٌ له اسم مفهوم بدلًا من خلط المعاملات.
* تُنشئ المجموعات المتطابقة من المعاملات والمتناثرة هنا وهناك نوعًا خاصًا بها من ازدواجية الشيفرة: في حين لا تُستدعى الشيفرات المتطابقة، توجد مجموعات من المعاملات والوسائط باستمرار.

== مساوئ تطبيق الحل ==
* إذا نقلت البيانات فقط إلى صنف جديد ولم تخطط لنقل أي سلوكيات أو عمليات ذات الصلة إليه، يبدأ هذا في إحداث اختلال في [[Refactoring/data class|أصناف البيانات]].

== آلية الحل ==
# أنشئ صنفًا جديدًا يمثل مجموعة المعاملات الخاصة بك. اجعل الصنف غير قابل للتغيير.
# استخدم [[Refactoring/add parameter|إضافة معامل]] في التابع الذي تريد إعادة تصميمه، حيث سيُمرر كائن المعامل. في كافة استدعاءات التابع، مرِّر الكائن الذي أُنشئ من معاملات التابع القديم إلى هذا المعامل.
# ابدأ الآن في إزالة المعاملات القديمة من التابع واحدًا تلو الآخر، واستبدالها في الشيفرة بحقول من كائن المعامل. ثم جرب البرنامج بعد استبدال كل معامل.
# عند الانتهاء، راجع ما إذا كان هناك أي استفادة من نقل جزء من التابع (أو في بعض الأحيان التابع بأكمله) إلى صنف كائن معامل. إذا كان الأمر كذلك، استخدم [[Refactoring/move method|نقل التوابع]] أو  <nowiki/>[[Refactoring/extract method|استخراج التوابع]].

== انظر أيضًا ==
* [[Refactoring/preserve whole object|الحفاظ على الكائن كاملًا (Preserve Whole Object)]].
* [[Refactoring/long parameter list|القائمة الطويلة للمعاملات (Long Parameter List)]].
* [[Refactoring/data clumps|البيانات المُجمَّعة (Data Clumps)]].
* [[Refactoring/primitive obsession|هوس الحقول الأساسية (Primitive Obsession)]].
* [[Refactoring/long method|التوابع الطويلة (Long Methods)]].

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