Каков FDG для именования булево свойств?
- Дают подробные примеры. Программисты называют их пользовательские истории или варианты использования.
- Очевидно указывают Ваши требования. Я должен получить имя сотрудника, адрес, и номер телефона от базы данных намного лучше тогда, я должен получить информацию о сотруднике.
- Включают все, что Вы хотите, чтобы он сделал теперь, и что Вы думаете, что могли бы хотеть в будущем.
- Располагают по приоритетам. Сообщите нам то, что требуется, что Вы хотели бы, и что неважно.
2 ответа
В Руководстве по проектированию фреймворка (Брэд Абрамс и Кшиштоф Квалина) говорится, что следует использовать либо Enabled , либо IsEnabled (раздел 3.6.2 ). Они говорят использовать утвердительные фразы (например, CanSeek вместо CantSeek) и использовать наиболее читаемую версию (т.е. Created более читабельна, чем IsCreated).
Я бы лично использовал Enabled в вашем случае , со значением по умолчанию false . User.Enabled хорошо читается и ясно понимает его значение.
Я бы избегал варианта «disabled», поскольку двойной отрицательный результат, такой как «disabled = false», гораздо сложнее понять, чем «enabled = true».
Я бы также предпочел форма прилагательного для свойства к глаголу «enable», что было бы лучшим названием метода.
Это сужает его до «enabled» или «isEnabled», что, вероятно, является вопросом личного стиля и соглашения. Последнее подчеркивает, что это логическое значение; первое более лаконично.