عرض مصدر Refactoring/rename method

<noinclude>{{DISPLAYTITLE: إعادة تسمية التوابع (Rename Method)}}</noinclude>
== المشكلة ==
لا يعبِّر اسم التابع عن ما يقوم به.

== الحل ==
إعادة تسمية التابع.

=== مثال ===

==== قبل إعادة التصميم ====
لا يفسر اسم التابع <code>()getsnm</code> في الصنف <code>Customer</code> ما يقوم به.
[[ملف:Rename Method - Before.png|بديل=لا يفسر اسم التابع ما يقوم به.|بدون|تصغير|لا يفسر اسم التابع ما يقوم به.]]

==== بعد إعادة التصميم ====
إعادة تسمية التابع <code>()getsnm</code> إلى <code>()getSecondName</code> الذي يصف ما يقوم به.
[[ملف:Rename Method - After.png|بديل=يفسر اسم التابع ما يقوم به.|بدون|تصغير|يفسر اسم التابع ما يقوم به.]]

== لم إعادة التصميم؟ ==
ربما كانت تسمية تابعٍ ما سيئة من البداية - على سبيل المثال، أنشأ شخصٌ ما التابع في عجلة ولم يهتم كفاية بتسميته بشكل جيد.

أو ربما سُميَ التابع بشكلٍ جيد في البداية ولكن مع تطور وظيفته، أصبح اسم التابع لا يصفه بشكلٍ جيد.

== فوائد تطبيق الحل ==
* قابلية قراءة الشفرة البرمجية. حاول أن تعطي التابع الجديد اسمًا يعكس ما يفعله شيء مثل <code>createOrder()</code>، و <code>renderCustomerInfo()</code>‎، ...إلخ.

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

== انظر أيضًا ==
* [[Refactoring/add parameter|إضافة معامل (Add Parameter)]].
* [[Refactoring/remove parameter|حذف المعاملات (Remove Parameter)]].
* [[Refactoring/alternative classes with different interfaces|الأصناف البديلة (alternative) ذات الواجهات (interfaces) المختلفة]].
* [[Refactoring/comments|التعليقات (Comments)]].

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