تفضيل التسمية: getSupportedModes () vs supportedModes ()؟
-
22-09-2019 - |
سؤال
أواجه صعوبة في تحديد الاسم الذي يجب اختياره لطريقتي. أعتقد أنهما كلاهما توسير ذاتيًا إلى حد كبير ، لكن الأخير أسرع في الكتابة ، لذلك ، فإن تفضيلي الحالي هو دعم الأدوية (). ما رأيك؟
المحلول
إلي، getSupportedModes
يعني استرجاع بسيط ، بينما إذا كان هناك بعض المنطق الفعلي لتوظيفهم ، شيء مثل determineSupportedModes
أو calculateSupportedModes
ربما افضل. يجب أن يصف الاسم ما تفعله الوظيفة. الإيجاز ليس اعتبارًا كبيرًا مع IDEs الحديثة مع شكل من أشكال الإكمال التلقائي.
اللغات المختلفة لها أيضا اتفاقياتها الخاصة. على سبيل المثال ، وظيفة تسمى calculateSupportedModes
في جافا عادة ما يتم استدعاؤها CalculateSupportedModes
في C# أو VB.
نصائح أخرى
أفضل أن يكون أكثر وضوحًا هو GetSupportedModes. أنت لا تريد من المطورين الآخرين أن يخمنوا ما تفعله الطريقة.
يجب تسمية الوظائف التي تعمل على أكثر من مجرد الحجج التي تم تمريرها كإجراءات.