state machine

제이슨 주

Jason State는 간단한 상태 기계 구현입니다. JSON 파일로 구성됩니다.

지원되는 플랫폼

• .NET 표준 2.1
• .NET 표준 2.0

특징

• 의존성 주입 친화적 (독립형으로도 사용할 수 있습니다. 아래 참조)

목차

1. 왜 Jason State인가?
2. 설치
3. 용법
   • JSON 파일
   • 상태 구현
   • 상태 맥락
   • Microsoft.extensions.dependencyInjection 초기화
4. 특허

왜 Jason State인가?

• 상태 패턴 구현에 대해 걱정할 필요가 없습니다. 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 파일에는 상태 배열이 포함되어야합니다. 이 배열에는 있어야합니다 사물.

• 네임 스페이스 : 귀하의 주 네임 스페이스
• 이름 : 상태 파일의 이름 만
• 다음 상태 : 배열이 포함되어 있습니다 사물
  • 조건 : 상태 실행 조건.
  • 주 :주는 다음 주 이름입니다. 네임 스페이스를 제공 할 필요가 없습니다
• 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
    }
  ]
}

상태 구현

국가는 상속해야합니다 상태 컨텍스트와 함께 Execute 또는 ExecuteSync 메소드를 구현하십시오. 건설 주입에 종속성 주입 프레임 워크를 사용할 수 있습니다. 아무것도 깨지 않을 것입니다.

 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.dependencyInjection 초기화

JasonState.extension을 참조하여 다음과 같이 ServiceCecection에 필요한 종속성을 등록하십시오.

 serviceCollection . AddJasonState < TestStateContext > ( ) ;

또는

 serviceCollection . AddAsyncJasonState < TestStateContext > ( ) ; 

샘플

시험 클리어를 찾을 수 있습니다
AsyncTestClient를 찾을 수 있습니다

특허

MIT에 따라 라이센스가 부여되며 전체 텍스트 라이센스를 참조하십시오.