简单RPC框架-基于Consul的服务注册与发现

2022-11-11 08:53:21

*:first-child {
margin-top: 0 !important;
}

body>*:last-child {
margin-bottom: 0 !important;
}

/* BLOCKS
=============================================================================*/

p, blockquote, ul, ol, dl, table, pre {
margin: 15px 0;
}

/* HEADERS
=============================================================================*/

h1, h2, h3, h4, h5, h6 {
margin: 20px 0 10px;
padding: 0;
font-weight: bold;
-webkit-font-smoothing: antialiased;
}

h1 tt, h1 code, h2 tt, h2 code, h3 tt, h3 code, h4 tt, h4 code, h5 tt, h5 code, h6 tt, h6 code {
font-size: inherit;
}

h1 {
font-size: 28px;
color: #000;
}

h2 {
font-size: 24px;
border-bottom: 1px solid #ccc;
color: #000;
}

h3 {
font-size: 18px;
}

h4 {
font-size: 16px;
}

h5 {
font-size: 14px;
}

h6 {
color: #777;
font-size: 14px;
}

body>h2:first-child, body>h1:first-child, body>h1:first-child+h2, body>h3:first-child, body>h4:first-child, body>h5:first-child, body>h6:first-child {
margin-top: 0;
padding-top: 0;
}

a:first-child h1, a:first-child h2, a:first-child h3, a:first-child h4, a:first-child h5, a:first-child h6 {
margin-top: 0;
padding-top: 0;
}

h1+p, h2+p, h3+p, h4+p, h5+p, h6+p {
margin-top: 10px;
}

/* LINKS
=============================================================================*/

a {
color: #4183C4;
text-decoration: none;
}

a:hover {
text-decoration: underline;
}

/* LISTS
=============================================================================*/

ul, ol {
padding-left: 30px;
}

ul li > :first-child,
ol li > :first-child,
ul li ul:first-of-type,
ol li ol:first-of-type,
ul li ol:first-of-type,
ol li ul:first-of-type {
margin-top: 0px;
}

ul ul, ul ol, ol ol, ol ul {
margin-bottom: 0;
}

dl {
padding: 0;
}

dl dt {
font-size: 14px;
font-weight: bold;
font-style: italic;
padding: 0;
margin: 15px 0 5px;
}

dl dt:first-child {
padding: 0;
}

dl dt>:first-child {
margin-top: 0px;
}

dl dt>:last-child {
margin-bottom: 0px;
}

dl dd {
margin: 0 0 15px;
padding: 0 15px;
}

dl dd>:first-child {
margin-top: 0px;
}

dl dd>:last-child {
margin-bottom: 0px;
}

/* CODE
=============================================================================*/

pre, code, tt {
font-size: 12px;
font-family: Consolas, "Liberation Mono", Courier, monospace;
}

code, tt {
margin: 0 0px;
padding: 0px 0px;
white-space: nowrap;
border: 1px solid #eaeaea;
background-color: #f8f8f8;
border-radius: 3px;
}

pre>code {
margin: 0;
padding: 0;
white-space: pre;
border: none;
background: transparent;
}

pre {
background-color: #f8f8f8;
border: 1px solid #ccc;
font-size: 13px;
line-height: 19px;
overflow: auto;
padding: 6px 10px;
border-radius: 3px;
}

pre code, pre tt {
background-color: transparent;
border: none;
}

