Загрузка AzureFromTheTrenches.Commanding - Загрузка исходного кода AzureFromTheTrenches.Commanding

AzureFromTheTrenches.Commanding

Другие категории

Custom HTTP Dispatch Error Handling

Скачать

AzureFromTheTrenches.Commanding

Обратите внимание, что полную документацию, включая руководства и справочник по API, можно найти на справочном сайте.

В моем блоге также есть серия статей о переходе от архитектуры «лукового слоя» к использованию шаблона опосредованных команд.

Введение

AzureFromTheTrenches.Commanding — это платформа-посредник асинхронных команд на основе конфигурации, преследующая ряд ключевых целей проектирования:

Предоставить высокопроизводительный посредник для простого использования.
Поддерживать развитие на протяжении жизненного цикла проекта, обеспечивая легкую декомпозицию от модульно-монолитной до полностью распределенной микросервисной архитектуры.
Чтобы обеспечить отсутствие утечек абстракции над семантикой отправки и выполнения команд.
Чтобы уменьшить количество шаблонного кода — меньше кода означает меньше ошибок и меньше поддержки.

Для достижения этих целей платформа поддерживает .NET Standard 2.0 (и выше) и поэтому может использоваться в самых разных сценариях, а также доступен ряд полностью дополнительных пакетов расширений, которые можно включить:

Создание REST API непосредственно из команд с использованием подхода, основанного на конфигурации.
Отправка команд в очереди (очереди и темы служебной шины и хранилище Azure)
Отправка команд в концентраторы событий
Использование очередей как источника выполнения команд
Кэширование команд на основе подписей в кэшах локальной памяти или кэшах Redis.

Вам не обязательно пользоваться этой функциональностью, но вы можете, если хотите, адаптировать ее со временем, не меняя основной код.

Начиная

Сначала установите пакет nuget для команд:

 Install-Package AzureFromTheTrenches.Commanding

В качестве примера давайте создадим команду, которая складывает два числа и возвращает результат:

 public class MathResult
{
    public int Value { get; set; }
}

public class AddCommand : ICommand
{
    public int FirstNumber { get; set; }

    public int SecondNumber { get; set; }
}

На команды воздействуют обработчики, и наш обработчик добавления выглядит следующим образом:

 public AddCommandHandler : ICommandHandler
{
    public Task ExecuteAsync(AddCommand command, MathResult previousResult)
    {
        return new MathResult {
            Value = command.FirstNumber + command.SecondNumber
        };
    }
}

Определив нашу команду, результат и обработчик, нам необходимо зарегистрировать их в командной системе. Если вы просто пишете консольное приложение, вы можете сделать это в Program.cs, но для более реалистичного использования вы должны сделать это при настройке контейнера IoC — удобно думать о регистрации команд как о еще одной части конфигурации вашего приложения. кроме того, вам понадобится доступ к контейнеру. В приведенном ниже примере показана регистрация у основного поставщика услуг Microsoft ASP.Net:

 // First register the commanding framework with the IoC container
IServiceProvider serviceProvider = null;
IServiceCollection serviceCollection = new ServiceCollection();
CommandingDependencyResolverAdapter adapter = new CommandingDependencyResolverAdapter(
    (fromType, toInstance) => services.AddSingleton(fromType, toInstance),
    (fromType, toType) => services.AddTransient(fromType, toType),
    (resolveTo) => _serviceProvider.GetService(resolveTo));
ICommandRegistry registry = adapter.AddCommanding();
serviceProvider = serviceCollection.BuildServiceProvider();

// Now register our handler
registry.Register();

Класс CommandingDependencyResolverAdapter — это адаптер, который позволяет регистрировать платформу в любом IoC-контейнере, а метод AddCommanding регистрирует вводимые интерфейсы управления и возвращает интерфейс ICommandRegistry , который позволяет регистрировать обработчики — вам нужно только зарегистрировать обработчик, платформа сама поймет В остальном и при регистрации используется свободный стиль API для краткого и читаемого кода.

Чтобы отправить нашу команду, нам нужно получить интерфейс ICommandDispatcher и отправить команду. Сделаем это и выведем результат на консоль:

 ICommandDispatcher commandDispatcher = dependencyResolver.ServiceProvider.GetService();
MathResult mathResult = await commandDispatcher.DispatchAsync(new AddCommand { FirstNumber = 5, SecondNumber = 6});
Console.WriteLine(mathResult.Value); // hopefully says 11

И для простого использования это все. Этот пример немного надуман, поскольку мы разрешаем зависимости вручную, и существует много шаблонов для сложения двух чисел, но в реальных сценариях все, что вам действительно нужно сделать, это зарегистрировать обработчики команд в соответствующем месте, например, если вы Если вы используете ASP.Net Core, то весь шаблон внедрения зависимостей будет на месте.

Образцы

Простое выполнение команд в памяти https://github.com/JamesRandall/AzureFromTheTrenches.Commanding/tree/master/Samples/InMemoryCommanding
Отправка команд по HTTP https://github.com/JamesRandall/AzureFromTheTrenches.Commanding/tree/master/Samples/HttpCommanding.Client
Выполнение команд в ответ на HTTP-запросы (ASP.Net Core) https://github.com/JamesRandall/AzureFromTheTrenches.Commanding/tree/master/Samples/HttpCommanding.Web
Отправка в очереди хранилища Azure и выполнение из них https://github.com/JamesRandall/AzureFromTheTrenches.Commanding/tree/master/Samples/AzureStorageQueueCommanding
Аудит хранилища Azure https://github.com/JamesRandall/AzureFromTheTrenches.Commanding/tree/master/Samples/AzureStorageAuditing
Аудит концентратора событий Azure https://github.com/JamesRandall/AzureFromTheTrenches.Commanding/tree/master/Samples/AzureEventHubAuditing