zoukankan      html  css  js  c++  java
  • Typora

    Typora

    OCMock 3 参考1.创建Mock对象1.1 类Mock1.2 协议Mock1.3 严格的类和协议Mock1.4 部分Mock1.5 观察者Mock2 置换方法2.1 置换方法(待置换的方法返回objects)2.2 置换方法(待置换的方法返回values)2.3 委托到另一个方法(置换委托方法到另外一个方法)2.4 置换一个blcok方法.2.5 置换方法的参数2.6 调用某个方法就抛出异常2.7 调用某个方法就发送通知2.8 链式调用2.9 转发的原来的对象/类2.10 什么也不做3 验证作用3.1 运行后就验证3.2 置换后验证4 参数约束4.1 任意参数约束4.2 忽略非对象的参数4.3 匹配参数4.4 使用Hamcrest来匹配5 类方法的Mock5.1 置换类方法5.2 验证类方法的调用5.3 有歧义的类方法和实例方法5.4 恢复类6 部分Mock6.1 置换方法6.2 验证方法调用6.3 恢复对象7 严格mock和期望7.1 Expect-run-verify 期望-运行-验证7.2 严格的mock 和快速失败7.3 置换操作和预期7.4 延时验证7.5 依序验证8 观察者mock8.1 准备工作8.2 验证9 进阶话题9.1 对于普通的mock,快速失败9.2 在OCMVerifyAll时重新抛出异常9.3 置换创建对象的方法9.4 基于实例对象的方法替换10 使用限制10.1 在一个指定的类上,只能有一个mock对象10.2 在被置换的方法上设置期望,会不起作用10.3 Partial mock 不能在某些特定的类使用10.4 某些特定的类不能被置换和验证10.5 NSString的类方法不能被置换和验证10.6 NSObject 的方法不能被验证10.7 apple 的私有方法不能被验证10.8 Verify-after-running不能使用延时

    OCMock 3 参考

    1.创建Mock对象

    1.1 类Mock

    id classMock = OCMClassMock([SomeClass class]);

    1.2 协议Mock

     
     
    id protocolMock = OCMProtocolMock(@protocol(SomeProtocol));

    1.3 严格的类和协议Mock

    默认的mock方式是nice(方法调用的时候返回nil或者是返回正确的方法)

    严格的模式下,mock的对象在调用没有被stub(置换)的方法的时候,会抛出异常.

     
    id classMock = OCMStrictClassMock([SomeClass class]);id protocolMock = OCMStrictProtocolMock(@protocol(SomeProtocol));

    1.4 部分Mock

    id partialMock = OCMPartialMock(anObject)

    这样创建的对象在调用方法时:

    • 如果方法被stub,调用stub后的方法.
    • 如果方法没有被stub,调用原来的对象的方法.

    partialMock 对象在调用方法后,可以用于稍后的验证此方法的调用情况(被调用,调用结果)

    1.5 观察者Mock

    id observerMock = OCMObserverMock();

    这样创建的对象可以用于观察/通知.

    2 置换方法

    2.1 置换方法(待置换的方法返回objects)

    OCMStub([mock someMethod]).andReturn(anObject);

    在mock对象上调用某个方法的时候,这个方法一定返回一个anObject.(也就是说强制替换了某个方法的返回值为anObject)

    2.2 置换方法(待置换的方法返回values)

    OCMStub([mock aMethodReturningABoolean]).andReturn(YES);

    在mock对象上调用某个方法的时候,这个方法一定返回values.

    注意这里的原始值类型一定要和原来的方法的返回值一致.

    2.3 委托到另一个方法(置换委托方法到另外一个方法)

    OCMStub([mock someMethod]).andCall(anotherObject, @selector(aDifferentMethod));

    置换mock 对象的someMethod ==> anotherObject 的aDifferentMethod.

    这样,当mock对象调用someMethod方法的时候,实际上的操作就是anotherObject 调用了aDifferentMethod方法.

    2.4 置换一个blcok方法.

    OCMStub([mock someMethod]).andDo(^(NSInvocation *invocation) { /* block that handles the method invocation */ });

    在mock对象调用someMethod的时候,andDo后面的block会调用.block可以从NSInvocation中得到一些参数,然后使用这个NSInvocation对象来构造返回值等等.

    2.5 置换方法的参数

    OCMStub([mock someMethodWithReferenceArgument:[OCMArg setTo:anObject]]);

    OCMStub([mock someMethodWithReferenceArgument:[OCMArg setToValue:OCMOCK_VALUE((int){aValue})]]);

    mock对象在调用某个带参数的方法的时候,这个方法的参数可以被置换.

    setTo用来设置对象参数,setToValue用来设置原始值类型的参数.

    2.6 调用某个方法就抛出异常

    OCMStub([mock someMethod]).andThrow(anException);

    当mock对象调用someMethod的时候,就会抛出异常

    2.7 调用某个方法就发送通知

    OCMStub([mock someMethod]).andPost(aNotification);

    当mock对象调用someMethod的时候,就会发送通知.

    2.8 链式调用

    OCMStub([mock someMethod]).andPost(aNotification).andReturn(aValue);

    所有的actions(比如andReturn,andPost)可以链式调用.上面的例子中,mock对象调用someMethod方法后,发送通知,返回aValue

    2.9 转发的原来的对象/类

    OCMStub([mock someMethod]).andForwardToRealObject();

    使用部分mock的时候,使用类方法的可以转发到原来的对象/原来的类.

    这个功能在链式调用或者是使用expectation的时候很有用.

    2.10 什么也不做

    OCMStub([mock someMethod]).andDo(nil);

    可以给andDo传入nil参数,而不是原来一个block作为参数.

    这个功能在使用部分mock/mock类的时候很有用,可以屏蔽原来的行为.

    3 验证作用

    3.1 运行后就验证

     
    id mock = OCMClassMock([SomeClass class]);
    /* run code under test */
    OCMVerify([mock someMethod]);

    在mock对象调用someMethod后就开始验证.(如果这个方法没有被调用),就抛出一个错误.

    在验证语句中可以使用 参数约束.

    3.2 置换后验证

     
    id mock = OCMClassMock([SomeClass class]);
    OCMStub([mock someMethod]).andReturn(myValue);
    /* run code under test */
    OCMVerify([mock someMethod]);

    在置换某个方法(置换了返回的参数)后,然后可以验证这个方法是否被调用.

    4 参数约束

    4.1 任意参数约束

     
    OCMStub([mock someMethodWithAnArgument:[OCMArg any]])
    OCMStub([mock someMethodWithPointerArgument:[OCMArg anyPointer]])
    OCMStub([mock someMethodWithSelectorArgument:[OCMArg anySelector]])

    不管传递什么参数,对于所有活跃的invocations,置换该方法.Pointers 和selectors 需要像上面一样特殊对待.对于既不是对象,也不是指针,更不是SEL类型的,不可以忽略的参数,可以使用 any 来代替.

    4.2 忽略非对象的参数

    [[[mock stub] ignoringNonObjectArgs] someMethodWithIntArgument:0]

    在这个invocation中,mock忽略所有的非对象参数.mock对象将会接收所有的someMethodWithIntArgument 方法 invocation,而不去管实际传递进来的参数是什么.如果这个方法含有对象参数和非对象参数,对象参数仍然可以使用OCMArg的参数约束.

    4.3 匹配参数

     
    OCMStub([mock someMethod:aValue)
    OCMStub([mock someMethod:[OCMArg isNil]])
    OCMStub([mock someMethod:[OCMArg isNotNil]])
    OCMStub([mock someMethod:[OCMArg isNotEqual:aValue]])
    OCMStub([mock someMethod:[OCMArg isKindOfClass:[SomeClass class]]])
    OCMStub([mock someMethod:[OCMArg checkWithSelector:aSelector onObject:anObject]])
    OCMStub([mock someMethod:[OCMArg checkWithBlock:^BOOL(id value) { /* return YES if value is ok */ }]])

    如果在置换创建的时候,有个一个参数传递进来了,置换方法将仅仅匹配精确参数的invocations.带不同的参数来调用的方法不会被匹配.

    OCMArg类提供了几个不同的方法来匹配不同的参数类型.

    对于checkWithSelector:onObject:方法, 当mock对象接收到someMethod:的时候, 会触发 anObject上的aSelector方法. 如果方法带参数,这个参数会传递给someMethod:. 这个方法应该返回一个BOOL值,表示这个参数是否和预期的一样.

    4.4 使用Hamcrest来匹配

    OCMStub([mock someMethod:startsWith(@"foo")]

    OCMock不带 Hamcrest 框架,所以如果想要使用的话,需要自己安装Hamcrest .

    5 类方法的Mock

    5.1 置换类方法

     
     
    id classMock = OCMClassMock([SomeClass class]);
    OCMStub([classMock aClassMethod]).andReturn(@"Test string");
    // result is @"Test string"
    NSString *result = [SomeClass aClassMethod];

    置换类方法和置换实例方法的步骤相像.但是mock对象在深层次上对原有 类做了些更改.(替换了原有的的类的meta class).这让置换调用直接作用在mock对象上,而不是原有的类.

    注意:

    添加到类方法上的mock对象跨越了多个测试,mock的类对象在置换后不会deallocated,需要手动来取消这个mock关系.

    如果mock对象作用于同一个类, 这时的行为就不预测了.

    5.2 验证类方法的调用

     
    id classMock = OCMClassMock([SomeClass class]);
    /* run code under test */
    OCMVerify([classMock aClassMethod]);

    验证类方法的调用和验证实例方法的调用的使用方式一样.

    5.3 有歧义的类方法和实例方法

     
     
    id classMock = OCMClassMock([SomeClass class]);
    OCMStub(ClassMethod([classMock ambiguousMethod])).andReturn(@"Test string");
    // result is @"Test string"
    NSString *result = [SomeClass ambiguousMethod];

    置换了类方法,但是类有一个和类方法同名的实例方法,置换类方法的时候,必须使用ClassMethod()

    5.4 恢复类

     
    id classMock = OCMClassMock([SomeClass class]);
    /* do stuff */
    [classMock stopMocking];

    置换类方法后,可以将类恢复到原来的状态,通过调用stopMocking来完成.

    如果在结束测试前,需要恢复到原来的状态的话,这就很有用了.

    在mock对象被释放的时候,stopMocking会自动调用.

    当类恢复到原来的对象,类对象的meta class会变为原来的meta class.这会移除所有的方法置换.

    在调用了stopMocking之后,不应该继续使用mock对象.

    6 部分Mock

    6.1 置换方法

     
    id partialMock = OCMPartialMock(anObject);
    OCMStub([partialMock someMethod]).andReturn(@"Test string");
    // result1 is @"Test string"
    NSString *result1 = [partialMock someMethod];
    // result2 is @"Test string", too!
    NSString *result2 = [anObject someMethod];

    部分Mock修改了原有的mock对象的类.(实际上是继承了待mock对象,然后替换用 继承的类来代替原有的类).

    这就是说: 使用真实的对象来调用,即使是使用self,也会影响 置换方法和预期的结果.

    6.2 验证方法调用

     
     
    id partialMock = OCMPartialMock(anObject);
    /* run code under test */
    OCMVerify([partialMock someMethod]);

    验证方法的调用和验证类方法,验证协议的调用类似.

    6.3 恢复对象

     
     
    id partialMock = OCMPartialMock(anObject);
    /* do stuff */
    [partialMock stopMocking];

    真正的对象可以通过调用stopMocking方法来恢复到原来的状态.

    这种情况只有在结束测试之前需要恢复到原来状态.

    部分mock对象会在释放的时候,会自动调用 stopMocking方法.

    当对象转变为原来的状态后,类会变为原来的类.也会移除所有的置换方法.

    在调用了stopMocking之后,最好不要去使用mock对象.

    7 严格mock和期望

    7.1 Expect-run-verify 期望-运行-验证

     
     
    id classMock = OCMClassMock([SomeClass class]);
    OCMExpect([classMock someMethodWithArgument:[OCMArg isNotNil]]);
    /* run code under test, which is assumed to call someMethod */
    OCMVerifyAll(classMock)

    这是使用mock最原始的方法:

    1. 创建mock对象
    2. 期望调用某个方法
    3. 测试代码(预想的是这段测试代码会调用上面期望调用的方法.
    4. 验证mock对象(也就是验证期望的方法是否被调用了)

    如果预期的方法没有被调用,或者调用的时候,传递的参数不对,那么就好产生错误.可以使用上面 参数约束.

    严格的mock可以用在类和协议上.

    如果有怀疑的话,可以使用 3 验证作用

    7.2 严格的mock 和快速失败

     
    id classMock = OCMStrictClassMock([SomeClass class]);
    [classMock someMethod]; // this will throw an exception

    上面mock没有设置任何期望,直接掉调用某个方法会抛出异常.

    当超出去预期的调用的时候,会立即测试失败. 只有strict mock才会快速失败.

    7.3 置换操作和预期

     
    x
     
    id classMock = OCMStrictClassMock([SomeClass class]);
    OCMExpect([classMock someMethod]).andReturn(@"a string for testing");
    /* run code under test, which is assumed to call someMethod */
    OCMVerifyAll(classMock)

    可以使用andReturn,andThrow,等预期的操作.如果方法被调用,会调用置换 方法,确认方法确实被调用了.

    7.4 延时验证

     
    xxxxxxxxxx
    id mock = OCMStrictClassMock([SomeClass class]);
    OCMExpect([mock someMethod]);
    /* run code under test, which is assumed to call someMethod eventually */
    OCMVerifyAllWithDelay(mock, aDelay);

    在某种情况下,预期的方法只有在 run loop 出于活跃状态的时候才会被调用.这时,可以将认证延时一会.aDelay是mock对象会等待的最大时间.通常情况下,在预期达到后就会返回.

    7.5 依序验证

     
     
    id mock = OCMStrictClassMock([SomeClass class]);
    [mock setExpectationOrderMatters:YES];
    OCMExpect([mock someMethod]);
    OCMExpect([mock anotherMethod]);
    // calling anotherMethod before someMethod will cause an exception to be thrown
    [mock anotherMethod];

    mock会按照在预期中设置好的顺序来判断.只要调用的不是按照期望的调用顺序,这个时候就会抛出异常.

    8 观察者mock

    8.1 准备工作

     
    x
     
    id observerMock = OCMObserverMock();
    [notificatonCenter addMockObserver:aMock name:SomeNotification object:nil];
    [[mock expect] notificationWithName:SomeNotification object:[OCMArg any]];
    1. 为观察者和通知创建一个mock对象.
    2. 在通知中心注册对象
    3. 预期会调用这个通知.

    8.2 验证

     
    xxxxxxxxxx
     
    OCMVerifyAll(observerMock);

    目前观察者 mock 总是严格的mock.当一个不在预期中的通知调用的时候,就会抛出一个异常.

    这就是说,单个的通知实际上不是能被验证的.所有的通知必须按照预期赖设置.他们会在通过调用OCMVerifyAll来一起验证.

    9 进阶话题

    9.1 对于普通的mock,快速失败

    对strict mock 对象,在一个mock对象上调用没有被mock方法(没有被置换)的时候,会抛出一个异常,这时候会发生 快速失败.

     
    x
    id mock = OCMClassMock([SomeClass class]);
    [[mock reject] someMethod];

    这种情况下,mock会接受除了someMethod 的所有方法.触发someMethod方法会导致快速失败.

    9.2 在OCMVerifyAll时重新抛出异常

    在fail-fast的时候会抛出异常,但是这并不一定会导致测试失败.

    通过调用OCMVerifyAll重新抛出异常可以导致测试失败.

    这个功能在不在预期中的从notifications引发的invocations出现的时候使用.

    9.3 置换创建对象的方法

     
    id classMock = OCMClassMock([SomeClass class]);
    OCMStub([classMock copy])).andReturn(myObject);

    可以置换创建对象的 类/实例方法.当被置换的方法以 alloc,new,copy,mutableCopy开头的方法时,OCMock会自动调整对象的引用计数.

     
     
    id classMock = OCMClassMock([SomeClass class]);
    OCMStub([classMock new])).andReturn(myObject);

    尽管可以置换类的new方法,但是不建议这么做.

    没有办法置换 init 方法,因为这个方法是被mock对象自己实现的.

    9.4 基于实例对象的方法替换

     
    id partialMock = OCMPartialMock(anObject);
    OCMStub([partialMock someMethod]).andCall(differentObject, @selector(differentMethod));

    用一句话概括起来,Method swizzling 会在运行时替换一个方法的实现.

    使用 partial mock然后调用 andCall操作可以实现这个方法替换.

    当anObject收到someMethod消息时,anObject的实现没有触发,相反的,

    differentObject的differentMethod得到调用.

    其他方法并不会收到影响,仍然会调用原来的的方法的实现.

    10 使用限制

    10.1 在一个指定的类上,只能有一个mock对象

     
    xxxxxxxxxx
     
    // don't do this
    id mock1 = OCMClassMock([SomeClass class]);
    OCMStub([mock1 aClassMethod]);
    id mock2 = OCMClassMock([SomeClass class]);
    OCMStub([mock2 anotherClassMethod]);

    原因是类的meta class 替换后,不会释放,mock类仍会存在,甚至可能跨tests.

    如果多个相同mock对象管理同一个类,运行时的行为就不可确定.

    10.2 在被置换的方法上设置期望,会不起作用

     
    id mock = OCMStrictClassMock([SomeClass class]);
    OCMStub([mock someMethod]).andReturn(@"a string");
    OCMExpect([mock someMethod]);
    /* run code under test */
    OCMVerifyAll(mock); // will complain that someMethod has not been called

    上面代码先替换了someMethod,然后强制someMethod返回”a string"

    由于现在mock的实现,所有的someMethod都会置换所处理.所以,即使这个方法被调用,这个验证也会失败.

    可以通过在expect后添加andReturn来避免这个问题. 也可以通过在expect后再次设置一个方法替换.

    10.3 Partial mock 不能在某些特定的类使用

     
    x
     
    id partialMockForString = OCMPartialMock(@"Foo"); 
    // will throw an exception
    NSDate *date = [NSDate dateWithTimeIntervalSince1970:0];
    id partialMockForDate = OCMPartialMock(date);
    // will throw on some architectures

    不可能创建一个 toll-free bridged的类,例如 NSString,或者是NSDate.

    如果你试图这么去做,那么可能会抛出一个异常.

    10.4 某些特定的类不能被置换和验证

     
     
    id partialMockForString = OCMPartialMock(anObject);
    OCMStub([partialMock class]).andReturn(someOtherClass); // will not work

    不能mock某些运行时的方法,例如

    • class,
    • methodSignatureForSelector:
    • forwardInvocation:

    10.5 NSString的类方法不能被置换和验证

     
     
    id stringMock = OCMClassMock([NSString class]);
    // the following will not work
    OCMStub([stringMock stringWithContentsOfFile:[OCMArg any] encoding:NSUTF8StringEncoding error:[OCMArg setTo:nil]]);

    10.6 NSObject 的方法不能被验证

     
    xxxxxxxxxx
     
    id mock = OCMClassMock([NSObject class]);
    /* run code under test, which calls awakeAfterUsingCoder: */
    OCMVerify([mock awakeAfterUsingCoder:[OCMArg any]]);
    // still fails

    不可能在NSObject 和它的分类category上使用verify-after-running.

    在某些情况下可能置换这个方法,然后验证.

    10.7 apple 的私有方法不能被验证

     
    xxxxxxxxxx
    UIWindow *window = /* get window somehow */
    id mock = OCMPartialMock(window);
    /* run code under test, which causes _sendTouchesForEvent: to be invoked */
    OCMVerify([mock _sendTouchesForEvent:[OCMArg any]]);
    // still fails

    含有下划线前缀,后缀,NS,UI开头的方法等.

    10.8 Verify-after-running不能使用延时

    只有在 严格的mock和期望中,可以使用expect-run-verify

  • 相关阅读:
    Android Studio设置字体和主题
    Android 使用shape定义不同控件的的颜色、背景色、边框色
    Linux下mysql的常用操作
    部署腾讯云(CentOS6.6版本,jdk1.7+tomcat8+mysql)
    在linux下如何使用yum查看安装了哪些软件包
    Tomcat下wtpwebapps文件夹 和 webapps文件夹区别
    安卓开源框架SlidingMenu使用
    Android_scaleType属性
    Android_Jar mismatch! Fix your dependencies
    操作系统原理之进程管理(第二章)
  • 原文地址:https://www.cnblogs.com/xilifeng/p/4690280.html
Copyright © 2011-2022 走看看