Rocket - config - Parameters

https://mp.weixin.qq.com/s/uLEr9gAFaMDIXa8S9xJVTw

 

介绍配置类Parameters及其伴生对象的实现。

 

参考链接：

https://docs.qq.com/sheet/DUUVQdGp3RHlzVGZm

 

 

​​

 

1. Parameters

 

Parameters是View的子类。实现了View中的find方法，但又把find方法代理给抽象方法chain。所以真实的查找逻辑还是要在Parameters的子类中实现。

 

chain方法代表的是一个链式查找逻辑，签名如下：

​​

其中：

a. pname为要查找的配置项；

b. site为当前要查找的视图；

c. tail为下一个要查找的视图；

 

 

2. EmptyParameters

 

​​

 

EmptyParameters中没有配置项，所以直接在下一个视图中查找：tail.find(pname, site)

 

其创建使用Parameters伴生对象进行创建：

​​

 

 

3. PartialParameters

 

​​

 

PartialParameters包含一个类型为函数的成员f，其类型为：(View, View, View) => PartialFunction[Any,Any]

a. 接收三个类型为View的参数；

b. 返回一个类型为PartialFunction[Any,Any]的函数；

 

PartialParameters的查找逻辑如下：

a. 根据当前的上下文，生成一个匹配函数g；

b. g是一个部分(partial)匹配函数，先检查这个函数是否针对查找key(pname)有匹配项。如果有，则执行匹配找到匹配项并返回；如果没有匹配项，则使用下一个视图(tail)进行查找。

 

 

4. MapParameters

 

​​

 

MapParameters的查找逻辑如下：

a. 在映射表map中查找key(pname)对应的值；

b. 如果存在，则返回配置值；如果不存在，则使用下一个视图(tail)进行查找；

 

 

5. ChainParameters

 

​​

 

ChainParameters本身不能返回配置值，只是一个从x到y的链接。先到x中查找，而后到y中查找。

 

 

6. Config

 

​​

 

Config本身只是一个包装类，是Parameter p的包装，直接调用p.chain进行查找。

 

它也包含一个传入参数f的构造方法，自动使用f构造一个Parameter包装在Config中。这样外部只需要使用Config即可，而不需要在使用Parameter伴生对象的工厂方法。

 

如下即是使用Config的第二个（secondary）构造方法：

​​

 

 

7. 总结

 

查找配置项有两种方法：

a. 动态匹配查找，使用PartialParameters，因为他是一个私有类，所以外部只能使用Config类的第二个构造方法；

b. 静态映射表查找，使用MapParameters，在Rocket中没有使用。

 

ChainParameters只是用于构造链式视图结构，而不包含实际的配置项。Parameters类的++方法把两个视图组合成一个ChainParameters：

​​

 

Config类也继承了这个方法：

​​

 

所以外部只需要使用Config类即可。