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

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

只有几点补充说明：
1。 这都是真实可运行的代码，请看测试状态: 点击Login as guest
2。 测试使用Machine Specification, 重点是Establish部分。
3。仅仅使用于集成测试（用户故事）；不建议业务领域和单元测试使用。
4。这里只列出最终使用代码（测试说明一切）；避免细节/实现的干扰。实现请看： Examples.cs "一个“语法的实现 ”要“语法实现

 

文章发布后，很多的评论，特作出以下解释：

• 这一段代码的技术重点，首先是行为驱动开发(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;
    }
}