整合测试引擎

流程

Junit 中的 Parameterized 会聚合起所有的测试数据,并将测试数据一一传递给测试方法进行断言。数据处理就像是沙漏中的流沙:

3.6.2. 整合测试引擎 - 图1

配置

  • 环境类文件
    • /sharding-integration-test/sharding-jdbc-test/src/test/resources/integrate/env.properties
    • /sharding-integration-test/sharding-jdbc-test/src/test/resources/integrate/env/SQL-TYPE/dataset.xml
    • /sharding-integration-test/sharding-jdbc-test/src/test/resources/integrate/env/SQL-TYPE/schema.xml
  • 测试用例类文件
    • /sharding-integration-test/sharding-jdbc-test/src/test/resources/integrate/cases/SQL-TYPE/SQL-TYPE-integrate-test-cases.xml
    • /sharding-integration-test/sharding-jdbc-test/src/test/resources/integrate/cases/SQL-TYPE/dataset/SHARDING-TYPE/*.xml
  • sql-case 文件
    • /sharding-sql-test/src/main/resources/sql/sharding/SQL-TYPE/*.xml

环境配置

集成测试需要真实的数据库环境,根据相应的配置文件创建测试环境:

首先,修改配置文件 /sharding-integration-test/sharding-jdbc-test/src/test/resources/integrate/env.properties ,例子如下:

  1. # 测试主键,并发,column index等的开关
  2. run.additional.cases=false
  3. # 分片策略,可指定多种策略
  4. sharding.rule.type=db,tbl,dbtbl_with_masterslave,masterslave
  5. # 要测试的数据库,可以指定多种数据库(H2,MySQL,Oracle,SQLServer,PostgreSQL)
  6. databases=MySQL,PostgreSQL
  7. # MySQL配置
  8. mysql.host=127.0.0.1
  9. mysql.port=13306
  10. mysql.username=root
  11. mysql.password=root
  12. ## PostgreSQL配置
  13. postgresql.host=db.psql
  14. postgresql.port=5432
  15. postgresql.username=postgres
  16. postgresql.password=
  17. ## SQLServer配置
  18. sqlserver.host=db.mssql
  19. sqlserver.port=1433
  20. sqlserver.username=sa
  21. sqlserver.password=Jdbc1234
  22. ## Oracle配置
  23. oracle.host=db.oracle
  24. oracle.port=1521
  25. oracle.username=jdbc
  26. oracle.password=jdbc

其次,修改文件 /sharding-integration-test/sharding-jdbc-test/src/test/resources/integrate/env/SQL-TYPE/dataset.xmldataset.xml文件中定义元数据和测试数据。例如:

  1. <dataset>
  2. <metadata data-nodes="tbl.t_order_${0..9}">
  3. <column name="order_id" type="numeric" />
  4. <column name="user_id" type="numeric" />
  5. <column name="status" type="varchar" />
  6. </metadata>
  7. <row data-node="tbl.t_order_0" values="1000, 10, init" />
  8. <row data-node="tbl.t_order_1" values="1001, 10, init" />
  9. <row data-node="tbl.t_order_2" values="1002, 10, init" />
  10. <row data-node="tbl.t_order_3" values="1003, 10, init" />
  11. <row data-node="tbl.t_order_4" values="1004, 10, init" />
  12. <row data-node="tbl.t_order_5" values="1005, 10, init" />
  13. <row data-node="tbl.t_order_6" values="1006, 10, init" />
  14. <row data-node="tbl.t_order_7" values="1007, 10, init" />
  15. <row data-node="tbl.t_order_8" values="1008, 10, init" />
  16. <row data-node="tbl.t_order_9" values="1009, 10, init" />
  17. </dataset>

开发者可以在 schema.xml 中自定义建库与建表语句。

断言配置

env.propertiesdataset.xml 确定了什么SQL在什么环境执行,下面是断言数据的配置:

断言的配置,需要两种文件,第一类文件位于 /sharding-integration-test/sharding-jdbc-test/src/test/resources/integrate/cases/SQL-TYPE/SQL-TYPE-integrate-test-cases.xml 这个文件类似于一个索引,定义了要执行的SQL,参数以及期待的数据的文件位置。这里的 test-case 引用的就是sharding-sql-test中 SQL 对应的sql-case-id,例子如下:

  1. <integrate-test-cases>
  2. <dml-test-case sql-case-id="insert_with_all_placeholders">
  3. <assertion parameters="1:int, 1:int, insert:String" expected-data-file="insert_for_order_1.xml" />
  4. <assertion parameters="2:int, 2:int, insert:String" expected-data-file="insert_for_order_2.xml" />
  5. </dml-test-case>
  6. </integrate-test-cases>

还有一类文件 – 断言数据,也就是上面配置中的 expected-data-file 对应的文件,文件在 /sharding-integration-test/sharding-jdbc-test/src/test/resources/integrate/cases/SQL-TYPE/dataset/SHARDING-TYPE/*.xml 这个文件内容跟 dataset.xml 很相似,只不过expected-data-file文件中不仅定义了断言的数据,还有相应SQL执行后的返回值等。例如:

  1. <dataset update-count="1">
  2. <metadata data-nodes="db_${0..9}.t_order">
  3. <column name="order_id" type="numeric" />
  4. <column name="user_id" type="numeric" />
  5. <column name="status" type="varchar" />
  6. </metadata>
  7. <row data-node="db_0.t_order" values="1000, 10, update" />
  8. <row data-node="db_0.t_order" values="1001, 10, init" />
  9. <row data-node="db_0.t_order" values="2000, 20, init" />
  10. <row data-node="db_0.t_order" values="2001, 20, init" />
  11. </dataset>

所有需要配置的数据,都已经配置完毕,启动相应的集成测试类即可,全程不需要修改任何 Java 代码,只需要在 xml 中做数据初始化以及断言,极大的降低了ShardingSphere数据测试的门槛以及复杂度。

注意事项

  1. 如需测试Oracle,请在pom.xml中增加Oracle驱动依赖。
  2. 为了保证测试数据的完整性,整合测试中的分库分表采用了10库10表的方式,因此运行测试用例的时间会比较长。