state machine

État de Jason

Jason State est une simple implémentation de la machine d'état. Il est configuré par un fichier JSON.

Plates-formes prises en charge

• .NET Standard 2.1
• .NET Standard 2.0

Caractéristiques

• Dépendance à l'injection de dépendance (peut également être utilisée autonome, voir ci-dessous)

Table des matières

1. Pourquoi Jason State?
2. Installation
3. Usage
   • Fichier json
   • Mise en œuvre de l'État
   • Contexte d'état
   • Microsoft.Extensions.DendencyInjection Initialisation
4. Licence

Pourquoi Jason State?

• Pas besoin de s'inquiéter de la mise en œuvre du modèle d'état. Avec Jason State, il est déjà mis en œuvre!
• Parce que vous utilisez un modèle d'état, votre code est plus propre.
• Laissez l'entreprise Besoin de changer! Cela vous donnera la flexibilité de modifier le flux uniquement par le fichier JSON que vous fournissez. Pas besoin de déploiement!
• Prend en charge les opérations synchronisées et asynchrones!

Installation

	Emballer
Jasonstate
Jasonstate.extension

Les commandes suivantes peuvent être utilisées pour installer JasonState et JasonState.Extension, exécutez la commande suivante dans la console du gestionnaire de packages

 dotnet add package JasonState
dotnet add package JasonState.Extension

Ou utiliser dotnet cli

 dotnet add package JasonState
dotnet add package JasonState.Extension

Usage

Json

Vous devez d'abord fournir un fichier JSON valide. Ce fichier JSON doit contenir un tableau des états . Ce tableau devrait avoir objets.

• Espace de noms : espace de noms de votre état
• Nom : juste le nom de votre fichier d'état
• NextState : le tableau contient objets
  • Condition : la condition pour l'exécution des états.
  • État : L'état est le nom de l'état suivant. Pas besoin de fournir un espace de noms
• ErrorState : nom de l'état d'erreur de votre état. Cet état ne sera exécuté que si l'état actuel a une exception que vous ne gérez pas. L'état d'erreur peut être différent pour chaque état.

Un exemple de fichier JSON valide peut être trouvé à travers

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

Mise en œuvre de l'État

Les États doivent hériter de et implémenter l'exécution ou exécuter la méthode avec votre contexte d'état. Vous pouvez utiliser n'importe quel cadre d'injection de dépendance pour les injections de construction. Il ne rompra rien.

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

Contexte d'état

Jason State vous permet d'ajouter tout type d'objet au contexte. Tout ce dont vous avez besoin pendant l'exécution de l'État devrait être dans le contexte.

 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.DendencyInjection Initialisation

En faisant référence à JasonState.Extension, enregistrez les dépendances nécessaires à la service de service comme suit

 serviceCollection . AddJasonState < TestStateContext > ( ) ;

ou

 serviceCollection . AddAsyncJasonState < TestStateContext > ( ) ; 

Échantillons

TestClient peut être trouvé
AsyncTestClient peut être trouvé

Licence

Licencié dans le cadre du MIT, voir Licence pour le texte intégral.