集成测试在es源码中的用法比较简单。我选择的切入口是delete-by-query插件。

将es插件的源码导入intellij后，直接运行类DeleteByQueryRestIT， 就会运行所有的集成测试用例。

-ea -Dtests.security.manager=false

这个运行结果，会让我产生两个疑问：

  1. 这个类里面没有test注解的方法，其入口在哪里？
  2. resource/rest-api-spec目录下，只有一个yaml文件，这些测试用例来自哪里？

通过查看其父类ESRestTestCase，可以看到里面有test注解的test方法，而且设置断点，可以确定该方法是测试的入口。

那么500多个测试用例来自哪里呢？

看ESRestTestCase类@BeforeClass注解的方法

 @BeforeClass public static void initExecutionContext() throws IOException, RestException { String[] specPaths = resolvePathsProperty(REST_TESTS_SPEC, DEFAULT_SPEC_PATH); RestSpec restSpec = null; FileSystem fileSystem = getFileSystem(); // don't make a try-with, getFileSystem returns null // ... and you can't close() the default filesystem try { restSpec = RestSpec.parseFrom(fileSystem, DEFAULT_SPEC_PATH, specPaths); } finally { IOUtils.close(fileSystem); } validateSpec(restSpec); restTestExecutiOnContext= new RestTestExecutionContext(restSpec); }

通过了解这个方法的源码，可以了解到在elasticsearch-2.4.5-tests.jar里面，集成了这些测试用例。 这些测试用例的源码就在elasticsearch/rest-api-spec目录下。

那么如何只运行插件中的测试用例而忽略jar包中的测试用例呢？

-Dtests.rest.load_packaged=false

直接运行，会发现测试用例运行失败。原来delete-by-query的测试用例有依赖。先编译源码: 编译前修改项目源码的elasticsearch/pom.xml文件， 不能略过集成测试。

<skip.integ.tests>false</skip.integ.tests>

然后编译delete-by-query插件

elasticsearch/plugins/delete-by-query$ mvn install

编译完成后再运行DeleteByQueryRestIT类，即可成功运行插件的测试用例。

-ea -Dtests.security.manager=false -Dtests.rest.load_packaged=false

这里的测试用例会启用一个独立的es集群，用来运行测试用例，运行完成后再shutdown. 其功能由如下的脚本提供:

elasticsearch/dev-tools/src/main/resources/integration-tests.xml

参考: http://david.pilato.fr/blog/2016/10/18/elasticsearch-real-integration-tests-updated-for-ga/

了解了集成测试插件的运行过程后，就可以在开发插件时自行实现集成测试的功能。而且通过yaml+json的方式，能够做到测试用例的复用。