state machine

ジェイソン州

ジェイソン州は、シンプルな州のマシンの実装です。 JSONファイルによって構成されています。

サポートされているプラ​​ットフォーム

• .NET標準2.1
• .NET標準2.0

特徴

• 依存関係注射に優しい（スタンドアロンも使用できます。以下を参照）

目次

1. なぜジェイソンは？
2. インストール
3. 使用法
   • JSONファイル
   • 州の実装
   • 状態コンテキスト
   • microsoft.extensions.dependencyinjectionの初期化
4. ライセンス

なぜジェイソンは？

• 状態パターンの実装を心配する必要はありません。ジェイソン州では、すでに実装されています！
• 状態パターンを使用するため、コードはクリーンです。
• ビジネスを変更する必要があります！提供するJSONファイルだけでフローを変更する柔軟性が得られます。展開する必要はありません！
• 同期と非同期操作をサポートします！

インストール

	パッケージ
JasonState
jasonstate.extension

次のコマンドを使用して、jasonstateとjasonstate.extensionをインストールすることができます。パッケージマネージャーコンソールで次のコマンドを実行します

 dotnet add package JasonState
dotnet add package JasonState.Extension

または、 dotnet cliを使用します

 dotnet add package JasonState
dotnet add package JasonState.Extension

使用法

JSON

まず、有効なJSONファイルを提供する必要があります。このJSONファイルには、状態配列が含まれている必要があります。この配列にはありますオブジェクト。

• 名前空間：州の名前空間
• 名前：状態ファイルの名前だけ
• NextState ：配列が含まれますオブジェクト
  • 条件：州の実行の条件。
  • 州：州は次の州の名前です。名前空間を提供する必要はありません
• ErrorState ：州のエラー状態の名前。この状態は、現在の状態が処理しない例外がある場合にのみ実行されます。エラー状態は、状態ごとに異なる場合があります。

有効なJSONファイルの例は、

{
  "States" : [
    {
      "Namespace" : " TestClient.Impls.States " ,
      "Name" : " InitialState " ,
      "NextState" : [
        {
          "Condition" : " !string.IsNullOrEmpty(FromEmail) && FromEmail.Equals( " [email protected] " ) " ,
          "State" : " ValidatePaymentState "
        },
        {
          "Condition" : " !string.IsNullOrEmpty(FromEmail) && FromEmail.Equals( " [email protected] " ) " ,
          "State" : " FinalState "
        }
      ],
      "ErrorState" : " ErrorState "
    },
    {
      "Namespace" : " TestClient.Impls.States " ,
      "Name" : " ErrorState " ,
      "NextState" : [
        {
          "Condition" : " true " ,
          "State" : " FinalState "
        }
      ],
      "ErrorState" : null
    },
    {
      "Namespace" : " TestClient.Impls.States " ,
      "Name" : " FinalState " ,
      "NextState" : null ,
      "ErrorState" : null
    }
  ]
}

州の実装

州は継承しなければなりませんそして、状態のコンテキストを使用したメソッドを実行するか、 execueSyncを実装します。建設注入のために任意の依存関係噴射フレームワークを使用できます。何も壊れません。

 public class InitialState : BaseState < TestStateContext >
{
    public override void Execute ( TestStateContext context )
    {
      // do the magic
    }
}

状態コンテキスト

ジェイソン州では、あらゆる種類のオブジェクトをコンテキストに追加できます。州の実行中に必要なものはすべて、コンテキストにある必要があります。

 public class TestStateContext
{
    public long CreditCardNumber { get ; set ; }

    public string CardHolderName { get ; set ; }

    public decimal Amount { get ; set ; }
}

public class InitialState : BaseState < TestStateContext >
{
    public override void Execute ( TestStateContext context )
    {
        context . CreditCardNumber = "4545454545454545" ;
    }
}

microsoft.extensions.dependencyinjectionの初期化

jasonState.extensionを参照することにより、次のように必要な依存関係をServiceCollectionに登録します

 serviceCollection . AddJasonState < TestStateContext > ( ) ;

または

 serviceCollection . AddAsyncJasonState < TestStateContext > ( ) ; 

サンプル

TestClientを見つけることができます
AsynctestClientを見つけることができます

ライセンス

MITの下でライセンスを取得して、全文のライセンスを参照してください。