Мелкие моменты работы с кодом для удобства

Версия 1.11 от Alexandr Fokin на 2024/06/28 11:24

1Структура метода.
 

Работа со scope, выделение смысловых блоков.

Замечание: не всегда все удобно укладывается именно в такой набор блоков, тут скорее про сам принцип.
Учитывать также удобство, читаемость, объемность, перегруженность. Не противоречит вынесению некоторых частей в отдельные методы.

class MyClass
{
 public void MyMethod()
  {  
   // 1) Блока загрузки данных
   // Переменные данных
   {
    // локальные переменные блока
   }
   
   // 2.1) Блок обработки 1
   {
    // локальные переменные блока
   }
   
   // 2.N Блок обработки N
   {
    // локальные переменные блока
   }
  }
}
2Именование сущностейИспользовать тип в наименованиях, в том числе для entity, dto и других.
В случае, если где-то будет namespace Client или Account, не будет проблем с тем, чтобы всегда удобно обращаться к сущности (только если не происходит совпадение имен сущностей их разных namespace).
ClientEntity, AccountEntity.
3КомментарииУказывать в комментариях ссылки на документацию, схемы.
  1. Описание структуры entity - таблицы, описание dto - контракта.
  2. Описание логики сценария, маппинга.
  3. Ссылка на Т.З.

Про бизнес правила

 
    
Теги: