Tars | 第3篇 Tars中期彙報測試文件（Java語言實現Subset路由規則）

多氯環己烷發表於2021-09-08

Java路由

前言

本篇為Tars專案上半程程式設計實踐的測試結果，經過上半程的原始碼學習、程式設計探索，現已初步實現Subset流量路由的三個核心功能：按比例路由、按引數路由與無規則路由。下面將介紹任務需求、測試模擬方案以及具體的測試結果。

1. 任務介紹

下圖為Subset流量管理任務需求 - 各語言SDK實現部分：

各語言SDK實現

本人的任務是：使用Java語言實現Subset路由規則，核心點在新增三種模式的路由規則：

按比例路由；
按引數路由，分為精確路由與正則路由；
無規則路由；

任務確認截圖

具體流程是：

獲取路由規則引數；
獲取當前存活的服務節點；
對節點進行Subset規則過濾【核心】；
將過濾後的節點資訊存入status傳入下游；

現在，在中期彙報前已完成初步編碼，實現上述三種路由方式，下面將介紹筆者設計的測試方案，展示完成度。

2. 測試模擬方案

測試採用Java SpringBoot的單元測試功能；

測試思路是先模擬建立前置條件（新增路由規則與存活節點資訊），接著呼叫filterEndpointsBySubset()方法進行測試，最後做些格式化處理。在這過程中輸出過濾前後的節點資訊。因此測試方案分為以下六步：

新增路由規則；
新增過濾前節點資訊；
【輸出】輸出過濾前節點；
【核心】對存活節點按subset規則過濾；
對過濾後節點進行格式化處理；
【輸出】輸出過濾結果。

2.0 *前置工作

根據Java SpringBoot的單元測試規則，需要先構建一些測試用到的元件：

//通訊器配置項
CommunicatorConfig communicatorConfig = new CommunicatorConfig();
//查詢助手
QueryHelper queryHelper = new QueryHelper(new Communicator(communicatorConfig));
//服務代理配置項
ServantProxyConfig servantProxyConfig = new ServantProxyConfig("objectName");
//節點列表
List<EndpointF> endpointFList = new ArrayList<EndpointF>();
//存活的節點
Holder<List<EndpointF>> activeEp = new Holder<List<EndpointF>>(new ArrayList<EndpointF>());

2.1 新增路由規則

首先，根據任務需求文件說明書，可以知道新增路由規則的入參是類似下面JSON資料：

JSON資料

因此，筆者將上面資訊存入servantProxyConfig服務代理配置項裡，rule_data用一個map格式的資料來裝配。下面程式碼用來模擬上游解析後的JSON資料，給通訊器新增路由規則：

//新增按比例路由規則
servantProxyConfig.setRuleType("proportion");
servantProxyConfig.setObjectName("objectName");
Map<String,String> map = new HashMap<>();
map.put("v1","20");
map.put("v2","80");
//map.put("v3",80);
servantProxyConfig.setRuleData(map);

2.2 新增存活節點

在TarsJava裡，節點儲存在list集合裡，直接add即可：

//新增存活節點
endpointFList.add(new EndpointF("host1",1,2,3,4,5,6,"setId1",7,8,9,10,"v1"));
endpointFList.add(new EndpointF("host2",1,2,3,4,5,6,"setId2",7,8,9,10,"v1"));
endpointFList.add(new EndpointF("host3",1,2,3,4,5,6,"setId3",7,8,9,10,"v2"));
endpointFList.add(new EndpointF("host4",1,2,3,4,5,6,"setId4",7,8,9,10,"v2"));
endpointFList.add(new EndpointF("host5",1,2,3,4,5,6,"setId5",7,8,9,10,"v2"));
//endpointFList.add(new EndpointF("host5",1,2,3,4,5,6,"setId5",7,8,9,10,"v3"));

activeEp.setValue(endpointFList);

2.3 【輸出】遍歷輸出當前存活節點

 //輸出過濾前節點資訊
        System.out.println("過濾前節點資訊如下：");
        for( EndpointF endpoint : endpointFList){
            System.out.println(endpoint.toString());
        }

2.4 【核心】對存活節點按subset規則過濾

這是核心點，核心方法為filterEndpointsBySubset()按Subset規則過濾節點，這是筆者寫的和測試的方法，它能夠根據上述三種規則過濾節點：

//對存活節點按subset規則過濾
StringBuilder value = queryHelper.filterEndpointsBySubset(activeEp, servantProxyConfig);

2.5 後續格式化處理

這步將對過濾後的節點進行格式化處理：

//後續格式化相關工作
if (value.length() < 1) {
    System.out.println("value.length() < 1");
    return;
}
value.insert(0, Constants.TARS_AT);
value.insert(0, servantProxyConfig.getSimpleObjectName());

2.6 【輸出】輸出過濾結果

這步輸出過濾後的節點資訊：

//輸出過濾結果
System.out.println("過濾後節點資訊如下：");
System.out.println("result = " + value.toString());

筆者的測試方案設計就這樣分為六步，以下具體測試例項都是按照這六步進行。

3. 按比例路由規則 - 單次測試

具體測試方案為：節點有20%概率路由到Subset欄位為v1的節點，有80概率路由到Subset欄位為v2的節點【詳情檢視新增路由規則】。

測試程式碼如下：

/**
 * 按比例路由規則 - 單次測試
 */
@Test
public void testProportionOnce() {

    //新增按比例路由規則
    servantProxyConfig.setRuleType("proportion");
    servantProxyConfig.setObjectName("objectName");
    Map<String,String> map = new HashMap<>();
    map.put("v1","20");
    map.put("v2","80");
    servantProxyConfig.setRuleData(map);

    //新增存活節點
    endpointFList.add(new EndpointF("host1",1,2,3,4,5,6,"setId1",7,8,9,10,"v1"));
    endpointFList.add(new EndpointF("host2",1,2,3,4,5,6,"setId2",7,8,9,10,"v1"));
    endpointFList.add(new EndpointF("host3",1,2,3,4,5,6,"setId3",7,8,9,10,"v2"));
    endpointFList.add(new EndpointF("host4",1,2,3,4,5,6,"setId4",7,8,9,10,"v2"));
    endpointFList.add(new EndpointF("host5",1,2,3,4,5,6,"setId5",7,8,9,10,"v2"));
    
    activeEp.setValue(endpointFList);

    //輸出過濾前節點資訊
    System.out.println("過濾前節點資訊如下：");
    for( EndpointF endpoint : endpointFList){
        System.out.println(endpoint.toString());
    }

    //對存活節點按subset規則過濾
    StringBuilder value = queryHelper.filterEndpointsBySubset(activeEp, servantProxyConfig);

    //後續格式化相關工作
    if (value.length() < 1) {
        System.out.println("value.length() < 1");
        return;
    }
    value.insert(0, Constants.TARS_AT);
    value.insert(0, servantProxyConfig.getSimpleObjectName());

    //輸出過濾結果
    System.out.println("過濾後節點資訊如下：");
    System.out.println("result = " + value.toString());
}

測試結果如下：
按比例路由-單次測試
結果分析：

可以看出成功路由到v2節點，但還是無法體驗到概率問題，於是有了下面按比例路由規則 - 多次測試。

4. 按比例路由規則 - 多次測試

具體測試方案為：迴圈10000000次，統計路由結果，判斷是否按比例路由。這裡設定的比例是v1:v2:v3 = 20:80:20。

測試程式碼如下：

/**
 * 按比例路由規則 - 多次測試
 */
@Test
public void testProportionTimes() {

    //新增按比例路由規則
    servantProxyConfig.setRuleType("proportion");
    servantProxyConfig.setObjectName("objectName");
    Map<String,String> map = new HashMap<>();
    map.put("v1","20");
    map.put("v2","80");
    map.put("v3","20");
    servantProxyConfig.setRuleData(map);

    //新增存活節點
    endpointFList.add(new EndpointF("host1",1,2,3,4,5,6,"setId1",7,8,9,10,"v1"));
    endpointFList.add(new EndpointF("host2",1,2,3,4,5,6,"setId2",7,8,9,10,"v2"));
    endpointFList.add(new EndpointF("host3",1,2,3,4,5,6,"setId3",7,8,9,10,"v3"));

    activeEp.setValue(endpointFList);

    //迴圈times次
    int times = 10000000;
    int v1Times = 0;
    int v2Times = 0;
    int v3Times = 0;
    int errTimes = 0;
    for (int i = 0; i < times; i++) {
        //對存活節點按subset規則過濾
        StringBuilder value = queryHelper.filterEndpointsBySubset(activeEp, servantProxyConfig);
        //獲取value的subset值
        String subset = null;
        if (value != null && value.length() > 3) {
            subset = value.substring(value.length() - 2);
            if("v1".equals(subset)){
                v1Times++;
            } else if("v2".equals(subset)){
                v2Times++;
            } else if("v3".equals(subset)){
                v3Times++;
            }
        } else {
            errTimes++;
        }

    }
    //輸出結果
    System.out.println("一共迴圈次數：" + times);
    System.out.println("路由到v1次數：" + v1Times);
    System.out.println("路由到v2次數：" + v2Times);
    System.out.println("路由到v3次數：" + v3Times);
    System.out.println("路由異常次數：" + errTimes);
}

