.NET Разработчик: “День 2559. #ЗаметкиНаПолях Когда для Моделирования Объектов не Обойтис…”

День 2559. #ЗаметкиНаПолях
Когда для Моделирования Объектов не Обойтись без Методов Расширения
Иногда "обычный" подход к моделированию сущности достигает своего предела, и приходится прибегать к методам расширения.

Проблема
Есть фронтенд-часть, которая позволяет частично обновлять сущность. Представьте, что в JIRA вы можете обновлять заголовок, автора и так далее в одном пользовательском интерфейсе. Для этого не нужен отдельный DTO для каждого варианта использования, достаточно одного DTO, который позволял бы частично обновлять сущность.

Во фронтенде (TypeScript/Angular):

export type Optional<T> = {
  hasValue: boolean;
  value: T;
};

Который используется в DTO:

export type UpdateModel = {
  propOne: Optional<number | null>;
  propTwo: Optional<string | null>;
  propThree: Optional<string>;
};

На бэкэнде это позволяет сделать так:

/// <summary>
/// Структура, представляющая необязательное значение
/// </summary>
public readonly record struct 
 Optional<T>(bool HasValue, T Value)
{
  /// <summary>
  /// Возвращает значение, если оно есть, либо значение по умолчанию.
  /// </summary>
  public T GetValueOrDefault(T current) 
   => HasValue ? Value : current;
}

Затем в методе обновления:

public void 
 UpdateEntity(UpdateModel model)
{
  PropOne = model.PropOne
   .GetValueOrDefault(entity.PropOne);
  PropTwo = model.PropTwo
   .GetValueOrDefault(entity.PropTwo);
  PropThree = model.PropThree
   .GetValueOrDefault(entity.PropThree);
}

Это работает. Но что, если мы добавим propFour с обнуляемым типом:

public int? PropFour { get; set; }

Но в UpdateModel мы хотели бы иметь (потому что в случае обновления значение обязательно):

public Optional<int> PropFour { get; set; }

Теперь, если мы попытаемся выполнить:

PropFour = model.PropFour
 .GetValueOrDefault(entity.PropFour);

Мы получим:
Argument type 'int?' is not assignable to parameter type 'int' (Тип аргумента 'int?' не может быть присвоен параметру типа 'int')

Решение
Проблема в том, что мы не можем легко переопределить возможность присвоения значения null в методе GetValueOrDefault. Здесь помогут методы расширения:

public static class OptionalExtensions
{
  /// <summary>
  /// Возвращает значение, если оно есть, либо значение по умолчанию
  /// </summary>
  public static T? GetValueOrDefault<T>(
   this Optional<T> opt,
   T? value) where T : struct
    => opt.HasValue ? opt.Value : value;
}

Теперь:

PropFour = model.PropFour
 .GetValueOrDefault(entity.PropFour);

работает, как ожидалось.

Источник: https://steven-giesel.com/blogPost/7f6e2ade-b5b9-4de6-a060-281e45b2448e/sometimes-you-just-need-extensions-methods-to-model-your-stuff