state machine

Estado de Jason

Jason State é uma implementação simples de máquina de estado. É configurado por um arquivo json.

Plataformas suportadas

• .NET Padrão 2.1
• .NET Standard 2.0

Características

• Friendia à injeção de dependência (também pode ser usado independente, veja abaixo)

Índice

1. Por que Jason State?
2. Instalação
3. Uso
   • Arquivo json
   • Implementação do estado
   • Contexto do estado
   • Microsoft.Extensions.DependEncyInjection Inicialização
4. Licença

Por que Jason State?

• Não há necessidade de se preocupar em implementar o padrão de estado. Com o Jason State, ele já está implementado!
• Como você usa o padrão de estado, seu código é mais limpo.
• Deixe o negócio precisar mudar! Isso lhe dará a flexibilidade de alterar o fluxo apenas pelo arquivo JSON que você fornece. Não há necessidade de implantação!
• Suporta operações de sincronização e assíncrono!

Instalação

	Pacote
Jasonstate
Jasonstate.extension

Os comandos a seguir podem ser usados ​​para instalar Jasonstate e Jasonstate.extension, execute o seguinte comando no console do gerenciador de pacotes

 dotnet add package JasonState
dotnet add package JasonState.Extension

Ou use dotnet cli

 dotnet add package JasonState
dotnet add package JasonState.Extension

Uso

JSON

Primeiro, você precisa fornecer um arquivo JSON válido. Este arquivo JSON deve conter uma matriz de estados . Esta matriz deveria ter objetos.

• Namespace : namespace do seu estado
• Nome : apenas o nome do seu arquivo de estado
• NextState :Array contémobjetos
  • Condição : a condição para a execução dos estados.
  • Estado : Estado é o nome do próximo estado. Não há necessidade de fornecer namespace
• ErrorState : nome do estado de erro do seu estado. Esse estado será executado apenas se o estado atual tiver uma exceção que você não lida. O estado de erro pode ser diferente para cada estado.

Um exemplo de um arquivo JSON válido pode ser encontrado através

{
  "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
    }
  ]
}

Implementação do estado

Os estados devem herdar de e implementar o método executado ou executado , com o seu contexto de estado. Você pode usar qualquer estrutura de injeção de dependência para injeções de construção. Não vai quebrar nada.

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

Contexto do estado

O Jason State permite que você adicione qualquer tipo de objeto ao contexto. Tudo o que você precisa durante a execução do estado deve estar no contexto.

 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 Inicialização

Ao referenciar Jasonstate.extension, registre as dependências necessárias à serviceCollection da seguinte maneira

 serviceCollection . AddJasonState < TestStateContext > ( ) ;

ou

 serviceCollection . AddAsyncJasonState < TestStateContext > ( ) ; 

Amostras

TestClient pode ser encontrado
Assínctestclient pode ser encontrado

Licença

Licenciado no MIT, consulte a licença para o texto completo.