来源：鸟窝，
colobu.com/2016/03/31/vertx-thread-model/
Vert.x是一个在JVM开发reactive应用的框架，可用于开发异步、可伸缩、高并发的Web应用(虽然不限于web应用)。其目的在于为JVM提供一个Node.js的替代方案。开发者可以通过它使用JavaScript、Ruby、Groovy、Java，甚至是混合语言来编写应用。
使用Vertx.x框架，可以用JavaScript、CoffeeScript、Ruby、Python、Groovy或Java开发应用程序的组件，最终应用程序可以是混合语言构建的。
本文试图揭示Vert.x的线程模型的应用，通过源代码分析Vert.x如何使用线程池处理请求的，以及比较Netty和Vert.x使用线程池的异同。
也许你觉得奇怪，默认启动一个Vert.x Verticle实例，它只用一个线程处理事件，在多核的情况下你需要创建多个Verticle实例以充分利用多个CPU Core的性能。
Vert.x 实例
首先先啰嗦地介绍一些Vert.x概念，熟悉Vert.x开发的朋友可以跳过这一节
在Vert.x里，如果你不使用Vertx对象，你几乎是寸步难行。
Vertx对象扮演着Vert.x控制中心的角色，同时它也提供了大量的功能，例如：
编写TCP客户端和服务器
编写HTTP客户端和服务器，包括websocket
Event bus
共享数据
定时器
发布和卸载Verticle
UDP
DNS client
文件系统访问
高可用
集群
如果你将Vert.x嵌入到你的应用程序中，你可以向下面这样获得一个Vertx对象的引用
Vertx vertx = Vertx.vertx();
当你实例化Vertx对象时，如果你感觉默认的参数不符合你的需求，你可以指定实例化时的参数：
Vertx vertx = Vertx.vertx(new VertxOptions().setWorkerPoolSize(40));
VertxOptions对象拥有很多关于Vertx实例设置，例如配置集群，高可用设置，线程池大小以及等等其他参数。下面就介绍一下它的线程池。
1 线程池
1、eventLoopGroup
这个对象是NioEventLoopGroup的一个实例，它的线程池的大小由options.getEventLoopPoolSize()决定，如果没有设置，默认为CPU核数 * 2。
eventLoopThreadFactory = new VertxThreadFactory("vert.x-eventloop-thread-", checker, false);
eventLoopGroup = new NioEventLoopGroup(options.getEventLoopPoolSize(), eventLoopThreadFactory);
eventLoopGroup.setIoRatio(NETTY_IO_RATIO);
它的EventLoop和一个Context对应：
protected ContextImpl(……) {
……
EventLoopGroup group = vertx.getEventLoopGroup();
if (group != null) {
this.eventLoop = group.next();
} else {
this.eventLoop = null;
}
……
}
它用来执行标准的Verticle。
2、WorkerPool
用来执行worker Verticle。
workerPool = Executors.newFixedThreadPool(options.getWorkerPoolSize(),
new VertxThreadFactory("vert.x-worker-thread-", checker, true));
3、Internal Blocking Pool
内部使用的线程池，可以用来将阻塞代码异步化。
internalBlockingPool = Executors.newFixedThreadPool(options.getInternalBlockingPoolSize(),
new VertxThreadFactory("vert.x-internal-blocking-", checker, true));
不要在event loop中执行阻塞操作， 比如访问数据库或者网络资源，这绝对会影响你的应用的性能。对于这些阻塞操作，你可以将它们异步化：
vertx.executeBlocking(future -> {
// 下面这行代码可能花费很长时间
String result = someAPI.blockingMethod("hello");
future.complete(result);
}, res -> {
System.out.println("The result is: " + res.result());
});
默认情况下executeBlocking会在同一个context中执行(同一个verticle实例)，它们会串行化执行。如果不关心这个执行的顺序，可以将ordered参数设为false，它们会在worker pool线程池中并行的执行。
另外一种执行阻塞代码的方式就是使用worker verticle，worker verticle总是在worker pool线程池中执行。
2 Verticle
Verticle有点类似Actor模型，也可以实现并发的，可扩展的，易于发布的模型。
一个vert.x应用可以包含多个verticle实例，实例之间可以通过event bus通讯。
2.1 三种类型
http://vertx.io/docs/vertx-core/java/#_verticle_types
1、Standard Verticle： 最通用的类型，总是在event loop中执行。
2、Worker Verticle：它们使用worker pool线程池运行。一个verticle实例绝对不会在两个或者更多线程中并发执行。
3、Multi-threaded worker verticle：它们使用worker pool线程池运行。 一个verticle实例可以在多个线程中并发执行。
实现一个Verticle很简单：
public class MyVerticle extends AbstractVerticle {
// 当发布verticle时调用
public void start() {
}
// 可以不实现。当 verticle 卸载时调用
public void stop() {
}
}
2.2 发布方式
1、命令行方式
vertx run SomeJavaSourceFile.java
或者通过maven-shade-plugin打包成一个fat包:
<transformers>
<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
<manifestEntries>
<Main-Class>io.vertx.core.Starter</Main-Class>
<Main-Verticle>com.colobu.vertx.Main</Main-Verticle>
</manifestEntries>
</transformer>
<transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
<resource>META-INF/services/io.vertx.core.spi.VerticleFactory</resource>
</transformer>
</transformers>
然后运行 java -jar xxx-fat.jar,你还可以传递一些参数。
2、编程方式
你也可以编程的方式,通过vertx.deployVerticle发布：
public class Main extends AbstractVerticle {
public static void main(String[] args) {
VertxOptions vo = new VertxOptions();
vo.setEventLoopPoolSize(16);
Vertx vertx = Vertx.vertx(vo);
DeploymentOptions options = new DeploymentOptions();
options.setInstances(100);
vertx.deployVerticle(Main.class.getName(), options, e -> {
System.out.println(e.succeeded());
System.out.println(e.failed());
System.out.println(e.cause());
System.out.println(e.result());
});
}
@Override
public void start() {
Handler<HttpServerRequest> handler = e -> {
HttpServerResponse response = e.response();
response.putHeader("content-type", "application/json").end("Hello world");
};
vertx.createHttpServer().requestHandler(handler).listen(8080);
}
}
Verticle发布和Vert.x线程模型
以上比较啰嗦，主要介绍了一些Vert.x的一些概念。下面是我想重点介绍的内容。
本节以实现一个简单的http server为例(编程方式发布Verticle)，分析 vert.x 的线程和Verticle的关系。只分析标准的Verticle。代码如上。
1 Verticle发布过程
首先先创建一个Vertx实例，可以你可以通过VertxOptions设置线程池的大小。上面的例子中设置Event Loop线程池的大小为16:
vo.setEventLoopPoolSize(16);
因此即使你创建几百个Verticle，也只会有16个Event Loop处理它们，你可以通过jstack查看这些线程。你会看到多个名为vert.x-eventloop-thread-<num>的线程，一个vertx-blocked-thread-checker线程，一个vert.x-acceptor-thread-0。
调用void deployVerticle(String name, DeploymentOptions options, Handler<AsyncResult<String>> completionHandler)方法发布Verticle。
DeploymentOptions对象可以设置发布参数，比如是否是worker verticle,多线程worker verticle, ha, 隔离组等， 重要的是instances，它用来指定分布的Verticle实例的数量，默认是一个。
底层调用DeploymentManager的doDeployVerticle来实现，它会根据实例数创建相应多的Verticle,然后调用doDeploy发布这些Verticle:
Verticle[] verticles = createVerticles(verticleFactory, identifier, options.getInstances(), cl);
我将doDeploy方法简化，让我们看一下关键代码：
private void doDeploy(String identifier, String deploymentID, DeploymentOptions options,
ContextImpl parentContext,
ContextImpl callingContext,
Handler<AsyncResult<String>> completionHandler,
ClassLoader tccl, Verticle... verticles) {
//准备工作
……
for (Verticle verticle: verticles) {
//创建上下文
ContextImpl context = options.isWorker() ? vertx.createWorkerContext(options.isMultiThreaded(), deploymentID, conf, tccl) :
vertx.createEventLoopContext(deploymentID, conf, tccl);
deployment.addVerticle(new VerticleHolder(verticle, context));
context.runOnContext(v -> {
try {
verticle.init(vertx, context);
Future<Void> startFuture = Future.future();
verticle.start(startFuture);
startFuture.setHandler(……);
} catch (Throwable t) {}
});
}
}
可以看到#11 行创建了一个上下文ContextImpl, 因为本例中我们不用worker模式，所以这个上下文是通过vertx.createEventLoopContext(deploymentID, conf, tccl)创建的。每个verticle都会创建一个新的上下文，因此verticle和上下文是意义对应的。
#17 行初始化verticle，#19 行启动这个verticle。还记得我们的例子中实现的start方法吗，它会在这里被调用。
这样，多个verticle实例被发布了。
2 线程模型
首先插播一下Netty的线程模型，不感兴趣的可以略过。
2.1 Netty的线程模型
虽然Vert.x底层籍由Netty实现，但是它的处理方式与Netty NIO的线程模型是不同的。
(以下谈论的Netty线程模型是指NIO的情况)
比如下面的Netty代码片段：
EventLoopGroup parentGroup = new NioEventLoopGroup(1);
EventLoopGroup childGroup = new NioEventLoopGroup(50);
try {
ServerBootstrap b = new ServerBootstrap();
b.group(parentGroup, childGroup)
.channel(NioServerSocketChannel.class)
.childHandler(new ChannelInitializer<SocketChannel>(){……});
Channel ch = b.bind("0.0.0.0",8080).sync().channel();
ch.closeFuture().sync();
} finally {
parentGroup.shutdownGracefully();
childGroup.shutdownGracefully();
}
NioEventLoopGroup代表一组EventLoop，每个EventLoop映射一个线程，每个Channel注册一个EventLoop,但是一个EventLoop可以关联多个Channel。
parentGroup用来处理Accept事件，而childGroup用来处理其余的IO事件。当有并发连接的时候，Handler会在childGroup线程池中执行。你可以指定childGroup的线程数量，如果没有指定，则从系统属性中读取”io.netty.eventLoopThreads”，如果这个属性没有设置，则使用CPU核数 2 (Runtime.getRuntime().availableProcessors() 2))。一般parentGroup设置为1，我们只需要一个Acceptor处理客户端的连接即可。
当有多个并发连接的时候，每个连接/Channel被分配到一个EventLoop上。EventLoop选择是均匀地 (如果线程数是2的n次方，可以用比较快的选择方法PowerOfTwoEventExecutorChooser):
private final class PowerOfTwoEventExecutorChooser implements EventExecutorChooser {
@Override
public EventExecutor next() {
return children[childIndex.getAndIncrement() & children.length - 1];
}
}
private final class GenericEventExecutorChooser implements EventExecutorChooser {
@Override
public EventExecutor next() {
return children[Math.abs(childIndex.getAndIncrement() % children.length)];
}
}
因此一旦如果某个EventLoop处理慢了，则这个线程上的event可能出现堆积。
比如下面的代码故意在某个线程上处理慢一些，导致这个EventLoop上出现堆积，Netty并没有根据压力将时间分配到其它处理快的EventLoop上。
public class HelloServerHandler extends ChannelInboundHandlerAdapter {
……
@Override
public void channelRead(ChannelHandlerContext ctx, Object msg) {
String name = Thread.currentThread().getName();
System.out.println(name);
if (name.endsWith("-5")) {
try {
Thread.sleep(1000);
} catch (InterruptedException e) {
e.printStackTrace();
}
}
……
｝
输出结果可以看到nioEventLoopGroup-3-5处理了同样多的请求，而且都堆积在后面了。
……
nioEventLoopGroup-3-19
nioEventLoopGroup-3-18
nioEventLoopGroup-3-19
nioEventLoopGroup-3-18
nioEventLoopGroup-3-20
nioEventLoopGroup-3-20
nioEventLoopGroup-3-5
nioEventLoopGroup-3-5
nioEventLoopGroup-3-5
nioEventLoopGroup-3-5
nioEventLoopGroup-3-5
nioEventLoopGroup-3-5
nioEventLoopGroup-3-5
nioEventLoopGroup-3-5
nioEventLoopGroup-3-5
因此，我们可以了解到，当启动一个NIO方式的Netty实例的时候，它会使用一个线程池来处理http请求。
Netty 4.0的线程模型被很好的重定义，一个ChannelHandler实例的方法不会被并发的调用，除非它被@Sharable标记，因此你不应该增加一个ChannelHandler 实例多次。当你增加一个handler到ChannelPipeline中时，你可以指定一个特定的EventExecutorGroup来执行这个handler。如果没有指定，则使用Channel注册的EventLoop来执行。如果两个Handler被指定不同的EventExecutorGroup，则它们会并发执行，因此如果它们会访问共享数据的化，你需要关注并发控制的问题。更多内容可以查看 Netty的文档。
2.2 Vert.x的线程模型
Vert.x如何在线程中处理事件的呢，还是以我们的例子分析。
回顾一下我们实现的Verticle的start方法。
@Override
public void start() {
Handler<HttpServerRequest> handler = e -> {
HttpServerResponse response = e.response();
response.putHeader("content-type", "application/json").end("Hello world");
};
vertx.createHttpServer().requestHandler(handler).listen(8080);
}
在这个start方法中，我们创建了一个http server，让它监听 8080端口， http request的处理交给handler执行。 那么监听线程是哪一个？handler又是在哪个线程池中执行的呢？调用多个Verticle实例的方法为什么没有出现”地址/端口被占用”的异常呢？
首先vertx.createHttpServer()会创建一个HttpServerImpl对象，可以通过HttpServerOptions配置更多的参数，每个Verticle实例都会创建一个HttpServerImpl对象。requestHandler(handler)方法设置处理器，你还可以使用Vert.x-Web设置路由的功能。
listen(8080)启动http 服务器，它实际调用netty实现的。
我将listen方法简化，去除一些检查代码和回调处理，只保留关键代码如下：
public synchronized HttpServer listen(int port, String host, Handler<AsyncResult<HttpServer>> listenHandler) {
listenContext = vertx.getOrCreateContext();
listening = true;
synchronized (vertx.sharedHttpServers()) {
id = new ServerID(port, host);
HttpServerImpl shared = vertx.sharedHttpServers().get(id);
if (shared == null) {
serverChannelGroup = new DefaultChannelGroup("vertx-acceptor-channels", GlobalEventExecutor.INSTANCE);
ServerBootstrap bootstrap = new ServerBootstrap();
bootstrap.group(vertx.getAcceptorEventLoopGroup(), availableWorkers);
bootstrap.channelFactory(new VertxNioServerChannelFactory());
bootstrap.childHandler(new ChannelInitializer<Channel>() {
@Override
protected void initChannel(Channel ch) throws Exception {
……
pipeline.addLast("handler", new ServerHandler());
}
});
addHandlers(this, listenContext);
vertx.sharedHttpServers().put(id, this);
actualServer = this;
} else {
// Server already exists with that host/port - we will use that
actualServer = shared;
addHandlers(actualServer, listenContext);
metrics = vertx.metricsSPI().createMetrics(this, new SocketAddressImpl(port, host), options);
}
}
return this;
}
#6 行可以看到它会检查使用这个IP地址和端口的http server是否存在，如果存在的化直接跳到# 27行。因此回答上面的问题，多个Verticle实例不会引起冲突，因为它们会共享同一个http server。
这个http server通过netty ServerBootstrap创建。#10 行可以看到acceptor是一个单线程执行的,acceptorEventLoopGroup在VertxImpl中定义。
acceptorEventLoopGroup = new NioEventLoopGroup(1, acceptorEventLoopThreadFactory);
#10 行还显示，netty的IO worker线程池由availableWorkers确定，它是一个VertxEventLoopGroup对象。VertxEventLoopGroup类扩展AbstractEventExecutorGroup,实现了EventLoopGroup接口:
……
@Override
public synchronized EventLoop next() {
if (workers.isEmpty()) {
throw new IllegalStateException();
} else {
EventLoop worker = workers.get(pos).worker;
pos++;
checkPos();
return worker;
}
}
public synchronized void addWorker(EventLoop worker) {
EventLoopHolder holder = findHolder(worker);
if (holder == null) {
workers.add(new EventLoopHolder(worker));
} else {
holder.count++;
}
}
……
线程的数量由worker的数量决定，worker的类型是EventLoop,对应一个线程，有多少worker就会有多少线程。
通过addWorker可以增加线程的数量，worker不会重复。
回到刚才的listen方法， #21 行addHandlers方法会配置handler在哪一个event loop中执行：
private void addHandlers(HttpServerImpl server, ContextImpl context) {
if (requestStream.handler() != null) {
server.reqHandlerManager.addHandler(requestStream.handler(), context);
}
if (wsStream.handler() != null) {
server.wsHandlerManager.addHandler(wsStream.handler(), context);
}
}
server.reqHandlerManager.addHandler方法如下：
public synchronized void addHandler(Handler<T> handler, ContextImpl context) {
EventLoop worker = context.nettyEventLoop();
availableWorkers.addWorker(worker);
Handlers<T> handlers = new Handlers<>();
Handlers<T> prev = handlerMap.putIfAbsent(worker, handlers);
if (prev != null) {
handlers = prev;
}
handlers.addHandler(new HandlerHolder<>(context, handler));
hasHandlers = true;
}
#2 行得到这个上下文的EventLoop。 还记得上下文的EventLoop怎么创建出来的吗？每个Verticle实例关联一个上下文，因此一个Verticle实例只会创建一个worker。
把这个worker加入到availableWorkers，这样就增加了一个事件处理线程。
因此我们可以看出正常情况下Vert.x的每个Verticle实例只会用一个线程处理请求，在多核情况下一定要配置instance的数量。
如果配置的instance的数量大于eventLoopPoolSize数量，那么就会有一个Event Loop处理多个instance的情况。 线程配置的过多有时不会带来性能的提升，由于线程也有context swicthing，反而会带来性能的降低。
