state machine

Jason State

Jason State adalah implementasi mesin negara bagian yang sederhana. Ini dikonfigurasi oleh file JSON.

Platform yang didukung

• .NET Standard 2.1
• .NET Standard 2.0

Fitur

• Ramah Injeksi Ketergantungan (juga dapat digunakan mandiri, lihat di bawah)

Daftar isi

1. Mengapa Jason State?
2. Instalasi
3. Penggunaan
   • File json
   • Implementasi Negara
   • Konteks negara
   • Microsoft.Extensions. Inisialisasi DependencyInjection
4. Lisensi

Mengapa Jason State?

• Tidak perlu khawatir tentang penerapan pola negara. Dengan Jason State, sudah diterapkan!
• Karena Anda menggunakan pola negara, kode Anda lebih bersih.
• Biarkan bisnis perlu diubah! Ini akan memberi Anda fleksibilitas untuk mengubah aliran hanya dengan file JSON yang Anda berikan. Tidak perlu penempatan!
• Mendukung operasi sinkronisasi dan async!

Instalasi

	Kemasan
Jasonstate
Jasonstate.Extension

Perintah berikut dapat digunakan untuk menginstal Jasonstate dan Jasonstate.Extension, jalankan perintah berikut di konsol Paket Manajer

 dotnet add package JasonState
dotnet add package JasonState.Extension

Atau gunakan dotnet cli

 dotnet add package JasonState
dotnet add package JasonState.Extension

Penggunaan

Json

Pertama, Anda perlu memberikan file JSON yang valid. File JSON ini harus berisi array negara . Array ini harus dimiliki objek.

• Namespace : namespace dari negara bagian Anda
• Nama : Hanya nama file negara Anda
• NextState : array berisi objek
  • Kondisi : Kondisi untuk eksekusi negara.
  • Negara : Negara adalah nama negara bagian berikutnya. Tidak perlu memberikan namespace
• ERRORTSTATE : Nama keadaan kesalahan negara Anda. Negara ini akan dieksekusi hanya jika keadaan saat ini memiliki pengecualian yang tidak Anda tangani. Status kesalahan dapat berbeda untuk setiap negara bagian.

Contoh file JSON yang valid dapat ditemukan melalui

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

Implementasi Negara

Negara harus mewarisi dari dan mengimplementasikan metode Execute , atau ExecuteAsync , dengan konteks negara Anda. Anda dapat menggunakan kerangka kerja injeksi ketergantungan apa pun untuk suntikan konstruksi. Itu tidak akan merusak apapun.

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

Konteks negara

Jason State memungkinkan Anda untuk menambahkan objek apa pun ke konteks. Segala sesuatu yang Anda butuhkan selama eksekusi negara harus dalam konteks.

 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. Inisialisasi DependencyInjection

Dengan merujuk jasonstate.extension, daftar dependensi yang diperlukan untuk serviceCollection sebagai berikut

 serviceCollection . AddJasonState < TestStateContext > ( ) ;

atau

 serviceCollection . AddAsyncJasonState < TestStateContext > ( ) ; 

Sampel

TestClient dapat ditemukan
Asynctestclient dapat ditemukan

Lisensi

Lisensi di bawah MIT, lihat lisensi untuk teks lengkap.