kbd {
-moz-border-bottom-colors: none;
-moz-border-left-colors: none;
-moz-border-right-colors: none;
-moz-border-top-colors: none;
background-color: #DDDDDD;
background-image: linear-gradient(#F1F1F1, #DDDDDD);
background-repeat: repeat-x;
border-color: #DDDDDD #CCCCCC #CCCCCC #DDDDDD;
border-image: none;
border-radius: 2px 2px 2px 2px;
border-style: solid;
border-width: 1px;
font-family: "Helvetica Neue",Helvetica,Arial,sans-serif;
line-height: 10px;
padding: 1px 4px;
}

/* QUOTES
=============================================================================*/

blockquote {
border-left: 4px solid #DDD;
padding: 0 15px;
color: #777;
}

blockquote>:first-child {
margin-top: 0px;
}

blockquote>:last-child {
margin-bottom: 0px;
}

/* HORIZONTAL RULES
=============================================================================*/

hr {
clear: both;
margin: 15px 0;
height: 0px;
overflow: hidden;
border: none;
background: transparent;
border-bottom: 4px solid #ddd;
padding: 0;
}

/* IMAGES
=============================================================================*/

img {
max-width: 100%
}
-->

一般我们常见的RPC框架都包含如下三个部分：

注册中心，用于服务端注册远程服务以及客户端发现服务
服务端，对外提供后台服务，将自己的服务信息注册到注册中心
客户端，从注册中心获取远程服务的注册信息，然后进行远程过程调用
上面提到的注册中心其实属于服务治理，即使没有注册中心，RPC的功能也是完整的。之前我大多接触的是基于zookeeper的注册中心，这里基于consul来实现注册中心的基本功能。

Consul的一些特点：

Raft相比Paxos直接

此外不多描述,还没研究raft

支持数据中心，可以用来解决单点故障之类的问题
集成相比zookeeper更加简单（代码量少，逻辑清晰简单）
支持健康检查,支持http以及tcp
自带UI管理功能，不需要额外第三方支持。（zookeeper需要单独部署zkui之类的第三方工具）
支持key/value存储

启动consul之后访问管理页面

RPC集成

提取出服务注册与服务发现两个接口，然后使用Consul实现，这里主要通过consul-client来实现（也可以是consul-api），需要在pom中引入:

<dependency>

	<groupId>com.orbitz.consul</groupId>

	<artifactId>consul-client</artifactId>

	<version>0.14.1</version>

</dependency>

服务注册

RegistryService
提供服务的注册与删除功能

public interface RegistryService {

    void register(RpcURL url);

    void unregister(RpcURL url);

}

AbstractConsulService
consul的基类，用于构建Consl对象，服务于服务端以及客户端。

public class AbstractConsulService {

    private static final Logger logger = LoggerFactory.getLogger(AbstractConsulService.class);

    protected final static String CONSUL_NAME="consul_node_jim";

    protected final static String CONSUL_ID="consul_node_id";

    protected final static String CONSUL_TAGS="v3";

    protected final static String CONSUL_HEALTH_INTERVAL="1s";

    protected Consul buildConsul(String registryHost, int registryPort){

        return Consul.builder().withHostAndPort(HostAndPort.fromString(registryHost+":"+registryPort)).build();

    }

}

ConsulRegistryService
服务注册实现类，在注册服务的同时，指定了健康检查。

服务的删除暂时未实现

public class ConsulRegistryService extends AbstractConsulService implements RegistryService {

    private final static int CONSUL_CONNECT_PERIOD=1*1000;

    @Override

    public void register(RpcURL url) {

        Consul consul = this.buildConsul(url.getRegistryHost(),url.getRegistryPort());

        AgentClient agent = consul.agentClient();

        ImmutableRegCheck check = ImmutableRegCheck.builder().tcp(url.getHost()+":"+url.getPort()).interval(CONSUL_HEALTH_INTERVAL).build();

        ImmutableRegistration.Builder builder = ImmutableRegistration.builder();

        builder.id(CONSUL_ID).name(CONSUL_NAME).addTags(CONSUL_TAGS).address(url.getHost()).port(url.getPort()).addChecks(check);

        agent.register(builder.build());

    }

    @Override

    public void unregister(RpcURL url) {

    }

}

由于我实现的RPC是基于TCP的，所以服务注册的健康检查也指定为TCP，consul会按指定的IP以及端口建立连接以此判断服务的健康状态。如果是http，则需要调用http方法，同时指定健康检查地址。

ImmutableRegCheck check = ImmutableRegCheck.builder().tcp(url.getHost()+":"+url.getPort()).interval(CONSUL_HEALTH_INTERVAL).build();

后台的监控信息如下：

虽然只是指定了TCP,可能出于某种机制后台依然会发起HTTP的健康检查请求,上图第一条请求日志。

服务发现

DiscoveryService
获取所有注册的有效的服务信息。

public interface DiscoveryService {

    List<RpcURL> getUrls(String registryHost, int registryPort);

}

ConsulDiscoveryService
首先是获取有效的服务列表：

List<RpcURL> urls= Lists.newArrayList();

Consul consul = this.buildConsul(registryHost,registryPort);

HealthClient client = consul.healthClient();

String name = CONSUL_NAME;

ConsulResponse object= client.getAllServiceInstances(name);

List<ImmutableServiceHealth> serviceHealths=(List<ImmutableServiceHealth>)object.getResponse();

for(ImmutableServiceHealth serviceHealth:serviceHealths){

    RpcURL url=new RpcURL();

    url.setHost(serviceHealth.getService().getAddress());

    url.setPort(serviceHealth.getService().getPort());

    urls.add(url);

}

服务更新监听，当可用服务列表发现变化时需要通知调用端。

try {

    ServiceHealthCache serviceHealthCache = ServiceHealthCache.newCache(client, name);

    serviceHealthCache.addListener(new ConsulCache.Listener<ServiceHealthKey, ServiceHealth>() {

        @Override

        public void notify(Map<ServiceHealthKey, ServiceHealth> map) {

            logger.info("serviceHealthCache.addListener notify");

            RpcClientInvokerCache.clear();

        }

    });

    serviceHealthCache.start();

} catch (Exception e) {

    logger.info("serviceHealthCache.start error:",e);

}

由于之前对客户端的Invoker有缓存，所以当服务列表有变化时需要对缓存信息进行更新。

这里简单的直接对缓存做清除处理，其实好一点的方法应该只对有变化的做处理。

RpcClientInvokerCache
对客户端实例化后的Invoker的缓存类

public class RpcClientInvokerCache {

    private static CopyOnWriteArrayList<RpcClientInvoker> connectedHandlers = new CopyOnWriteArrayList<>();

    public static CopyOnWriteArrayList<RpcClientInvoker> getConnectedHandlersClone(){

        return (CopyOnWriteArrayList<RpcClientInvoker>) RpcClientInvokerCache.getConnectedHandlers().clone();

    }

    public static void addHandler(RpcClientInvoker handler) {

        CopyOnWriteArrayList<RpcClientInvoker> newHandlers = getConnectedHandlersClone();

        newHandlers.add(handler);

        connectedHandlers=newHandlers;

    }

    public static CopyOnWriteArrayList<RpcClientInvoker> getConnectedHandlers(){

        return connectedHandlers;

    }

    public static RpcClientInvoker get(int i){

        return connectedHandlers.get(i);

    }

    public static int size(){

        return connectedHandlers.size();

    }

    public static void clear(){

        CopyOnWriteArrayList<RpcClientInvoker> newHandlers = getConnectedHandlersClone();

        newHandlers.clear();

        connectedHandlers=newHandlers;

    }

}

负载均衡
当同一个接口有多个服务同时提供服务时，客户端需要有一定的负载均衡机制去决策将客户端的请求分配给哪一台服务器，这里实现一个简易的轮询实现方式。请求次数累加，累加的值与服务列表的大小做取模操作。

代码中取服务列表的方法有小问题，未按接口信息取，后续再完成

public class RoundRobinLoadbalanceService implements LoadbalanceService {

    private AtomicInteger roundRobin = new AtomicInteger(0);

    private static final int MAX_VALUE=1000;

    private static final int MIN_VALUE=1;

    private AtomicInteger getRoundRobinValue(){

        if(this.roundRobin.getAndAdd(1)>MAX_VALUE){

            this.roundRobin.set(MIN_VALUE);

        }

        return this.roundRobin;

    }

    @Override

    public int index(int size) {

        return  (this.getRoundRobinValue().get() + size) % size;

    }

}

待完善的功能

代码中取服务列表的方法有小问题，未按接口信息取
注册中心的可用服务地址信息变化时，需要优化为按需更新
注册中心的服务删除未实现

源码地址

https://github.com/jiangmin168168/jim-framework

码农公寓