ios专题 － OCUnit

OCUnit是集成在Xcode开发环境的单元测试框架；OCUnit运行必须包含SenTestingKit.framework这个库；

针对需要测试的类，每个类写出自己的TestCase，独立组织一个文件。每个测试类都是继承自SenTestCase类，这里有3个重要的方法需要介绍：

1. -(void)setUp: 每个test方法执行前调用，用于类的创建，一些变量的初始化等

2. -(void)tearDown:每个test方法执行后调用

3. -(void)testXXX:这个是真正运行的测试方法，命名就是不带参数，以test开始。

    这里的每个testXXX方法可以在Scheme里面看到，并可以设置是否测试这个方法

    开发者的主要工作是自己实现这些无返回值的testXXX方法，一般框架会提供大量的断言方法，如果还是觉得不够丰富，可以使用第三方的库来进行扩充，比如：OCHamcrest。

OCUnit断言介绍：

1.无条件失败（Unconditional Failure）

STFail
让测试用例失败

STFail(failure_description, ...)
参数
failure_description
    指定你错误消息的格式化字符串，可以为nil
...
    （可选）以逗号隔开的替换到failure_description的参数列表

2.相等测试（Equality Tests）

STAssertEqualObjects

当两个对象不同时，测试失败
STAssertEqualObjects(object_1, object_2, failure_description, ...)
参数
object_1
    一个对象
object_2
    一个对象

failure_description
    指定你错误消息的格式化字符串，可以为nil
...
    （可选）以逗号隔开的替换到failure_description的参数列表

说明：当 [object_1 isEqualTo:object_2] 为false时，测试失败


STAssertEquals

当两个值不等的时候测试失败。
STAssertEquals(value_1, value_2, failure_description, ...)

参数
value_1
                一个数值，结构体，或联合体。
value_2
                一个数值，结构体，或联合体。
failure_description
                指定你错误消息的格式化字符串，可以为nil
...
                （可选）以逗号隔开的替换到failure_description的参数列表
                
说明：当value_1 不等于value_2的时候测试失败。



STAssertEqualsWithAccuracy

当两个值的差别大于给定值时，测试失败
STAssertEqualsWithAccuracy(value_1, value_2, accuracy, failure_description, ...)

参数
value_1
                一个整型或浮点值。
value_2
                一个整型或浮点值。
accuracy
                一个整型或浮点值。
failure_description
                指定你错误消息的格式化字符串，可以为nil
...
                （可选）以逗号隔开的替换到failure_description的参数列表
说明：当value_1和value_2之间相差大于accuracy时，测试失败。

 

3.空值测试（Nil Tests）

STAssertNil

Fails the test case when a given expression is not nil.
如果给定的表达式不是nil，测试失败。
STAssertNil(expression, failure_description, ...)

参数
expression
                要测试的表达式。
failure_description
    指定你错误消息的格式化字符串，可以为nil
...
    （可选）以逗号隔开的替换到failure_description的参数列表



STAssertNotNil

Fails the test case when a given expression is nil.
当表达式为nil时，测试失败。
STAssertNotNil(expression, failure_description, ...)

参数
expression
                要测试的表达式。
failure_description
    指定你错误消息的格式化字符串，可以为nil
...
    （可选）以逗号隔开的替换到failure_description的参数列表

 

4.布尔测试（Boolean Tests）


STAssertTrue

如果给定表达式为false，测试失败。
STAssertTrue(expression, failure_description, ...)


参数
expression
                要测试的表达式。
failure_description
    指定你错误消息的格式化字符串，可以为nil
...
    （可选）以逗号隔开的替换到failure_description的参数列表


STAssertFalse

如果给定表达式为true，测试失败。
STAssertFalse(expression, failure_description, ...)

参数
expression
                要测试的表达式。
failure_description
    指定你错误消息的格式化字符串，可以为nil
...
    （可选）以逗号隔开的替换到failure_description的参数列表

 

5.异常测试（Exception Tests）


STAssertThrows

当表达式不抛异常时，测试失败
STAssertThrows(expression, failure_description, ...)

参数
expression
                要测试的表达式。
failure_description
    指定你错误消息的格式化字符串，可以为nil
...
    （可选）以逗号隔开的替换到failure_description的参数列表


STAssertThrowsSpecific

当表达式不能抛出特定类的异常时，测试失败。
STAssertThrowsSpecific(expression, exception_class, failure_description, ...)

参数
expression
                要测试的表达式。
exception_class
    异常类
failure_description
    指定你错误消息的格式化字符串，可以为nil
...
    （可选）以逗号隔开的替换到failure_description的参数列表

说明：当expression不会抛出exception_class的异常时，测试失败。


STAssertThrowsSpecificNamed

当表达式不能抛出特定类指定名称的异常时，测试失败。
STAssertThrowsSpecificNamed(expression, exception_class, exception_name, failure_description, ...)

参数
expression
                要测试的表达式。
exception_class
    异常类
exception_name
    异常名字的字符串
failure_description
    指定你错误消息的格式化字符串，可以为nil
...
    （可选）以逗号隔开的替换到failure_description的参数列表

说明：当expression不能抛出exception_class类中的名为exception_name的异常时，测试失败。


STAssertNoThrow

如果表达式抛异常，测试失败。
STAssertNoThrow(expression, failure_description, ...)

参数
expression
    要测试的表达式。
failure_description
    指定你错误消息的格式化字符串，可以为nil
...
    （可选）以逗号隔开的替换到failure_description的参数列表


STAssertNoThrowSpecific

当表达式抛出特定类的异常时，测试失败。
STAssertNoThrowSpecific(expression, exception_class, failure_description, ...)

参数
expression
                要测试的表达式。
exception_class
    异常类
failure_description
    指定你错误消息的格式化字符串，可以为nil
...
    （可选）以逗号隔开的替换到failure_description的参数列表

说明：当expression抛出exception_class的异常时，测试失败。


STAssertNoThrowSpecificNamed

当表达式抛出特定类指定名称的异常时，测试失败。
STAssertNoThrowSpecificNamed(expression, exception_class, exception_name, failure_description, ...)

参数
expression
                要测试的表达式。
exception_class
    异常类
exception_name
    异常名字的字符串
failure_description
    指定你错误消息的格式化字符串，可以为nil
...
    （可选）以逗号隔开的替换到failure_description的参数列表

说明：当expression抛出exception_class类中的名为exception_name的异常时，测试失败。


STAssertTrueNoThrow

当表达式为false或者抛异常时，测试失败。
STAssertTrueNoThrow(expression, failure_description, ...)

参数
expression
    要测试的表达式。
failure_description
    指定你错误消息的格式化字符串，可以为nil
...
    （可选）以逗号隔开的替换到failure_description的参数列表


STAssertFalseNoThrow

当表达式为true或者抛异常时，测试失败。
STAssertFalseNoThrow(expression, failure_description, ...)

参数
expression
    要测试的表达式。
failure_description
    指定你错误消息的格式化字符串，可以为nil