Исходный код вики Некоторые моменты
Версия 1.1 от Alexandr Fokin на 2024/05/27 14:53
Последние авторы
| author | version | line-number | content |
|---|---|---|---|
| 1 | |(% style="width:37px" %)1|(% style="width:254px" %)Работа со scope. Выделение смысловых блоков.|(% style="width:1164px" %)((( | ||
| 2 | Замечание: не всегда все удобно укладывается в именно такой scope, тут скорее про сам принцип. | ||
| 3 | Учитывать также удобство, читаемость, объемность, перегруженность. Не противоречит вынесению некоторых частей в отдельные методы. | ||
| 4 | |||
| 5 | {{code language="c#"}} | ||
| 6 | class MyClass | ||
| 7 | { | ||
| 8 | public void MyMethod() | ||
| 9 | { | ||
| 10 | // 1) Валидация | ||
| 11 | |||
| 12 | // 2) Блока загрузки данных | ||
| 13 | // Переменные данных | ||
| 14 | { | ||
| 15 | // локальные переменные блока | ||
| 16 | } | ||
| 17 | |||
| 18 | // 3.1) Блок обработки 1 | ||
| 19 | { | ||
| 20 | // локальные переменные блока | ||
| 21 | } | ||
| 22 | |||
| 23 | // 3.N Блок обработки N | ||
| 24 | { | ||
| 25 | // локальные переменные блока | ||
| 26 | } | ||
| 27 | } | ||
| 28 | } | ||
| 29 | {{/code}} | ||
| 30 | ))) | ||
| 31 | |(% style="width:37px" %)2|(% style="width:254px" %)Именование сущностей|(% style="width:1164px" %)Использовать тип в наименованиях, в том числе для сущностей. | ||
| 32 | ClientEntity, AccountEntity. | ||
| 33 | В случае, если где-то будет namespace Client или Account, не будет проблем с тем, чтобы всегда удобно обращаться к сущности (только если не происходит совпадение имен сущностей их разных namespace). | ||
| 34 | |(% style="width:37px" %)3|(% style="width:254px" %)Комментарии|(% style="width:1164px" %)Указывать в комментариях ссылки на документацию, схемы.((( | ||
| 35 | 1. Описание entity - таблицы, описание dto - контракта. | ||
| 36 | 1. Описание логики сценария, маппинга. | ||
| 37 | 1. Ссылка на Т.З. | ||
| 38 | ))) | ||
| 39 | |(% style="width:37px" %) |(% style="width:254px" %) |(% style="width:1164px" %) | ||
| 40 | |||
| 41 |