測試結果如下：

按比例路由 - 多次測試

結果分析：

可以看出結果比例接近v1:v2:v3 = 20:80:20，更改比例對應結果改變，按比例路由方法測試成功。

5. 按引數路由規則測試

具體測試方案為：設定染色的key為uid123，路由規則為精確(uid123) / 正則匹配(uid12*)，路由規則跟染色key匹配，則路由到設定的v1；如果路由規則跟染色key不匹配，則無法路由，丟擲錯誤資訊。

測試程式碼如下：

/**
 * 按引數路由規則
 */
@Test
public void testParameterAccurate() {

    //新增按精確匹配路由規則
    servantProxyConfig.setRuleType("parameter");
    servantProxyConfig.setObjectName("objectName");
    Map<String,String> map = new HashMap<>();

    //精確匹配測試
    map.put("equal","uid123"); //精確匹配
    //map.put("equal","uid12");  //當染色key和請求的rule_type對不上時

    //正則匹配測試
    //map.put("match","uid12*");  //正則匹配
    //map.put("match","*d123");  //正則匹配
    //map.put("match","uid123");  //正則匹配
    //map.put("match","*id12*");  //正則匹配

    //map.put("match","*i12d*");

    map.put("route","v1");
    servantProxyConfig.setRuleData(map);

    //設定染色的key
    servantProxyConfig.setRouteKey("uid123");

    //新增存活節點
    endpointFList.add(new EndpointF("host1",1,2,3,4,5,6,"setId1",7,8,9,10,"v1"));
    endpointFList.add(new EndpointF("host2",1,2,3,4,5,6,"setId2",7,8,9,10,"v1"));
    endpointFList.add(new EndpointF("host3",1,2,3,4,5,6,"setId3",7,8,9,10,"v2"));
    endpointFList.add(new EndpointF("host4",1,2,3,4,5,6,"setId4",7,8,9,10,"v2"));

    activeEp.setValue(endpointFList);

    //輸出過濾前節點資訊
    System.out.println("過濾前節點資訊如下：");
    for( EndpointF endpoint : endpointFList){
        System.out.println(endpoint.toString());
    }
    //對存活節點按subset規則過濾
    StringBuilder value = queryHelper.filterEndpointsBySubset(activeEp, servantProxyConfig);
    //後續格式化相關工作
    if (value.length() < 1) {
        System.out.println("找不到節點，value.length() < 1");
        return;
    }
    value.insert(0, Constants.TARS_AT);
    value.insert(0, servantProxyConfig.getSimpleObjectName());

    //輸出過濾結果
    System.out.println("過濾後節點資訊如下：");
    System.out.println("result = " + value.toString());

}

測試結果如下：

按引數路由

結果分析：

經過測試，發現精確匹配路由成功；而正則匹配也能成功；當路由規則跟染色key不匹配時，則無法路由，輸出結果如下圖：

找不到節點

6. 按無路由規則測試

具體測試方案為：無路由規則比較簡單，直接傳入{"default" , "v3" }路由規則即可，預設路由到v3；

測試程式碼如下：

/**
 * 按無路由規則
 */
@Test
public void testDefault() {
    //新增按比例路由規則
    servantProxyConfig.setRuleType("default");
    servantProxyConfig.setObjectName("objectName");
    Map<String,String> map = new HashMap<>();
    map.put("default","v3");

    servantProxyConfig.setRuleData(map);

    //新增存活節點
    endpointFList.add(new EndpointF("host1",1,2,3,4,5,6,"setId1",7,8,9,10,"v1"));
    endpointFList.add(new EndpointF("host2",1,2,3,4,5,6,"setId2",7,8,9,10,"v1"));
    endpointFList.add(new EndpointF("host3",1,2,3,4,5,6,"setId3",7,8,9,10,"v2"));
    endpointFList.add(new EndpointF("host4",1,2,3,4,5,6,"setId4",7,8,9,10,"v2"));
    endpointFList.add(new EndpointF("host5",1,2,3,4,5,6,"setId5",7,8,9,10,"v2"));
    endpointFList.add(new EndpointF("host5",1,2,3,4,5,6,"setId5",7,8,9,10,"v3"));

    activeEp.setValue(endpointFList);

    //輸出過濾前節點資訊
    System.out.println("過濾前節點資訊如下：");
    for( EndpointF endpoint : endpointFList){
        System.out.println(endpoint.toString());
    }

    //對存活節點按subset規則過濾
    StringBuilder value = queryHelper.filterEndpointsBySubset(activeEp, servantProxyConfig);

    //後續格式化相關工作
    if (value.length() < 1) {
        System.out.println("value.length() < 1");
        return;
    }
    value.insert(0, Constants.TARS_AT);
    value.insert(0, servantProxyConfig.getSimpleObjectName());

    //輸出過濾結果
    System.out.println("過濾後節點資訊如下：");
    System.out.println("result = " + value.toString());
}

