REST over Vertx

配置说明

REST over Vertx通信通道对应使用standalone部署运行模式,可直接通过main函数拉起。main函数中需要初始化日志和加载服务配置,代码如下:

public class MainServer {
    public static void main(String[] args) throws Exception {
        Log4jUtils.init();//日志初始化
        BeanUtils.init(); // Spring bean初始化
    }
}

使用REST over Vertx网络通道需要在maven pom文件中添加如下依赖:

<dependency>
    <groupId>org.apache.servicecomb</groupId>
    <artifactId>transport-rest-vertx</artifactId>
</dependency>

REST over Vertx通道在microservice.yaml文件中有以下配置项:

表1-1 REST over Vertx配置项说明

配置项 默认值 含义
servicecomb.rest.address 服务监听地址,不配置表示不监听
servicecomb.rest.server.thread-count verticle-count rest server verticle实例数(Deprecated)
servicecomb.rest.server.verticle-count verticle-count rest server verticle实例数
servicecomb.rest.server.connection-limit Integer.MAX_VALUE 允许客户端最大连接数
servicecomb.rest.server.connection.idleTimeoutInSeconds 60 服务端连接闲置超时时间,超时连接会被释放
servicecomb.rest.server.compression false 服务端是否支持启用压缩
servicecomb.rest.server.maxInitialLineLength 4096 服务端接收请求的最大 initial line 长度,单位字节
servicecomb.rest.server.maxHeaderSize 32768 服务端接收请求的最大header长度,单位字节
servicecomb.rest.client.thread-count verticle-count rest client verticle实例数(Deprecated)
servicecomb.rest.client.verticle-count verticle-count rest client verticle实例数
servicecomb.rest.client.connection.maxPoolSize 5 对一个IP:port组合,在每个连接池中的最大连接数
servicecomb.rest.client.connection.idleTimeoutInSeconds 30 连接闲置时间,超时连接会被释放
servicecomb.rest.client.connection.keepAlive true 是否使用长连接
servicecomb.rest.client.connection.compression false 客户端是否支持启用压缩
servicecomb.rest.client.maxHeaderSize 8192 客户端接收响应的最大header长度,单位字节

补充说明

  • 极限连接数计算
    假设:

    • servicecomb.rest.client.thread-count配置为8
    • servicecomb.rest.client.connection.maxPoolSize配置为5
    • 微服务A有10个实例

    站在client的角度,在极限情况下:

    • 一个client调用微服务A,最多会建立400条连接。(8 * 5 * 10 = 400
    • 假设该client还需要调用微服务B,微服务B,也有10个实例,则最多再建立400条连接,共800条连接

    站在server的角度,在极限情况下:

    • 一个client最多向一个server建立40条连接。(8 * 5 = 40)
    • n个client最多会向一个server建立40 * n条连接

    为了提高性能,需要尽量使用更大的连接池,但是更大的连接池又可能会导致连接数暴涨,当微服务实例规模达到百级别时,有的进程可能需要管理几万条连接,业务需要根据实际业务规模进行合理的规划。
    http1.1的规划相对复杂,并且有的场景几乎无解,建议切换为http2

示例代码

microservice.yaml文件中的配置示例:

servicecomb:
  rest:
    address: 0.0.0.0:8080
    server:
      verticle-count: 8
  references:
    hello:
      transport: rest
      version-rule: 0.0.1

results matching ""

    No results matching ""