Fizz企業級微服務API網關進階系列教程-服務編排處理列表數據(上)-展開與合併

来源:https://www.cnblogs.com/ZHONG-J/archive/2022/05/19/16287462.html
-Advertisement-
Play Games

​ 概述 服務編排是Fizz網關提供的一個強大的功能,能夠基於現有的業務微服務通過線上配置的方式快速的生成一個聚合介面,減少中間層膠水代碼以及降低編碼投入。在服務編排中支持使用函數,本進階教程中我們分三篇文章(上篇:列表展開&合併、中篇:列表提取&關聯、下篇:列表欄位重命名&欄位移除)來介紹數據列表 ...


概述

服務編排是Fizz網關提供的一個強大的功能,能夠基於現有的業務微服務通過線上配置的方式快速的生成一個聚合介面,減少中間層膠水代碼以及降低編碼投入。在服務編排中支持使用函數,本進階教程中我們分三篇文章(上篇:列表展開&合併、中篇:列表提取&關聯、下篇:列表欄位重命名&欄位移除)來介紹數據列表類函數的使用。

本文為服務編排處理列表數據系列的上篇。

函數

函數是服務編排提供的一個強大又便捷的功能,通過將一些常用的邏輯封裝成函數,在服務編排中使用函數對服務編排過程的數據進行處理,從而簡化我們的配置又能實現複雜的功能。

函數分類

版本要求:v2.3或以上版本

函數以fn.開頭,如fn.date.timestamp(), date為類別, 網關內置了以下幾大類函數

  • 公共類 fn.common
  • 日期類 fn.date
  • 字元串類 fn.string
  • 編解碼類 fn.codec
  • 數學類 fn.math
  • 數據列表類 fn.list

引用值

在函數里支持使用引用值,如:

fn.string.concat({step1.result.channelCode},{step1.result.nonce})

{step1.result.channelCode} 表示引用值, 引用step1的結果

fn.string.concat({step1.result.channelCode},{g.account.name})

{g.account.name} 表示引用值, 引用公共資源“account.name”, 以g開頭表示引用公共資源

嵌套調用

支持多重嵌套調用,如:

fn.codec.md5(fn.date.add(fn.date.add("2021-07-09 22:44:55", "yyyy-MM-dd HH:mm:ss", 1, fn.math.addExact(999,1)), "yyyy-MM-dd HH:mm:ss", fn.math.addExact(0,1), 1000))
fn.string.toUpperCase(fn.codec.sha256(fn.string.concat({step1.result.channelCode},{step1.result.nonce},{step1.result.timestamp},{step1.result.appSecret})))

數據列表類函數

函數返回值類型用途參數說明
fn.list.expand(
List<List<Object>> data)
List<Object> 將二維數組(列表)展開為一維數組(列表),
如:
data=[[{a:1}],[{a:2}],[{a:3}]]
fn.list.expand(data)
返回:[{a:1},{a:2},{a:3}]
data: 二維數組(列表)
fn.list.merge(
List<Object>... data)
List<Object> 將多個列表合併成一個,如:
data1=[{a:1}]
data2=[{a:2}]
data3=[{a:3}]
fn.list.merge(data1,data2,data3)
返回:[{a:1},{a:2},{a:3}]
data: 列表,可多個
fn.list.extract(
List<Map<String, Object>> data,
String... fields)
List<Map<String, Object>> 只提取列表裡的部分欄位,如:
data=[
{a:1,b:4,c:7},
{a:2,b:5,c:8},
{a:3,b:6,c:9}
]
fn.list.extract(data, "a", "c")
返回:[
{a:1,c:7},
{a:2,c:8},
{a:3,c:9}
]
data: 列表
fields: 【可選】欄位,可多個
fn.list.join(
List<Map<String, Object>> dest,
List<Map<String, Object>> src,
String joinField,
String... fields)
List<Map<String, Object>> 合併2個列表欄位,可只合併指定欄位,如:
dest=[
{a:1,b:4,c:7},
{a:2,b:5,c:8},
{a:3,b:6,c:9}
]
src=[
{a:1,d:444,e:777},
{a:2,d:555,e:888}
]
fn.list.join(dest,src, "a", "d")
返回:[
{a:1,b:4,c:7,d:444},
{a:2,b:5,c:8,d:555},
{a:3,b:6,c:9}
]
dest: 目標列表
src: 被合併的列表
joinField: 兩個列表關聯的欄位
格式:
dest列表的關聯欄位:src列表的
關聯欄位,如:userName:uname,
如果兩個列表的關聯欄位一樣可
只填一個,如:userName
fields: 【可選】被合併列表裡需合併的欄位,可多個,不填則合併所有欄位
fn.list.rename(
List<Map<String, Object>> data,
String... fieldPairs)
List<Map<String, Object>> 重命名列表裡的部分欄位,如:
data=[
{a:1,b:4,c:7},
{a:2,b:5,c:8},
{a:3,b:6,c:9}
]
fn.list.rename(data, "a:apple", "c:cat")
返回:[
{apple:1,b:4,cat:7},
{apple:2,b:5,cat:8},
{apple:3,b:6,cat:9}
]
data: 列表
fieldPairs: 【可選】需重命名
的欄位對,可多個。格式:
原欄位名:新欄位名,如:c:cat
fn.list.removeFields(
List<Map<String, Object>> data,
String... fields)
List<Map<String, Object>> 刪除列表裡的部分欄位,如:
data=[
{a:1,b:4,c:7},
{a:2,b:5,c:8},
{a:3,b:6,c:9}
]
fn.list.removeFields(data, "b")
返回:[
{a:1,c:7},
{a:2,c:8},
{a:3,c:9}
]
data: 列表
fields: 【可選】需刪除的
欄位,可多個