測試結果如下：

按無路由規則

結果分析：

按照預設的預設規則能成功路由到v3。

最後

新人制作，如有錯誤，歡迎指出，感激不盡！歡迎關注公眾號，會分享一些更日常的東西！如需轉載，請標註出處！ Tars | 第3篇 Tars中期彙報測試文件（Java語言實現Subset路由規則）

Tars | 第5篇基於TarsGo Subset路由規則的Java JDK實現方式（上）
2021-09-11
Go路由JavaJDK
Tars | 第6篇基於TarsGo Subset路由規則的Java JDK實現方式（下）
2021-09-12
Go路由JavaJDK
Tars | 第4篇 Subset路由規則業務分析與原始碼探索
2021-09-10
路由原始碼
Tars | 第7篇 TarsJava Subset最終程式碼的測試方案設計
2021-09-14
Java
騰訊Tars團隊釋出Tars的go語言版本，效能是grpc五倍
2018-09-25
GoRPC
Tars | 第8篇 TarsJava Subset最終程式碼的執行流程與原理分析
2021-09-16
Java
Tseer：Tars名字服務功能的輕量化實現
2019-02-19
Tars-Java客戶端原始碼分析
2021-05-08
Java客戶端原始碼
if測試和語法規則
2017-12-03
星海支援 TARS 和 Dubbo 協議啦~
2020-08-21
協議
Tencent高效能微服務治理方案Tars
2019-01-27
微服務
基於開源Tars的動態負載均衡實踐
2021-05-31
負載
java 規則引擎資料彙集
2017-07-28
Java
Drools 規則語言詳解
2011-07-24
JAVA語法規則 (轉)
2007-08-15
Java
Java語言規範
2018-03-24
Java
介面測試--介面文件規範
2020-11-28
騰訊開源專案TARS首次全面釋出PHP版本
2019-02-28
PHP
TARS為SpringCloud提供高效能的RPC能力
2021-09-09
SpringGCCloudRPC
最佳實踐：路徑路由匹配規則的設計與實現
2023-05-10
路由
騰訊 Tars-Go 服務獲取自定義模版（配置）值
2019-02-25
Go
Java中動態規則的實現方式
2020-08-25
Java
騰訊與閱文技術合作微服務框架Tars再添PHP
2017-11-02
微服務框架PHP
Java語言編碼規範
2020-04-06
Java
通過 ProxySQL 在 TiDB 上實現 SQL 的規則化路由
2021-11-04
SQLTiDB路由
複數的四則運算（C語言實現）
2020-11-28
C語言
Go語言實現的Java Stream API
2019-09-05
GoJavaAPI
java語言實現二叉樹
2020-10-31
Java二叉樹
zuul 自定義路由規則
2018-12-27
Zuul路由
靜態路由規則配置
2024-11-06
路由
C語言的本質（37）——makefile之隱含規則和模式規則
2014-07-24
C語言模式
C語言單元測試
2013-08-26
C語言
Go 語言區塊鏈測試實踐指南（一）：GO單元測試
2023-12-12
Go區塊鏈
地理探測器R語言實現：geodetector
2024-03-18
R語言
乾貨| PHPCon上TARS-PHP全面解讀及PPT下載
2019-02-28
PHP
HCNP Routing&Switching之OSPF LSA更新規則和路由彙總
2021-09-05
路由
R語言data manipulation學習筆記之subset data
2018-03-29
R語言筆記
使用 Rust 語言編寫 Java JNI 實現
2024-07-07
RustJava

Tars | 第3篇 Tars中期彙報測試文件（Java語言實現Subset路由規則）

前言

1. 任務介紹

2. 測試模擬方案

2.0 *前置工作

2.1 新增路由規則

2.2 新增存活節點

2.3 【輸出】遍歷輸出當前存活節點

2.4 【核心】對存活節點按subset規則過濾

2.5 後續格式化處理

2.6 【輸出】輸出過濾結果

3. 按比例路由規則 - 單次測試

4. 按比例路由規則 - 多次測試

5. 按引數路由規則測試

6. 按無路由規則測試

最後

相關文章