state machine

Штат Джейсон

Jason State - это простая реализация штата. Он настроен файлом JSON.

Поддерживаемые платформы

• .NET Стандарт 2.1
• .NET Стандарт 2.0

Функции

• Подключение к зависимости (также может быть использован отдельно, см. Ниже)

Оглавление

1. Почему штат Джейсон?
2. Установка
3. Использование
   • Файл json
   • Государственная реализация
   • Государственный контекст
   • Microsoft.extensions.EpectendencyInction инициализация
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 : массив содержит объекты
  • Условие : условие для выполнения штатов.
  • Государство : Государство является названием следующего штата. Не нужно предоставлять пространство имен
• ErryState : имя состояния ошибки вашего состояния. Это состояние будет выполнено только в том случае, если у текущего состояния есть исключение, с которым вы не обращаетесь. Состояние ошибки может отличаться для каждого состояния.

Пример действительного файла 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 или ExecuteAsync , метод с контекстом вашего состояния. Вы можете использовать любую структуру впрыска зависимостей для инъекций строительства. Это ничего не сломает.

 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.EpectendencyInction инициализация

Ссылаясь на jasonstate.extension, зарегистрируйте необходимые зависимости от ServiceCollection следующим образом

 serviceCollection . AddJasonState < TestStateContext > ( ) ;

или

 serviceCollection . AddAsyncJasonState < TestStateContext > ( ) ; 

Образцы

TestClient можно найти
AsynctestClient можно найти

Лицензия

Лицензировано в соответствии с MIT, см. Лицензию на полный текст.