Vert.x Java开发指南——第五章 测试Vert.x代码

感兴趣的朋友,可以关注微信服务号“猿学堂社区”,或加入“猿学堂社区”微信交流群

版权声明:本文由作者自行翻译,未经作者授权,不得随意转发。

到目前为止,我们已经开发了未包含测试的Wiki实现。这自然不是一种好的实践,因此让我们看一下如何为Vert.x代码编写测试。

5.1 开始

vertx-unit模块提供了工具来测试Vert.x中的异步操作。除此之外,你还可以使用你选择的测试框架,如JUnit。

使用JUnit,需要的Maven依赖如下:

<dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>4.12</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>io.vertx</groupId>
    <artifactId>vertx-unit</artifactId>
    <scope>test</scope>
</dependency>

JUnit测试需要注解为VertxUnitRunner runner,以便使用vertx-unit特性:

@RunWith(VertxUnitRunner.class)
public class SomeTest {
    // (...)
}

通过这个runner,JUnit测试和生命周期方法接收一个TestContext参数。这个对象提供了对基础断言、存储数据上下文的访问,以及几个面向异步的帮助类,我们将在本节中可以看到。

为了说明它,让我们考虑一个异步场景,我们想要检查一个timer任务被调用了一次,以及一个周期任务被调用了三次。由于这个代码是异步的,所以测试方法在测试完成之前就退出,因此,使测试通过或失败还需要以异步方式进行:

@Test /*(timeout=5000)*/ ⑧
public void async_behavior(TestContext context) { ①
    Vertx vertx = Vertx.vertx(); ②
    context.assertEquals("foo", "foo"); ③
    Async a1 = context.async(); ④
    Async a2 = context.async(3); ⑤
    vertx.setTimer(100, n -> a1.complete()); ⑥
    vertx.setPeriodic(100, n -> a2.countDown()); ⑦
}

① TestContext是由runner提供的一个参数。

② 由于我们在单元测试中,我们需要创建一个Vert.x上下文。

③ 此处是一个基本的TestContext断言的示例。

④ 我们得到第一个Async对象,它接下来可能完成(或失败)。

⑤ 这个Async对象作为一个countdown工作,在三次调用之后成功完成。

⑥ 我们在timer触发时完成。

⑦ 每次周期任务触发一个countdown。测试在所有Async对象完成后通过。

⑧ 有一个默认(long)超时时间用于异步测试用例,但是它可以通过JUnit的@Test注解覆盖。

5.2 测试数据库操作

数据库服务非常适合编写测试。

我们首先需要部署数据库Verticle。我们将配置JDBC链接为HSQLDB,使用内存存储,当成功的时候,我们将获取一个服务代理用于我们的测试用例。

由于这些操作的需要,我们利用JUnit的before/after生命周期方法:

private Vertx vertx;
private WikiDatabaseService service;
@Before
public void prepare(TestContext context) throws InterruptedException {
    vertx = Vertx.vertx();
    JsonObject conf = new JsonObject() ①
        .put(WikiDatabaseVerticle.CONFIG_WIKIDB_JDBC_URL,               "jdbc:hsqldb:mem:testdb;shutdown=true")
        .put(WikiDatabaseVerticle.CONFIG_WIKIDB_JDBC_MAX_POOL_SIZE, 4);
    vertx.deployVerticle(new WikiDatabaseVerticle(), new DeploymentOptions().setConfig(conf),
    context.asyncAssertSuccess(id -> ②
        service = WikiDatabaseService.createProxy(vertx,WikiDatabaseVerticle.CONFIG_WIKIDB_QUEUE)));
}

① 我们只是复写了Verticle的部分配置,其它使用默认值。

② asyncAssertSuccess对于提供一个检测异步操作成功的handler是非常有用的。它有一个变体是无参的,另一个变体像这个,此时我们可以链接结果到另一个handler。

Vert.x的清理很简单,我们再次使用asyncAssertSuccess以确保没有遇到错误:

@After
public void finish(TestContext context) {
    vertx.close(context.asyncAssertSuccess());
}

数据库服务的操作本质上是CRUD操作,因此使用一个JUnit测试用例合并它们全部是一个测试的好方法:

@Test
public void crud_operations(TestContext context) {
    Async async = context.async();
    service.createPage("Test","Some content",context.asyncAssertSuccess(v1 -> {
        service.fetchPage("Test",context.asyncAssertSuccess(json1 -> {
            context.assertTrue(json1.getBoolean("found"));
            context.assertTrue(json1.containsKey("id"));
            context.assertEquals("Some content",json1.getString("rawContent"));
            service.savePage(json1.getInteger("id"),"Yo!",context.asyncAssertSuccess(v2 -> {
                service.fetchAllPages(context.asyncAssertSuccess(array1 -> {
                    context.assertEquals(1,array1.size());
                    service.fetchPage("Test",context.asyncAssertSuccess(json2 -> {
                        context.assertEquals("Yo!",json2.getString("rawContent"));
                        service.deletePage(json1.getInteger("id"),v3 -> {
                            service.fetchAllPages(context.asyncAssertSuccess(array2 -> {
                                context.assertTrue(array2.isEmpty());
                                async.complete();①
                                }));
                            });
                        }));
                    }));
                }));
            }));
        }));
    async.awaitSuccess(5000);②
}

① 这是唯一的Async最终完成的地方。

② 这是在退出测试用例方法和依赖JUnit超时之间的取舍。此处,测试用例线程执行等待直到Async完成或者超时周期过去。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,921评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,635评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,393评论 0 338
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,836评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,833评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,685评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,043评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,694评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 42,671评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,670评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,779评论 1 332
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,424评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,027评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,984评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,214评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,108评论 2 351
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,517评论 2 343

推荐阅读更多精彩内容