这也是C#代码吗 --- 代码阅读性进阶:测试文档化

原创
2012/12/25 12:44
阅读数 263

没有太多的罗嗦,代码本身已经足够。如果,要添几个标签的话就是: 中文化,流畅性接口(Fluent Interface),API.

只有几点补充说明:

  • 这都是真实可运行的代码
  • 测试使用Machine Specification, 重点是Establish部分。
  • 仅仅使用于集成测试(用户故事);不建议业务领域和单元测试使用
  • 这一段代码的技术重点,首先是行为驱动开发(BDD), 偏重于需求描述(测试用例),而轻编程能力。
  • 第二个技术点,流畅型接口, 对内是功能封装,对外是使用接口(API). 用Facade模式来看待,会更好理解。如果在功能实现内部使用Facade当然会头痛
  • 最后,才是使用中文。即使,不用中文,前两点也会很有用
  • 我是实践派,不是学院派。这是我实际项目的真实代码,不是为了装酷。

得心应手武器库:

  • MSpec

 本文所涉及使用的工具, 见前文:我的.Net武器库 ------ 新.Net架构必备工具列表

 使用的视屏演示:

 

using System.Linq;
 using Machine.Specifications;
 using Skight.Arch.Domain;
 using Skight.Arch.Domain.Core.Containers;
 using Skight.Arch.Domain.Extensions;
 using Skight.Arch.UserStories.Helpers;
 using Skight.ES.Register.Presentation;
 using Skight.ES.Register.Presentation.Modal;
 using Skight.ES.Register.Presentation.Web.Application;
 using Skight.ES.Register.Presentation.Web.ExamDistrictAdmin;
 using Skight.ES.Register.Services;
 using Skight.ES.Register.UserStories.Helpers;
 
 namespace Skight.ES.Register.UserStories.作为.考区组考人.我想查看考试从而可以了解考试信息
 {
     [Subject("考试"), Tags("集成测试", "用户故事")]
     public class 当浏览某考试界面 : CommandTestBase
     {       
         private Establish that =
             () =>
             {
                 要.创建(示例.考区.省直);
 
                 要.创建(示例.考试定义.计算机)
                     .添加科目(示例.科目.AutoCAD)
                     .添加科目(示例.科目.Windows2000)
                     .添加科目(示例.科目.WindowsExcel);
 
                 要.创建(示例.考试.省直2012年1月计算机考试)
                     .设为电子化考试()
                     .设置考试起始时间(Date.Of(2012,1,1),Date.Of(2012,2,1))
                     .设置审核()
                     .设置考场容量(50)
                     .设置科目费用(Money.of(100))
                     .添加科目(示例.科目.AutoCAD)
                     .添加科目(示例.科目.Windows2000)
                     .添加科目(示例.科目.WindowsExcel)
                     .添加个人信息定义(示例.个人信息定义.姓名)
                     .添加个人信息定义(示例.个人信息定义.性别)
                     .添加个人信息定义(示例.个人信息定义.身份证)
                     .添加考场(示例.考场信息定义.考场01)
                     .添加考场(示例.考场信息定义.考场02)
                     .添加考场(示例.考场信息定义.考场03); ;
 
                 var exam_service = Container.get<ExamService>();
                 subject = new ExamDetailGet(exam_service);
                 ui.load_context_data(Keys.Context.ExamDate.with_value(示例.考试.省直2012年1月计算机考试));
             };
 
         private Because of =
             () =>
             {
                 subject.process(ui);
                 result = ui.get_model<ExamDetailDTO>(Views.DisplayExamDetail);
             };
 
         private It 应该显示考试科目列表 =
             () => result.Subjects.Select(s=>s.Code)
                       .ShouldContainOnly(示例.科目.AutoCAD.Code, 示例.科目.Windows2000.Code, 示例.科目.WindowsExcel.Code);
 
         private It 应该显示考试开始日期 =
             () => result.BeginDate.ShouldEqual(Date.Of(2012, 1, 1));
         private It 应该显示考试结束日期 =
             () => result.EndDate.ShouldEqual(Date.Of(2012, 2, 1));
 
         private It 应该显示是否电子化考试 =
             () => result.IsElectronicExam.ShouldBeTrue();
         private It 应该显示是考试考场容量 =
             () => result.ExaminationRoomCapacity.ShouldEqual(50);
 
         private It 应该显示是否考试报名需要审核 =
             () => result.NeedInspection.ShouldBeTrue();
         private It 应该显示考试默认科目费用 =
             () => result.DefaultCharge.ShouldEqual(Money.of(100));
 
         private It 应该显示报考人员信息项目 =
             () => result.PersonalInfoDefs.ShouldContainOnly(示例.个人信息定义.姓名, 示例.个人信息定义.身份证, 示例.个人信息定义.性别);
 
         private It 应该显示考试相关考场信息 =
             () => result.Scenes.ShouldContainOnly(示例.考场信息定义.考场01, 示例.考场信息定义.考场02, 示例.考场信息定义.考场03);
 
         private static ExamDetailGet subject;
         private static ExamDetailDTO result;
     }
 }
展开阅读全文
打赏
0
3 收藏
分享
加载中
更多评论
打赏
0 评论
3 收藏
0
分享
返回顶部
顶部