从零开始实现简单 RPC 框架 3：配置总线 URL

URL 的定义

URL 对于大部分程序猿来说都是很熟悉的，其全称是 Uniform Resource Locator (统一资源定位器)。它是互联网的统一资源定位标志，也就是指网络地址。

一个标准的 URL 格式可以包含如下的几个部分：

protocol://username:password@host:port/path?key1=value1&key2=value2

• protocol：协议，例如 http 协议
• username/password：用户名/密码
• host/port：主机/端口
• path：请求路径
• parameters：参数键值对

为什么使用 URL

在

ccx-rpc

doSomething(String param1, String param2);
doSomething2(Map<String,String> params);
doSomething3(Parameters params);

使用 URL 一致性模型：

doSomething(URL url);
doSomething2(URL url);
doSomething3(URL url);

使用 URL 统一配置模型的好处：

• 形成代码规范，多作者编写和读者都能以同一种标准编写/阅读代码，提供效率。
• 可扩展性强，URL 相当于参数的集合(

  key1=value1&key2=value2

  )，当我们在扩展代码时，可以将新的参数追加到 URL 中，不需要改变出入参。

ccx-rpc 中的应用

1. SPI 适配扩展

SPI 的适配方法，使用

@Adaptive

@Adaptive

以注册中心扩展类工厂为例：

@SPI
public interface RegistryFactory {

/**
* 获取注册中心
*
* @param url 注册中心的配置，例如注册中心的地址。会自动根据协议获取注册中心实例
* @return 如果协议类型跟注册中心匹配上了，返回对应的配置中心实例
*/
@Adaptive("protocol")
Registry getRegistry(URL url);
}

public static void main(String[] args) {
// 获取适配扩展
RegistryFactory zkRegistryFactory = ExtensionLoader.getLoader(RegistryFactory.class).getAdaptiveExtension();
URL url = URLParser.toURL("zk://localhost:2181");
// 适配扩展自动从 ur 中解析出扩展名，然后返回对应的扩展类
Registry registry = zkRegistryFactory.getRegistry(url);
}

URL 是

zk://localhost:2181

SPI Adaptive

zk

Registry

ZkRegistry

2. 暴露服务

服务提供方想注册中心注册服务的时候，是通过 URL 注册。其格式大致如下：

zk://192.168.10.11:1234/com.ccx.rpc.core.test.registry.ZkRegistryTest?methods=test1

注册中心接口中的注册方法：

public interface Registry {

/**
* 向注册中心注册服务
*
* @param url 注册者的信息
*/
void register(URL url);
}

zk 拿到 URL 之后，从中解析出接口

com.ccx.rpc.core.test.registry.ZkRegistryTest

3. 引用服务

服务引用方，从注册中心拿到的服务信息就是提供方注册的信息。

zk://192.168.10.11:1234/com.ccx.rpc.core.test.registry.ZkRegistryTest?methods=test1

然后引用方从 URL 中解析出服务的地址：

192.168.10.11:1234

public interface Registry {
/**
* 查找注册的服务
*
* @param condition 查询条件
* @return 符合查询条件的所有注册者
*/
List<URL> lookup(URL condition);
}

总结

URL 在

ccx-rpc

ccx-rpc