testable-mock/docs/zh-cn/doc/scope-of-mock.md

Mock的生效范围

在@MockMethod和@MockConstructor注解上都有一个scope参数，其可选值有两种

• MockScope.GLOBAL：该Mock方法将全局生效
• MockScope.ASSOCIATED：该Mock方法仅对Mock容器关联测试类中的测试用例生效

举例来说，AaaService和BbbService是两个需要被测试的类，在BbbService的代码里有个recordTicket()调用依赖外部系统。因此在进行单元测试时，开发者在BbbService关联的Mock容器里使用@MockMethod注解定义了这个调用的替代方法。此时，若该Mock方法的scope值为MockScope.GLOBAL，则不论是在AaaServiceTest测试类还是在BbbServiceTest测试类的测试用例，只要直接或间接的执行到这行调用，都会被置换为调用Mock方法。若该Mock方法的scope值为MockScope.ASSOCIATED，则Mock只对BbbServiceTest类中的测试用例生效，而AaaServiceTest类中的测试用例在运行过程中执行到了BbbService类的相关代码，将会执行recordTicket()的原本调用。

对于常规项目而言，单元测试里需要被Mock的调用都是由于其中包含了不需要或不便于测试的逻辑，譬如“依赖外部系统”、“包含随机结果”、“执行非常耗时”等等，这类调用在整个单元测试的生命周期里都应该被Mock方法置换，不论调用的发起者是谁。因此TestableMock默认所有Mock方法都是全局生效的，即scope默认值为MockScope.GLOBAL。

在一些大型项目中，会有“下层模块编写单元测试，上层模块编写端到端集成测试，两者混合在一起运行”的情况，这时候大部分Mock方法都应该使用MockScope.ASSOCIATED作为生效范围。针对这种情况，TestableMock支持通过mockScope运行参数来修改默认的Mock方法生效范围，详见全局运行参数文档。

特别说明。若要Mock静态块里的调用，Mock方法的scope必须为MockScope.GLOBAL，因为静态块中的代码在程序初始化时就会执行，不属于任何测试用例。典型场景是在使用JNI开发的项目中Mock系统库的加载方法。

static {
    System.loadLibrary("native-lib");
}

若默认的scope参数不是MockScope.GLOBAL，则相应Mock方法应当显式的声明scope值，例如：

@MockMethod(targetClass = System.class, scope = MockScope.GLOBAL)
private void loadLibrary(String libname) {
    System.err.println("loadLibrary " + libname);
}