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/
本文版权归作者和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。