主頁 > 後端開發 > Fizz企業級微服務API網關進階系列教程-服務編排處理串列資料(上)-展開與合并

Fizz企業級微服務API網關進階系列教程-服務編排處理串列資料(上)-展開與合并

2022-05-19 15:26:11 後端開發

?

概述

服務編排是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=https://www.cnblogs.com/ZHONG-J/p/[[{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=https://www.cnblogs.com/ZHONG-J/p/[
{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=https://www.cnblogs.com/ZHONG-J/p/[
{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=https://www.cnblogs.com/ZHONG-J/p/[
{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=https://www.cnblogs.com/ZHONG-J/p/[
{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

?

轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/477597.html

標籤：Java

上一篇：VideoLanVLC媒體播放器在不同螢屏中顯示綠色紋理統一應用程式

下一篇：變數、常量、作用域（Java）

標籤雲
其他(157675) Python(38076) JavaScript(25376) Java(17977) C(15215) 區塊鏈(8255) C＃(7972) AI(7469) 爪哇(7425) MySQL(7132) html(6777) 基礎類(6313) sql(6102) 熊猫(6058) PHP(5869) 数组(5741) R(5409) Linux(5327) 反应(5209) 腳本語言(PerlPython)(5129) 非技術區(4971) Android(4554) 数据框(4311) css(4259) 节点.js(4032) C語言(3288) json(3245) 列表(3129) 扑(3119) C++語言(3117) 安卓(2998) 打字稿(2995) VBA(2789) Java相關(2746) 疑難問題(2699) 细绳(2522) 單片機工控(2479) iOS(2429) ASP.NET(2402) MongoDB(2323) 麻木的(2285) 正则表达式(2254) 字典(2211) 循环(2198) 迅速(2185) 擅长(2169) 镖(2155) 功能(1967) .NET技术(1958) Web開發(1951) python-3.x(1918) HtmlCss(1915) 弹簧靴(1913) C++(1909) xml(1889) PostgreSQL(1872) .NETCore(1853) 谷歌表格(1846) Unity3D(1843) for循环(1842)

熱門瀏覽
  • 【C++】Microsoft C++、C 和匯編程式檔案

    ......

    uj5u.com 2020-09-10 00:57:23 more
  • 例外宣告

    相比于斷言適用于排除邏輯上不可能存在的狀態，例外通常是用于邏輯上可能發生的錯誤。 例外宣告 Item 1：當函式不可能拋出例外或不能接受拋出例外時，使用noexcept 理由 如果不打算拋出例外的話，程式就會認為無法處理這種錯誤，并且應當盡早終止，如此可以有效地阻止例外的傳播與擴散。 示例 //不可 ......

    uj5u.com 2020-09-10 00:57:27 more
  • Codeforces 1400E Clear the Multiset(貪心 + 分治)

    鏈接：https://codeforces.com/problemset/problem/1400/E 來源：Codeforces 思路：給你一個陣列，現在你可以進行兩種操作，操作1：將一段沒有 0 的區間進行減一的操作，操作2：將 i 位置上的元素歸零。最終問：將這個陣列的全部元素歸零后操作的最少 ......

    uj5u.com 2020-09-10 00:57:30 more
  • UVA11610 【Reverse Prime】

    本人看到此題沒有翻譯，就附帶了一個自己的翻譯版本 思考 這一題，它的第一個要求是找出所有 $7$ 位反向質數及其質因數的個數。 我們應該需要質數篩篩選1~$10^{7}$的所有數，這里就不慢慢介紹了。但是，重讀題，我們突然發現反向質數都是 $7$ 位，而將它反過來后的數字卻是 $6$ 位數，這就說明 ......

    uj5u.com 2020-09-10 00:57:36 more
  • 統計區間素數數量

    1 #pragma GCC optimize(2) 2 #include <bits/stdc++.h> 3 using namespace std; 4 bool isprime[1000000010]; 5 vector<int> prime; 6 inline int getlist(int ......

    uj5u.com 2020-09-10 00:57:47 more
  • C/C++編程筆記：C++中的 const 變數詳解，教你正確認識const用法

    1、C中的const 1、區域const變數存放在堆疊區中，會分配記憶體（也就是說可以通過地址間接修改變數的值）。測驗代碼如下： 運行結果： 2、全域const變數存放在只讀資料段（不能通過地址修改，會發生寫入錯誤）， 默認為外部聯編，可以給其他源檔案使用（需要用extern關鍵字修飾） 運行結果： ......

    uj5u.com 2020-09-10 00:58:04 more
  • 【C++犯錯記錄】VS2019 MFC添加資源不懂如何修改資源宏ID

    1. 首先在資源視圖中，添加資源 2. 點擊新添加的資源，復制自動生成的ID 3. 在解決方案資源管理器中找到Resource.h檔案，編輯，使用整個專案搜索和替換的方式快速替換 宏宣告 4. Ctrl+Shift+F 全域搜索，點擊查找全部，然后逐個替換 5. 為什么使用搜索替換而不使用屬性視窗直 ......

    uj5u.com 2020-09-10 00:59:11 more
  • 【C++犯錯記錄】VS2019 MFC不懂的批量添加資源

    1. 打開資源頭檔案Resource.h，在其中預先定義好宏 ID（不清楚其實ID值應該設定多少，可以先新建一個相同的資源項，再在這個資源的ID值的基礎上遞增即可） 2. 在資源視圖中選中專案資源，按F7編輯資源檔案，按 ID 型別 相對路徑的形式添加 資源。（別忘了先把檔案拷貝到專案中的res檔案 ......

    uj5u.com 2020-09-10 01:00:19 more
  • C/C++編程筆記：關于C++的參考型別，專供新手入門使用

    今天要講的是C++中我最喜歡的一個用法——參考，也叫別名。 參考就是給一個變數名取一個變數名，方便我們間接地使用這個變數。我們可以給一個變數創建N個參考，這N + 1個變數共享了同一塊記憶體區域。(參考型別的變數會占用記憶體空間，占用的記憶體空間的大小和指標型別的大小是相同的。雖然參考是一個物件的別名，但 ......

    uj5u.com 2020-09-10 01:00:22 more
  • 【C/C++編程筆記】從頭開始學習C ++：初學者完整指南

    眾所周知，C ++的學習曲線陡峭，但是花時間學習這種語言將為您的職業帶來奇跡，并使您與其他開發人員區分開。您會更輕松地學習新語言，形成真正的解決問題的技能，并在編程的基礎上打下堅實的基礎。 C ++將幫助您養成良好的編程習慣（即清晰一致的編碼風格，在撰寫代碼時注釋代碼，并限制類內部的可見性），并且由 ......

    uj5u.com 2020-09-10 01:00:41 more
最新发布
  • Rust中的智能指標:Box<T> Rc<T> Arc<T> Cell<T> RefCell<T> Weak

    Rust中的智能指標是什么 智能指標（smart pointers）是一類資料結構，是擁有資料所有權和額外功能的指標。是指標的進一步發展 指標（pointer）是一個包含記憶體地址的變數的通用概念。這個地址參考，或 ” 指向”（points at）一些其 他資料 。參考以 & 符號為標志并借用了他們所 ......

    uj5u.com 2023-04-20 07:24:10 more
  • Java的值傳遞和參考傳遞

    值傳遞不會改變本身，參考傳遞（如果傳遞的值需要實體化到堆里）如果發生修改了會改變本身。 1.基本資料型別都是值傳遞 package com.example.basic; public class Test { public static void main(String[] args) { int ......

    uj5u.com 2023-04-20 07:24:04 more
  • [2]SpinalHDL教程——Scala簡單入門

    第一個 Scala 程式 shell里面輸入 $ scala scala> 1 + 1 res0: Int = 2 scala> println("Hello World!") Hello World! 檔案形式 object HelloWorld { /* 這是我的第一個 Scala 程式 * 以 ......

    uj5u.com 2023-04-20 07:23:58 more
  • 理解函式指標和回呼函式

    理解 函式指標 指向函式的指標。比如： 理解函式指標的偽代碼 void (*p)(int type, char *data); // 定義一個函式指標p void func(int type, char *data); // 宣告一個函式func p = func; // 將指標p指向函式func ......

    uj5u.com 2023-04-20 07:23:52 more
  • Django筆記二十五之資料庫函式之日期函式

    本文首發于公眾號：Hunter后端 原文鏈接：Django筆記二十五之資料庫函式之日期函式 日期函式主要介紹兩個大類，Extract() 和 Trunc() Extract() 函式作用是提取日期，比如我們可以提取一個日期欄位的年份，月份，日等資料 Trunc() 的作用則是截取，比如 2022-0 ......

    uj5u.com 2023-04-20 07:23:45 more
  • 一天吃透JVM面試八股文

    什么是JVM？ JVM，全稱Java Virtual Machine（Java虛擬機），是通過在實際的計算機上仿真模擬各種計算機功能來實作的。由一套位元組碼指令集、一組暫存器、一個堆疊、一個垃圾回收堆和一個存盤方法域等組成。JVM屏蔽了與作業系統平臺相關的資訊，使得Java程式只需要生成在Java虛擬機 ......

    uj5u.com 2023-04-20 07:23:31 more
  • 使用Java接入小程式訂閱訊息！

    更新完微信服務號的模板訊息之后，我又趕緊把微信小程式的訂閱訊息給實作了！之前我一直以為微信小程式也是要企業才能申請，沒想到小程式個人就能申請。 訊息推送平臺🔥推送下發【郵件】【短信】【微信服務號】【微信小程式】【企業微信】【釘釘】等訊息型別。 https://gitee.com/zhongfuch ......

    uj5u.com 2023-04-20 07:22:59 more
  • java -- 緩沖流、轉換流、序列化流

    緩沖流 緩沖流, 也叫高效流, 按照資料型別分類： 位元組緩沖流：BufferedInputStream，BufferedOutputStream 字符緩沖流：BufferedReader，BufferedWriter 緩沖流的基本原理，是在創建流物件時，會創建一個內置的默認大小的緩沖區陣列，通過緩沖 ......

    uj5u.com 2023-04-20 07:22:49 more
  • Java-SpringBoot-Range請求頭設定實作視頻分段傳輸

    老實說，人太懶了，現在基本都不喜歡寫筆記了，但是網上有關Range請求頭的文章都太水了 下面是抄的一段StackOverflow的代碼...自己大修改過的，寫的注釋挺全的，應該直接看得懂，就不解釋了 寫的不好...只是希望能給視頻網站開發的新手一點點幫助吧. 業務場景：視頻分段傳輸、視頻多段傳輸（理 ......

    uj5u.com 2023-04-20 07:22:42 more
  • Windows 10開發教程_編程入門自學教程_菜鳥教程-免費教程分享

    教程簡介 Windows 10開發入門教程 - 從簡單的步驟了解Windows 10開發，從基本到高級概念，包括簡介，UWP，第一個應用程式，商店，XAML控制元件，資料系結，XAML性能，自適應設計，自適應UI，自適應代碼，檔案管理，SQLite資料庫，應用程式到應用程式通信，應用程式本地化，應用程式 ......

    uj5u.com 2023-04-20 07:22:35 more

Copyright © 2010-2020 有解無憂