Паттерн "Команда" в C# — объекты действий, а не методы

ОБЯЗАТЕЛЬНОДЛЯ НОВИЧКОВ

Разработчику Архитектору

Краткий обзор паттерна есть в поведенческих паттернах. Здесь — практика на C#: когда ICommand действительно полезен, а когда хватает делегата или обычного сервисного метода.

Загрузка редактора схем…

---

Задача паттерна

Команда превращает действие в объект. Такой объект можно:

• передавать между слоями;
• класть в очередь;
• логировать;
• повторять и отменять.

Клиент вызывает команду через общий интерфейс и не знает детали выполнения.

Загрузка ArchiStyler…

---

Классический вариант

public interface ICommand
{
    void Execute();
    void Undo();
}

public class SaveDocumentCommand : ICommand
{
    private readonly DocumentService _receiver;
    private readonly string _path;

    public SaveDocumentCommand(DocumentService receiver, string path)
    {
        _receiver = receiver;
        _path = path;
    }

    public void Execute() => _receiver.Save(_path);
    public void Undo() => _receiver.RestorePreviousVersion(_path);
}

ToolbarButton (invoker) хранит ICommand и вызывает Execute(). Такая форма удобна в UI, редакторах и workflow-системах.

---

Что даёт C# поверх канона

Для простых сценариев можно хранить команды как делегаты:

var actions = new Dictionary<string, Action>
{
    ["refresh"] = () => cache.Reload(),
    ["clear"] = () => cache.Clear()
};

actions["refresh"]();

Минимум кода, но нет явной модели Undo, метаданных команды и сериализации.

Если нужен контекст действия, версия, user id, idempotency key, объект команды оказывается удобнее:

public record CreateOrderCommand(Guid UserId, IReadOnlyList<OrderItemDto> Items);

---

Command и MediatR в .NET

В современных ASP.NET Core проектах паттерн Command часто проявляется через MediatR:

• CreateOrderCommand : IRequest<Guid> — объект намерения;
• CreateOrderCommandHandler — исполнитель;
• ISender.Send(command) — invoker.

Это вариант паттерна, адаптированный под DI и pipeline-поведения (валидация, логирование, трейсинг). Детально — в MediatR и pipeline.

---

Когда Command уместен

Ситуация	Почему помогает Command
Undo/redo в UI	Команда хранит данные для отката
Очереди и отложенное исполнение	Объект можно сериализовать и выполнить позже
Аудит действий	Один объект = одна бизнес-операция с метаданными
CQRS в Application-слое	Явное разделение сценариев записи и чтения

---

Когда это лишний слой

Если операция:

• короткая;
• не требует очереди, истории и отката;
• вызывается в одном месте;

обычный сервисный метод обычно проще:

await orderService.CreateAsync(dto, ct);

Иногда ICommand + Handler + Invoker только увеличивают число файлов без новой ценности.

---

Чек-лист

Вопрос	Рекомендация
Нужно отменять и повторять действия	Command-объект
Нужны очередь, ретраи, журнал	Command-объект
Просто вызвать одну операцию	Сервисный метод или Action
Есть Application-слой с MediatR	Команды как IRequest

Практика

В C# Command хорошо работает как контракт бизнес-действий и транспорт операции через слои. Для локальных коротких вызовов проще и дешевле остаются обычные методы.

---

Итог

Паттерн Command остаётся актуальным, когда действие нужно трактовать как отдельную сущность системы. В .NET это часто реализуется через MediatR, очереди и pipeline. Для простых вызовов разумнее оставить плоский сервисный API.

---

См. также

• Поведенческие паттерны — Команда
• MediatR и pipeline в слое Application
• Паттерн "Стратегия" в C#