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.verticle-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