Vert.x是一个基于netty的异步的工具集。可以简单理解成运行在JVM上的Node.js。本文是简单的入门教程。
Hello Vert.x
新建项目
在IDEA中新建一个Gradle项目(名为hello):
从官网github例子中复制build.gradle文件内容,并修改maven仓库url改成国内淘宝镜像的,由于我没有使用gradle wrapper,所以官网build.gradle例子中最后关于wrapper的task我也删除了,最后代码如下:
plugins {
id 'java'
id 'application'
id 'com.github.johnrengelman.shadow' version '1.2.3'
}
repositories {
maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' }
}
sourceCompatibility = '1.8'
dependencies {
compile "io.vertx:vertx-core:3.5.0"
}
mainClassName = 'io.vertx.example.HelloWorldEmbedded'
shadowJar {
classifier = 'fat'
mergeServiceFiles {
include 'META-INF/services/io.vertx.core.spi.VerticleFactory'
}
}
别忘了修改了build.gradle文件内容之后,需要点击IDEA右边gradle栏目的刷新按钮,以更新项目依赖信息:
编写程序
新增一个类:com.abc.Application
,继承vertx的AbstractVerticle抽象类,重写start方法,在方法中编写启动一个服务端的代码:
package com.abc;
import io.vertx.core.AbstractVerticle;
import io.vertx.core.Future;
public class Application extends AbstractVerticle {
@Override
public void start(Future<Void> f) throws Exception {
vertx.createHttpServer()
.requestHandler(req->{
req.response().end("Hello Vert.x");
})
.listen(8080,result->{
if (result.succeeded()){
f.complete();
}else{
f.fail(result.cause());
}
});
}
}
在vert.x中,一个verticle就是一个组件
。Application继承AbstractVerticle,即Application是一个组件。从代码中可以看到,Application用到了父类提供的vertx成员。vertx成员提供创建服务端的方法。
start
方法会在verticle部署
的时候执行。start方法其实是一个回调方法,它可以有一个Future类型的参数(io.vertx包的),该参数可以用来通知Vertx当前这个verticle的start方法是否执行成功。由于Vert.x是异步非阻塞的,所以verticle部署的时候,不会等待start方法执行结束,因此才需要一个Future类型的参数来通知Vert.x执行是否成功。
在start方法中,我们创建了一个http服务端,并注册了请求处理器(requestHandler),顾名思义,请求处理器中的方法会在每次请求到来时执行。最后,让该http服务端监听8080端口。
测试代码
添加单元测试所需依赖:
dependencies {
compile "io.vertx:vertx-core:$version"
compile "io.vertx:vertx-unit:$version"
compile "junit:junit:4.12"
}
编写测试com.abc.ApplicationTest
:
package com.abc;
import io.vertx.core.Vertx;
import io.vertx.ext.unit.Async;
import io.vertx.ext.unit.TestContext;
import io.vertx.ext.unit.junit.VertxUnitRunner;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
@RunWith(VertxUnitRunner.class)
public class ApplicationTest {
//vertx容器
private Vertx vertx;
@Before
public void setUp(TestContext context) {
//创建一个vertx容器的实例
vertx = Vertx.vertx();
//将Application这个verticle部署到容器中,并注册部署完成的处理器
vertx.deployVerticle(Application.class.getName(),
context.asyncAssertSuccess());
}
@After
public void tearDown(TestContext context) {
//关闭容器,注册关闭完成的处理器
vertx.close(context.asyncAssertSuccess());
}
@Test
public void testApplication(TestContext context) {
final Async async = context.async();
//创建一个http客户端,发送请求到http服务端
vertx.createHttpClient().getNow(8080, "localhost", "/",
response -> {
response.handler(body -> {
context.assertTrue(body.toString().contains("Hello"));
async.complete();
});
});
}
}
上面的测试代码用到了vertx-unit
模块,该模块是用来测试异步的代码的。在setUp方法中,我们创建了一个vertx容器,并部署Application这个verticle到容器中(部署时会执行Application类的start方法)。setUp方法有一个TestContext参数,是用来控制异步代码的。当部署verticle时,verticle的start方法异步执行。因此将context.asyncAssertSuccess()(一个Handler<AsyncResult>)传入到deployVerticle方法中,那么deployVerticle方法执行成功或失败,都会有与这个Handler来执行对应的操作。
在testApplication方法中,由于发送请求和接收请求的过程是异步的,所以我们创建了一个Async处理器,并在收到响应的回调中执行async.complete()来通知测试的上下文该单元测试完成了。
项目打包
修改build.gradle文件:
plugins {
id 'java'
id 'application'
id 'com.github.johnrengelman.shadow' version '1.2.3'
}
repositories {
maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' }
}
sourceCompatibility = '1.8'
mainClassName = 'io.vertx.core.Launcher' //<--add
def mainVerticleName = 'com.abc.Application'//<--add
dependencies {
compile "io.vertx:vertx-core:3.5.0"
compile "io.vertx:vertx-unit:3.5.0"
compile "junit:junit:4.12"
}
shadowJar {
classifier = 'fat'
manifest { //<--add
attributes "Main-Verticle": mainVerticleName
}
mergeServiceFiles {
include 'META-INF/services/io.vertx.core.spi.VerticleFactory'
}
}
执行gradle shadowJar
命令打包。运行打包出来的Jar包,然后浏览器输入127.0.0.1:8080访问即可看到响应的内容。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。