state machine

杰森州

Jason State是一个简单的状态机器实现。它由JSON文件配置。

支持的平台

• .NET标准2.1
• .NET标准2.0

特征

• 依赖注射友好（也可以独立使用，请参见下文）

目录

1. 为什么杰森州？
2. 安装
3. 用法
   • JSON文件
   • 国家实施
   • 状态上下文
   • microsoft.extensions.ipententientientive Initialition
4. 执照

为什么杰森州？

• 无需担心实施状态模式。使用Jason State，它已经实现了！
• 因为您使用状态模式，所以您的代码更干净。
• 让业务需要改变！仅通过提供的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 ：数组包含对象
  • 条件：状态执行的条件。
  • 状态：状态是下一个州的名称。无需提供名称空间
• 错误状态：您所在州的错误状态的名称。仅当当前状态有您不处理的例外，才会执行此状态。对于每个状态，错误状态可能不同。

可以通过有效的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
    }
  ]
}

国家实施

国家必须继承并通过您的状态上下文实现执行或执行方法。您可以使用任何依赖注入框架进行施工注射。它不会破坏任何东西。

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

状态上下文

Jason State允许您将任何类型的对象添加到上下文中。在州执行期间您需要的一切都应在上下文中。

 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.ipententientientive Initialition

通过引用jasonstate.extension，注册必要的依赖项，以供服务。

 serviceCollection . AddJasonState < TestStateContext > ( ) ;

或者

 serviceCollection . AddAsyncJasonState < TestStateContext > ( ) ; 

样品

可以找到测试成分
可以找到异步线

执照

根据MIT许可，请参阅全文许可。