資料準備

Fizz網關安裝

可參考: https://www.fizzgate.com/fizz/guide/installation

底層服務介面

本文服務編排調用的底層服務介面源碼可從github(https://github.com/wehotel/fizz-examples)獲取。從github克隆最新的fizz-examples源碼,並啟動fizz-examples-rest-api服務。

aggr_fn_list_demo_backend_1

aggr_fn_list_demo_backend_2

管理後臺(菜單位置:RPC管理->服務聲明)配置服務聲明,如圖所示。

aggr_fn_list_demo_backend_3

新增編排介面

管理後臺,菜單位置:服務編輯->介面列表,點擊新增。

列表展開 fn.list.expand

本例子在編排介面中調用底層fizz-examples-rest-api服務的/fn-list/user-basic-info-list-by-roles/{roleList}介面(介面源碼:FnListController )來獲取用戶基本信息列表,並對該介面的響應數據進行列表展開以滿足我們想要的數據格式。

基礎信息

aggr_fn_list_expand_1

配置輸入

在配置輸入中可以定義介面的入參和請求頭等信息,如果不配置入參或請求頭,網關會原樣接收調用方傳過來的所有入參或請求頭,但不會對接收到的參數做任何校驗。在本例子中我們不需要入參,全留空。

配置步驟

新增1個步驟step1,然後在步驟step1里新增1個請求request1,服務選擇我們預先準備好的fizz-examples-rest-api服務,請求/fn-list/user-basic-info-list-by-roles/developer,manager介面。配置響應部分留空,網關會原樣接收介面的返回結果。

aggr_fn_list_expand_2

配置輸出

在配置輸出中我們使用step1.request1.response.body.*來引用配置步驟中請求的響應結果(相關引用值的使用方式可參考文檔:數據轉換使用文檔 )。

配置要返回給前端的響應報文,這裡配置了響應體有以下欄位:

code:引用類型,值為步驟step1中請求request1的響應的code欄位;

message:引用類型,值為步驟step1中請求request1的響應的message欄位;

data:引用類型,值為步驟step1中請求request1的響應的data欄位並用fn.list.expand函數對其進行展開。

aggr_fn_list_expand_3

測試

直接調用/fn-list/user-basic-info-list-by-roles/developer,manager介面得到的響應如圖所示。

aggr_fn_list_expand_4

測試介面得到響應如圖所示。

aggr_fn_list_expand_5

從測試介面的響應可以看出服務編排介面已完成了對/fn-list/user-basic-info-list-by-roles/developer,manager介面的請求並正確對響應的data欄位的列表進行了展開。

列表合併 fn.list.merge

本例子在編排介面中兩次調用底層fizz-examples-rest-api服務的/fn-list/user-basic-info-list-by-roles/{roleList}介面(介面源碼:FnListController )來獲取用戶基本信息列表,並對該介面的兩次調用響應數據進行列表合併以滿足我們想要的數據格式。

基礎信息

aggr_fn_list_merge_1

配置輸入

在本例子中我們不需要入參,全留空。

配置步驟

新增1個步驟step1,在步驟step1里新增1個請求request1,服務選擇fizz-examples-rest-api,請求/fn-list/user-basic-info-list-by-role/admin介面。在步驟step1里新增1個請求request2,服務選擇fizz-examples-rest-api,請求/fn-list/user-basic-info-list-by-role/manager介面。

aggr_fn_list_merge_2

aggr_fn_list_merge_3

配置輸出

配置要返回給前端的響應報文,這裡配置了響應體有以下欄位:

code:引用類型,值為步驟step1中請求request1的響應的code欄位;

message:引用類型,值為步驟step1中請求request1的響應的message欄位;

data:引用類型,值為步驟step1中請求request1的響應的data欄位與step1中請求request2的響應的data欄位並用fn.list.merge函數對其進行合併。

aggr_fn_list_merge_4

測試

直接調用/fn-list/user-basic-info-list-by-role/admin介面得到的響應如圖所示。

aggr_fn_list_merge_5

直接調用/fn-list/user-basic-info-list-by-role/manager介面得到的響應如圖所示。

aggr_fn_list_merge_6

測試介面得到響應如圖所示。

aggr_fn_list_merge_7

從測試介面的響應可以看出服務編排介面已完成了對/fn-list/user-basic-info-list-by-role/admin介面的請求和對/fn-list/user-basic-info-list-by-role/manager介面的請求並正確對兩次調用的響應的data欄位的列表進行了合併。

Fizz網關介紹

Fizz Gateway 是一個基於 Java開發的微服務聚合網關,能夠實現熱服務編排聚合、自動授權選擇、線上服務腳本編碼、線上測試、高性能路由、API審核管理、回調管理等目的,擁有強大的自定義插件系統可以自行擴展,並且提供友好的圖形化配置界面,能夠快速幫助企業進行API服務治理、減少中間層膠水代碼以及降低編碼投入、提高 API 服務的穩定性和安全性。

官網:https://www.fizzgate.com

GitHub: https://github.com/wehotel/fizz-gateway-community

碼雲:https://gitee.com/fizzgate/fizz-gateway

入門教程:https://www.fizzgate.com/fizz/guide/GettingStarted/

進階教程:https://www.fizzgate.com/fizz/guide/advanced/


作者:ZHONG.J


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 一、反射 《java核心技術》 官方套話:能夠分析類能力的程式成為反射。 又通過網上搜索有這句話:反射指程式可以訪問、檢測和修改它本身狀態或行為的一種能力。 反射是用來乾什麼的呢? “明明我自己能直接new一個對象,為什麼它要繞一個圈子,先拿到Class對象,再調用Class對象的方法來創建對象呢, ...
  • #包機制 包就是裝代碼的文件夾。 為了更好地組織類,JAVA提供了包機制,用於區別類名的組織空間。 ##package 包語句的句法格式為: 一般利用公司功能變數名稱倒置作為包名。 ##import 為了使用某個包的成員,需要在JAVA程式中明確導入該包。使用import語句可以完成此功能。 import必 ...
  • 轉自:https://www.evanlin.com/maglev/ 2016 年 6 月 2 日 前言(為什麼想讀這一篇論文) 這一篇論文吸引我註意的原因是,Consistent Hashing本來的特性就是作為分散式緩存之用。谷歌將他們的負載均衡器(代號:Maglev)發佈他的實作方式,裡面將一 ...
  • 文章已收錄至https://lichong.work,轉載請註明原文鏈接。 ps:歡迎關註公眾號“Fun肆編程”或添加我的私人微信交流經驗🤝 一.Nginx安裝配置及常用命令 1.環境搭建 首先在linux系統下安裝gcc編譯環境,執行: yum install gcc-c++ -y 確保當前系統 ...
  • 來源:blog.csdn.net/qq_15371293/article/details/117090780 項目場景: ClickHouse 操作基於 Mybatis-puls源碼擴展開發。解決ClickHouse的修改和刪除 SQL操作與Mysql不相同。 基於 Mybatis-puls: up ...
  • 個人學習筆記總結。Basic Types、Strings、Arrays, Slices, and Maps、Control Statements、Declarations & Types、Formatted & File I/O、 Functions, Parameters、Defer、Closur... ...
  • #一、概述 ##1.1、Ribbon Spring Cloud Ribbon是基於Netflix Ribbon實現的一套客戶端負載均衡的工具。簡單的說,Ribbon是Netflix發佈的開源項目,主要功能是提供客戶端的軟體負載均衡演算法和服務調用。Spring Cloud Ribbon雖然只是一個工具 ...
  • ##基本介紹 ###1.變數 定義:可以變化的量 ###2.變數聲明 Java是一種強制類型語言,每一個變數必須聲明類型 ###3.變數名,變數類型和作用域 Java變數是程式中最基本的存儲單元,其要素包括變數名,變數類型和作用域 type varName [=value] [{,varName[= ...
一周排行
    -Advertisement-
    Play Games
  • Timer是什麼 Timer 是一種用於創建定期粒度行為的機制。 與標準的 .NET System.Threading.Timer 類相似,Orleans 的 Timer 允許在一段時間後執行特定的操作,或者在特定的時間間隔內重覆執行操作。 它在分散式系統中具有重要作用,特別是在處理需要周期性執行的 ...
  • 前言 相信很多做WPF開發的小伙伴都遇到過表格類的需求,雖然現有的Grid控制項也能實現,但是使用起來的體驗感並不好,比如要實現一個Excel中的表格效果,估計你能想到的第一個方法就是套Border控制項,用這種方法你需要控制每個Border的邊框,並且在一堆Bordr中找到Grid.Row,Grid. ...
  • .NET C#程式啟動閃退,目錄導致的問題 這是第2次踩這個坑了,很小的編程細節,容易忽略,所以寫個博客,分享給大家。 1.第一次坑:是windows 系統把程式運行成服務,找不到配置文件,原因是以服務運行它的工作目錄是在C:\Windows\System32 2.本次坑:WPF桌面程式通過註冊表設 ...
  • 在分散式系統中,數據的持久化是至關重要的一環。 Orleans 7 引入了強大的持久化功能,使得在分散式環境下管理數據變得更加輕鬆和可靠。 本文將介紹什麼是 Orleans 7 的持久化,如何設置它以及相應的代碼示例。 什麼是 Orleans 7 的持久化? Orleans 7 的持久化是指將 Or ...
  • 前言 .NET Feature Management 是一個用於管理應用程式功能的庫,它可以幫助開發人員在應用程式中輕鬆地添加、移除和管理功能。使用 Feature Management,開發人員可以根據不同用戶、環境或其他條件來動態地控制應用程式中的功能。這使得開發人員可以更靈活地管理應用程式的功 ...
  • 在 WPF 應用程式中,拖放操作是實現用戶交互的重要組成部分。通過拖放操作,用戶可以輕鬆地將數據從一個位置移動到另一個位置,或者將控制項從一個容器移動到另一個容器。然而,WPF 中預設的拖放操作可能並不是那麼好用。為瞭解決這個問題,我們可以自定義一個 Panel 來實現更簡單的拖拽操作。 自定義 Pa ...
  • 在實際使用中,由於涉及到不同編程語言之間互相調用,導致C++ 中的OpenCV與C#中的OpenCvSharp 圖像數據在不同編程語言之間難以有效傳遞。在本文中我們將結合OpenCvSharp源碼實現原理,探究兩種數據之間的通信方式。 ...
  • 一、前言 這是一篇搭建許可權管理系統的系列文章。 隨著網路的發展,信息安全對應任何企業來說都越發的重要,而本系列文章將和大家一起一步一步搭建一個全新的許可權管理系統。 說明:由於搭建一個全新的項目過於繁瑣,所有作者將挑選核心代碼和核心思路進行分享。 二、技術選擇 三、開始設計 1、自主搭建vue前端和. ...
  • Csharper中的表達式樹 這節課來瞭解一下表示式樹是什麼? 在C#中,表達式樹是一種數據結構,它可以表示一些代碼塊,如Lambda表達式或查詢表達式。表達式樹使你能夠查看和操作數據,就像你可以查看和操作代碼一樣。它們通常用於創建動態查詢和解析表達式。 一、認識表達式樹 為什麼要這樣說?它和委托有 ...
  • 在使用Django等框架來操作MySQL時,實際上底層還是通過Python來操作的,首先需要安裝一個驅動程式,在Python3中,驅動程式有多種選擇,比如有pymysql以及mysqlclient等。使用pip命令安裝mysqlclient失敗應如何解決? 安裝的python版本說明 機器同時安裝了 ...