Visual Studio DSL 入門 11—為狀態機器設計器添加規則

   上一節我們在設計器的顯示方面進行了完善,在這一節,我們將深入狀態機器設計器的一些邏輯細節,給我們的設計器添加邏輯規則.為產生代碼做好準備.
   在開始之前,我們先看一下Transition的幾個屬性之間的關係: 
     1.編輯Event,Condition,Action屬性時,Label屬效能夠自動計算顯示,計算邏輯為Event [Condition] / Action 
     2.當修改屬性Label時,Event,Condition,Action的值也能夠對應自動更新.  
   我們使用Vs.net Dsl的規則來實現:
     1.在Dsl項目下新增CustomCode檔案夾來存放我們的自訂的代碼,這是Dsl開發中的通用做法,Dsl再強大也不可能不一點代碼不用寫就能夠使滿足需求,一般情況下,無論是在開發Dsl還是在使用Dsl時,都需要結合產生的程式碼和自訂代碼.在CustomCode檔案夾下面建立檔案夾Validation，用於存放手寫的自訂驗證類.
     2.在Validation檔案夾下面添加類TransitionLabelRule.
     3.修改TransitionLabelRule繼承於ChangeRule,並使用RuleOn屬性標籤標識此規則應用到域關係Transition上面.

隱藏行號 複製代碼 ？

1. using Microsoft.VisualStudio.Modeling;

3. namespace Company.LanguageSm

4. {

5.     [RuleOn(typeof(Transition))]

6.     public sealed class TransitionLabelRule : ChangeRule

7.     {

8.     }

9. }

       4.在規則類裡面,我們需要實現ChangeRule唯一的一個方法ElementPropertyChanged(ElementPropertyChangedEventArgs e),從這個方法我們可以看出,當Transition的一些屬性發生變化時就會觸發這個規則,參數類型ElementPropertyChangedEventArgs,這個參數包含當前的模型元素ModelElement,編輯的屬性DomainProperty,原值OldValue,新值NewValue,我們只需要判斷當前的屬性,如果是以上的Event,Condition,Action,Lable時,修改後就計算其餘的屬性.
   

隱藏行號 複製代碼 ？

1. public override void ElementPropertyChanged(ElementPropertyChangedEventArgs e)

2.         {

3.             Transition t = e.ModelElement as Transition;

5.             // Compute Label when Event changes

6.             if (e.DomainProperty.Id == Transition.EventDomainPropertyId)

7.                 t.Label = ComputeSummary(e.NewValue as string, t.Condition, t.Action);

9.             // Compute Label when Condition changes

10.             else if (e.DomainProperty.Id == Transition.ConditionDomainPropertyId)

11.                 t.Label = ComputeSummary(t.Event, e.NewValue as string, t.Action);

13.             // Compute Label when Action changes

14.             else if (e.DomainProperty.Id == Transition.ActionDomainPropertyId)

15.                 t.Label = ComputeSummary(t.Event, t.Condition, e.NewValue as string);

17.             // Compute Event, Condition, Action when Label changes

18.             else if (e.DomainProperty.Id == Transition.LabelDomainPropertyId)

19.                 ComputeProperties(e.NewValue as string, t);

21.         }

   ComputeSummary是我們的輔助方法,通過Event,Condition,Action三個值來計算Lable的值,ComputeProperties方法是由Lable的值來分別匹配出另外三個屬性的值.最後可以直接對域類的屬性進入賦值. 這兩個輔助方法就不在這裡列出來了,在下載代碼裡可以看到.(在這裡其實是預設提交,整個規則事件就在一個事務中).
        5.重新運行項目,會發現,寫的規則沒有起作用,修改Transition的屬性時,也沒有跳到TransitionLabelRule的斷點裡面來,這是怎麼回事呢?這其實是和Vs.net dsl 的規則機制有關,我們還需要對這個Rule進行一下註冊, 在CustomCode下面添加LanguageSmDomainModel(GeneratedCode下面的DomainModel.tt產生的類)的一個partial類,在這裡類的GetCustomDomainModelTypes方法裡,添加我們的自訂的Rule的集合,這樣 vs.net在載入時,就會自動載入這個Rule,並添加到Rule集合中.
   

隱藏行號 複製代碼 ？

1. namespace Company.LanguageSm

2. {

3.     public partial class LanguageSmDomainModel

4.     {

5.         protected override Type[] GetCustomDomainModelTypes()

6.         {

7.             return new Type[]{typeof(TransitionLabelRule),};

8.         }

9.     }

10. }

       6.產生轉換所有模板,我們來測試一下我們的規則:
 

代碼下載

 

參考資源
      1. Visual Stuido DSL 工具特定領域開發指南
      2. DSL Tools Lab     http://code.msdn.microsoft.com/DSLToolsLab  系列教程  [本系列的入門案例的主要參考]

作者：孤獨俠客（似水流年）
出處：http://lonely7345.cnblogs.com/
本文著作權歸作者和部落格園共有，歡迎轉載，但未經作者同意必須保留此段聲明，且在文章頁面明顯位置給出原文串連，否則保留追究法律責任的權利。