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

 

 

posted @ 2013-12-08 17:08  路途遥远  阅读(969)  评论(0编辑  收藏  举报