Некоторые моменты

Версия 1.1 от Alexandr Fokin на 2024/05/27 14:53
1Работа со scope. Выделение смысловых блоков.

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

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

 

Теги:
Создал(а) Alexandr Fokin 2024/05/27 14:53