اصطلاحات التسمية:مبادئ توجيهية الأفعال/الأسماء و قواعد اللغة الإنجليزية الاستخدام

https://stackoverflow.com/questions/412839

03-07-2019
|

سؤال

أي شخص يمكن أن تشير لي إلى الموقع أو أعطني بعض الحكمة على كيف يمكنك أن تذهب نحو اختيار أسماء واجهات دروس وربما الأساليب والخصائص المتصلة ما هذا الكائن أو الأسلوب ؟

هذا هو على وجه التحديد من أجل تطوير مايكروسوفت ، لذلك جافا سقو "doGet" حتى لا تستخدم حقا, ومع ذلك بعض القواعد العامة التي عبر حواجز اللغة أن (ظننت) موجودة.

على سبيل المثال قد تساعد:عندي 4 خيارات من أسماء واجهة:

IGroupedItem
IGroupableItem
IDataEntity
IGroupedEntity

أنها تحتوي على جميع الصفة و الاسم أو اسما.تبحث في .NET framework يبدو أنه يجب أن يكون هناك نوع من الأوامر هذا مستقيم ؟ جانبا من الواضح الأفعال على الطرق.

تحرير: على الرغم من المثال هو واجهة, أنا لا يحد هذا مجرد واجهات.المبدأ التوجيهي العام الطبقات الأسماء ، أساليب الأفعال ، خصائص الأسماء.أعتقد ما أعنيه هو اختيار مرادف.هو رمي "كيان" في كل مكان خاطئ

المحلول

نظرة على MSDN المواد لتسمية المبادئ التوجيهية.باختصار:

استخدام الأسماء على أسماء فئة والممتلكات أسماء (الواضح)
واجهة أسماء تبدأ مع استخدام الأسماء أو الصفات لوصف السلوك
استخدام الأفعال على طريقة أسماء لوصف العمل

على سبيل المثال الخاص بك - IGroupableItem.

نصائح أخرى

واجهات الأشياء فئة غير قادرة على القيام.لا ما هو, لكن ما يمكن هل.

IGroupableItem

أسماء أخرى لوصف ما هي الأشياء أو غامضة جدا أن تكون مفيدة.

على وجه التحديد, "IDataEntity" إلى حد كبير معنى.بعد كل شيء, كل شيء الكيان البيانات.

MSDN مقالا فقط على واجهة تسمية التوجيهية التي قد تساعدك على الخروج.إذا كنت ترغب في اصطلاحات التسمية من الأشياء الأخرى من واجهات, جنبا إلى جنب مع العديد من الآخرين التسمية تصميم المبادئ التوجيهية يمكن أن تجد أن كل شيء على MSDN أيضا.

هذا هو نفس مادة Spodi الجواب ، ولكن MSDN هو تصميم المبادئ التوجيهية مكتبة فئة المطورين هي في معظمها ممتازة تغطي تسمية وأكثر من هذا بكثير.

هناك مادة لطيفة مما يجعل رمز الخطأ نظرة خاطئة جويل سبولسكي.فإنه يقول لا حول شعبية جدا ولكن مفيد جدا اصطلاح التسمية.

وكذلك MSDN التوجيهية ، وهناك C# الترميز وثيقة المعايير من IDesign قبل Juval لوي التي هي مفيدة جدا (لا أعرف إذا كان/كم يختلف هذا MSDN).

C# معايير الترميز

حاول هذا....

الموقع الرئيسي: http://www.ssw.com.au/ssw/standards/Default.aspx
مدونة قواعد: http://www.ssw.com.au/ssw/Standards/Rules/RulestoBetterCode.aspx

مرخصة بموجب: CC-BY-SA مع الإسناد

لا تنتمي إلى StackOverflow