state machine

Estado de Jason

Jason State es una simple implementación de la máquina de estado. Está configurado por un archivo JSON.

Plataformas compatibles

• .NET Standard 2.1
• .NET Standard 2.0

Características

• Inyección de dependencia amigable (también se puede usar independiente, ver más abajo)

Tabla de contenido

1. ¿Por qué Jason State?
2. Instalación
3. Uso
   • Archivo json
   • Implementación estatal
   • Contexto estatal
   • Microsoft.extensions.dependencyInyection Inicialización
4. Licencia

¿Por qué Jason State?

• No es necesario preocuparse por implementar el patrón de estado. ¡Con Jason State, ya está implementado!
• Debido a que usa el patrón de estado, su código es más limpio.
• ¡Que el negocio necesite cambiar! Le dará la flexibilidad para cambiar el flujo solo por el archivo JSON que proporciona. ¡No hay necesidad de implementación!
• ¡Admite operaciones de sincronización y asíncrono!

Instalación

	Paquete
Jasonstate
Jasonstate.extension

Los siguientes comandos se pueden usar para instalar jasonstate y jasonstate.extension, ejecute el siguiente comando en la consola del administrador de paquetes

 dotnet add package JasonState
dotnet add package JasonState.Extension

O use dotnet cli

 dotnet add package JasonState
dotnet add package JasonState.Extension

Uso

Json

Primero debe proporcionar un archivo JSON válido. Este archivo JSON debe contener una matriz de Estados . Esta matriz debería tener objetos.

• Espacio de nombres : espacio de nombres de su estado
• Nombre : Solo el nombre de su archivo estatal
• NextState : la matriz contiene objetos
  • Condición : La condición para la ejecución de los estados.
  • Estado : el estado es el nombre del próximo estado. No hay necesidad de proporcionar espacio de nombres
• ErrorState : nombre del estado de error de su estado. Este estado se ejecutará solo si el estado actual tiene una excepción que no maneja. El estado de error puede ser diferente para cada estado.

Se puede encontrar un ejemplo de un archivo JSON válido a través de

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

Implementación estatal

Los estados deben heredar de e implementar el método Ejecute o ExecuteAsync con su contexto de estado. Puede usar cualquier marco de inyección de dependencia para inyecciones de construcción. No romperá nada.

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

Contexto estatal

Jason State le permite agregar cualquier tipo de objeto al contexto. Todo lo que necesita durante la ejecución estatal debe estar en el 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.dependencyInyection Inicialización

Al hacer referencia a JasonState.Extension, registre las dependencias necesarias a ServiceCollection de la siguiente manera

 serviceCollection . AddJasonState < TestStateContext > ( ) ;

o

 serviceCollection . AddAsyncJasonState < TestStateContext > ( ) ; 

Muestras

TestClient se puede encontrar
AsynctestClient se puede encontrar

Licencia

Licenciado bajo MIT, vea la licencia para el texto completo.