Stateless 3.0——.NET Core上的狀態機庫

Stateless是一個基於C#，建立狀態機的簡單庫，最新版本支持.NET Core 1.0。其實現方式並非經過.NET Core，而是經過寫入.NET Standard實現的。就像Android平臺上API級別抽象出許多底層版本的Android，.NET Standard是一組全部.NET平臺上都必須實現的API。

更令開發者高興的是，Stateless 3.0基於.NET Standard 1.0編寫，是一個被普遍使用和最具兼容性的標準版本，幾乎能夠運行在任何地方，從Windows平臺上的.NET Framework、.NET Core到Mac，和Windows應用商店以及全部的移動平臺。

特徵：

支持大多數標準狀態機構造：

• 支持任何.NET類型（數字、字符串、枚舉等）狀態和觸發器；

• 分層狀態；

• 狀態的進入/退出事件；

• Guard子句以支持條件轉換；

• 內省。

與此同時，還提供一些有用的擴展：

• 支持外部的狀態存儲（例如：由ORM跟蹤屬性）；

• 參數化觸發器；

• 可重入狀態；

• 支持DOT格式圖導出。

使用Stateless建立一個簡單的狀態機

下面來看幾個代碼示例。先描述一些有限狀態，例如一個枚舉類型和一些用於改變狀態的有限「觸發器」，就像開發同樣，來啓動和關閉狀態以及進行觸發器切換。

另外一個更加實用的例子是Bug Tracker，源碼在GitHub上。下面是一個Bug和觸發器狀態，引發狀態改變：

enum State { Open, Assigned, Deferred, Resolved, Closed }enum Trigger { Assign, Defer, Resolve, Close }

下面進行狀態初始化，定義StateMachine，若是你願意，能夠在狀態觸發時傳遞參數。例如，若是你使用Assign觸發Bug，能夠傳入「Scott」，這樣該Bug就會進入Assigned狀態——分配給Scott。

State _state = State.Open;
StateMachine<State, Trigger> _machine;
StateMachine<State, Trigger>.TriggerWithParameters<string> _assignTrigger;string _title;string _assignee;

在這個例子中，Bug構造函數使用一個流暢接口的狀態機，該接口讀得至關不錯。

public Bug(string title)
{
    _title = title;

    _machine = new StateMachine<State, Trigger>(() => _state, s => _state = s);    _assignTrigger = _machine.SetTriggerParameters<string>(Trigger.Assign);    _machine.Configure(State.Open)        .Permit(Trigger.Assign, State.Assigned);  
  _machine.Configure(State.Assigned)        .SubstateOf(State.Open)        .OnEntryFrom(_assignTrigger, assignee => OnAssigned(assignee))        .PermitReentry(Trigger.Assign)        .Permit(Trigger.Close, State.Closed)        .Permit(Trigger.Defer, State.Deferred)        .OnExit(() => OnDeassigned());   
   _machine.Configure(State.Deferred)        .OnEntry(() => _assignee = null)        .Permit(Trigger.Assign, State.Assigned); }

例如，當狀態打開時，能夠進行分配，可是，因爲它是被寫入的（你能夠改變），因此你沒法關閉一個處於開放狀態而且沒有分配的Bug。

當Bug被分配時，你能夠關閉，延遲或從新分配。這是PermitReentry()。另外，注意一下，Assigned是一個子狀態。

你能夠有狀態地改變觸發事件，這些事件能夠根據您的我的設置採起行動。

void OnAssigned(string assignee)
{    if (_assignee != null && assignee != _assignee)
        SendEmailToAssignee("Don't forget to help the new employee.");

    _assignee = assignee;
    SendEmailToAssignee("You own it.");
}void OnDeassigned()
{
    SendEmailToAssignee("You're off the hook.");
}void SendEmailToAssignee(string message)
{
    Console.WriteLine("{0}, RE {1}: {2}", _assignee, _title, message);
}

擁有一個好的狀態機庫，例如Stateless，可讓你快速地模擬狀態。可否分享一下，你在項目中使用的狀態機是什麼樣子的？

原文地址： http://www.hanselman.com/blog/Stateless30AStateMachineLibraryForNETCore.aspx

   
   
   
    
    
             
    

   
.NET社區新聞，深度好文，微信中搜索dotNET跨平臺或掃描二維碼關注

本文分享自微信公衆號 - dotNET跨平臺（opendotnet）。
若有侵權，請聯繫 support@oschina.cn 刪除。
本文參與「OSC源創計劃」，歡迎正在閱讀的你也加入，一塊兒分享。