代码契约来自于微软的研究项目TEAM, 理念是”契约式设计”. 过去我们写一些方法, 在每一个方法前面加上说明文字, 告诉调用者这些方法的参数有什么要求. 但是这样做有一个缺点, 就是这样不能使调用者必须遵守调用要求. CLR4.0提供的代码契约机制可以保证调用者遵守这些调用规则, 编译时有编译器进行检查, 运行时有CLR来检查. 它类似于c++的断言机制. 但比c++的更丰富.
所有的代码契约都在 System.Diagnostics.Contracts.CodeContract静态类中定义. 来看几个常用的:
CodeContract.Requires(x>= 0); 明眼人一看就懂, 它受编译开关的影响, 比如你可以只在调试模式下使用此代码契约.
CodeContract.RequiresAlways(x>= 0); 基本和上面这个一样, 唯一区别它不受编译开关的影响,即不管是Debug还是Release模式都要包括这个代码契约.
CodeContract.Ensures(z != null); // 方法体关闭时必须为真 must be true if method closes successfully
CodeContract.EnsuresOnThrow<IOException>(z != null); // 确保发生异常时某些变量的状态 Grantuee some variable status in case of specific exceptions.
对象不变量确保所有公共方法返回时某些条件必须满足. 对象不变量定义在一个单独的方法内, 此方法要有[ContractInvariantMethod]做标注. 方法名无所谓, 但是方法必须返回void, 并且没有参数, 方法体内可以有多个CodeContract.Invariant语句, 如:
[ContractInvariantMethod]
void ObjectInvariant() {
CodeContract.Invariant(someData >= 0);
}