AzureFromTheTrenches.Commandingダウンロード - AzureFromTheTrenches.Commandingソースコードのダウンロード

AzureFromTheTrenches.Commanding

その他のカテゴリー

Custom HTTP Dispatch Error Handling

ダウンロード

AzureFromTheTrenches.Commanding

ガイドや API リファレンスを含む完全なドキュメントはヘルプサイトにあります。

また、私のブログの一連の投稿では、「オニオンレイヤー」アーキテクチャから仲介コマンドパターンの利用への移行に関するシリーズも作成しています。

導入

AzureFromTheTrenches.Commanding は、次のような多くの重要な設計目標を備えた構成ベースの非同期コマンドメディエーターフレームワークです。

簡単に使用できる高パフォーマンスのメディエーターを提供する
プロジェクトのライフサイクル全体にわたる進化をサポートし、モジュール式モノリスから完全に分散されたマイクロサービスアーキテクチャへの簡単な分解を可能にする
コマンドのディスパッチおよび実行セマンティクスに対して漏れのない抽象化を提供するため
定型コードを減らす - 単純に言うと、コードが減るということは、エラーが減り、保守が減ることを意味します。

これらの目標をサポートするために、フレームワークは .NET Standard 2.0 (以降) をサポートしているため、さまざまなシナリオで使用でき、以下を可能にする完全にオプションの拡張パッケージが多数用意されています。

構成ベースのアプローチを使用してコマンドから直接 REST API を構築する
キューへのコマンドのディスパッチ (Service Bus のキューとトピック、および Azure Storage)
イベントハブへのコマンドのディスパッチ
コマンドを実行するソースとしてキューを使用する
ローカルメモリキャッシュまたは Redis キャッシュ内の署名に基づいてコマンドをキャッシュする

その機能を利用する必要はありませんが、必要に応じて、コアコードを変更せずに、時間をかけてこの機能を採用することができます。

はじめる

まず、コマンド用の nuget パッケージをインストールします。

 Install-Package AzureFromTheTrenches.Commanding

例として、2 つの数値を加算して結果を返すコマンドを作成してみましょう。

 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 Core サービスプロバイダーへの登録を示しています。

 // 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

簡単な使い方はこれだけです。この例は、依存関係を手動で解決しており、2 つの数値を加算するための多くのボイラープレートがあるため、少し不自然です。しかし、実際のシナリオでは、実際に行う必要があるのは、コマンドハンドラーを適切な場所に登録することだけです。 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 Storage キューへのディスパッチとキューからの実行 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