所有的支付系統(tǒng)都對接了很多的外部支付、流出、外匯等各種類型的渠道，這些渠道的接口和報文格式各異。今天和大家一起聊聊如何實現(xiàn)一種簡潔高效的低代碼報文網(wǎng)關(guān)設計，主要包括：報文網(wǎng)關(guān)的定位，三種形態(tài)，低代碼報文網(wǎng)關(guān)的設計思路，系統(tǒng)架構(gòu)，核心代碼實現(xiàn)。
如果你做過支付系統(tǒng)并寫過腳本或代碼對接過渠道，或者你好奇如何通過低代碼來對接外部千奇百怪的渠道，歡迎一起探索。
1. 前言
在數(shù)字支付領(lǐng)域的深處，存在著一個關(guān)鍵的、卻往往被忽視的英雄——報文網(wǎng)關(guān)。作為支付系統(tǒng)與外部世界溝通的橋梁，報文網(wǎng)關(guān)承擔著參數(shù)轉(zhuǎn)換、報文組裝與解析、安全加密、簽名驗簽等多重重要任務。
一般來說，小型公司可能根本就沒有報文網(wǎng)關(guān)這一說法，直接引入HttpClient包，手擼幾個類，就把一個渠道對接搞定。稍大的公司，可能做一些模板方法的抽象，或者一些組件的抽象，也能實現(xiàn)一定的高效接入及復用。但對于更大型跨國公司，如果接入的渠道有幾百條，這樣手寫接入渠道，往往伴隨著代碼高復雜性和高維護成本。因應這一挑戰(zhàn)，"低代碼報文網(wǎng)關(guān)"的概念應運而生。
在本文中，我們將一起探索這種低代碼報文網(wǎng)關(guān)的創(chuàng)新設計。我們會從報文網(wǎng)關(guān)在支付系統(tǒng)中的角色和重要性入手，然后深入探討低代碼報文網(wǎng)關(guān)的工作原理、產(chǎn)品架構(gòu)、系統(tǒng)架構(gòu)以及核心代碼實現(xiàn)。我們的目標不僅是理解其技術(shù)細節(jié)，更是領(lǐng)悟其背后的設計哲學——如何在保證系統(tǒng)強大功能的同時，實現(xiàn)更高的接入效率和可維護性。
這篇文章旨在為廣大支付技術(shù)從業(yè)者、軟件開發(fā)者以及對支付系統(tǒng)感興趣的讀者們，提供一個全新視角來理解和應用低代碼報文網(wǎng)關(guān)。
2. 報文網(wǎng)關(guān)在支付系統(tǒng)中的定位
報文網(wǎng)關(guān)最核心的職責就是對接外部渠道的API接口，把內(nèi)部的請求發(fā)出去，把渠道返回的數(shù)據(jù)轉(zhuǎn)成內(nèi)部的參數(shù)。
這里面還涉及到很多技術(shù)細節(jié)，比如參數(shù)轉(zhuǎn)換、簽名驗簽、加密解密、報文組裝解析，發(fā)送接收等。
在前面的兩篇文章中，我們介紹了渠道網(wǎng)關(guān)，兩者的區(qū)別在于：
渠道網(wǎng)關(guān)：是一個更大范圍的網(wǎng)關(guān)，還包括渠道路由、渠道開關(guān)、渠道咨詢等能力。
報文網(wǎng)關(guān)：是渠道網(wǎng)關(guān)的一部分，只負責對接渠道的接口，小團隊可能只是一個小模塊，大團隊可能會獨立出應用。
3. 報文網(wǎng)關(guān)的幾種形態(tài)
一般來說，從簡單到復雜、從固定到靈活，報文網(wǎng)關(guān)會存在四種形態(tài)：
- 純手擼代碼：
- 在這種最初級的形態(tài)中，每個外部渠道都需要單獨的代碼實現(xiàn)。這意味著為每個新接入的銀行或支付服務，開發(fā)團隊需要編寫一套新的接口邏輯。
- 優(yōu)點：針對性強，可以精確控制每個渠道的交互細節(jié)。
- 缺點：隨著接入渠道的增多，代碼變得越來越復雜，維護和擴展的成本急劇上升。
- 模板方法報文網(wǎng)關(guān)：
- 這種形態(tài)通過引入模板方法模式，將報文處理流程的共通部分抽象出來，為各個渠道提供統(tǒng)一的處理框架，同時留有接口供具體渠道實現(xiàn)其特定邏輯。
- 優(yōu)點：提高了代碼的重用性，降低了維護成本。
- 缺點：對于一些特殊需求，模板方法可能仍然不夠靈活，需要額外的定制。
- 低代碼報文網(wǎng)關(guān)：
-
- 低代碼報文網(wǎng)關(guān)把所有核心的代碼邏輯實現(xiàn)后，只需要寫幾個配置文件，就可以完成渠道的接入。
- 優(yōu)點：極大地提高了靈活性和易用性，加快了新渠道的接入速度，核心代碼由有經(jīng)驗的資深員工編寫，減少出錯可能性。
- 缺點：復雜場景下可能需要寫一些內(nèi)聯(lián)函數(shù)，造成了一定復雜度。
- 產(chǎn)品化配置報文網(wǎng)關(guān)：
-
- 在低代碼報文網(wǎng)關(guān)基礎上，提供圖形化配置界面，進一步降低使用難度。
- 優(yōu)點：極大地提高了易用性，加快了新渠道的接入速度，以前寫代碼可能需要4、5天才接一個接口，變成可能0.5天就能接一個接口。
- 缺點：平臺的初始研發(fā)成本很高，如果總體接入的渠道不多，ROI可能不高。
每種形態(tài)都反映了各公司在特定時期的技術(shù)水平和方案造型，但總體來說，對于中大型公司來說，低代碼報文網(wǎng)關(guān)和產(chǎn)品化配置報文網(wǎng)關(guān)是一個比較不錯的選擇。一方面可以提高效率，另一方面也有足夠的研發(fā)資源來建平臺。
4. 一種低代碼報文網(wǎng)關(guān)設計思路
首先我們要知道報文網(wǎng)關(guān)核心只做這么幾件事：
- 接收內(nèi)部應用的請求。
- 內(nèi)部標準參數(shù)轉(zhuǎn)成外部渠道的參數(shù)。比如內(nèi)部叫mobileNo，渠道可能叫：mobile_id。
- 特定字段加密（可選，由渠道定）。
- 組裝需要簽名的明文字符串并簽名。
- 組裝發(fā)送報文，比如有json，kv，xml等。
- 對報文整體加密（可選，由渠道定）。
- 發(fā)送請求，并接收請求。
- 對報文整體解密（可選，由渠道定）。
- 解析報文。
- 組裝驗簽明文字符串并驗簽。
- 特定字段解密（可選，由渠道定）。
- 外部返回參數(shù)轉(zhuǎn)成內(nèi)部標準參數(shù)。
- 返回給內(nèi)部應用。
通過上面的流程分析，我們很容易想到流程引擎或責任鏈處理，再加一個上下文，就可以實現(xiàn)全部的操作。
具體包括：
- 可視化配置：提供直觀的用戶界面，允許用戶通過圖形化方式配置報文的處理流程，無需編寫復雜的代碼。
- 模塊化處理邏輯：將報文處理的各個步驟模塊化，如報文解析、加密/解密、數(shù)據(jù)映射等，用戶可以根據(jù)需要組合這些模塊來構(gòu)建完整的處理流程。
- 靈活的適配能力：支持靈活地適配不同的支付渠道，包括但不限于銀行接口、電子錢包、第三方支付平臺等。
- 動態(tài)配置管理：所有配置信息動態(tài)管理，支持實時更新，無需重啟系統(tǒng)或重新部署。
5. 低代碼報文網(wǎng)關(guān)的系統(tǒng)架構(gòu)
說明：
- 最上層是API：核心服務和管理服務分離。
- 核心上下文：主要是用于保存接口配置，原始請求，中間處理結(jié)果等。
- 核心處理Handler：參數(shù)轉(zhuǎn)換、加密、解密等全部基礎功能全部組件化。
- 流程引擎：負責串起所有的Handler依次運行。
- 內(nèi)聯(lián)函數(shù)：解決特殊場景下的報文轉(zhuǎn)換。
- 配置中心：配置內(nèi)部接口，外部接口，參數(shù)映射等。
- 流程管控：發(fā)布、回滾、權(quán)限管理等能力。
通過這種系統(tǒng)架構(gòu)，低代碼報文網(wǎng)關(guān)不僅能夠提供強大靈活的配置能力，還能確保處理流程的穩(wěn)定執(zhí)行，同時保持高度的可維護性。這樣的架構(gòu)使得報文網(wǎng)關(guān)能夠適應不斷變化的業(yè)務需求，同時降低了總體的維護成本和技術(shù)復雜性。
6. 低代碼報文網(wǎng)關(guān)的核心代碼實現(xiàn)
代碼實現(xiàn)有很多種方式，且報文網(wǎng)關(guān)也是一個獨立的應用，把所有的代碼展示出來也不太現(xiàn)實。這里給出上面系統(tǒng)架構(gòu)圖中的核心代碼示例。讀者可以擴展實現(xiàn)細節(jié)，有興趣的同學也可以私信我。
整體思路如下：
- 設計數(shù)據(jù)庫表結(jié)構(gòu)：用于存儲內(nèi)部接口定義，外部接口定義，接口映射關(guān)系，外部渠道參數(shù)等。這部分在這里略過。
- 設計運行上下文：GatewayContext（保存處理的上下文信息，包括接口配置、內(nèi)部請求參數(shù)、加解密臨時數(shù)據(jù)、加驗簽臨時數(shù)據(jù)、發(fā)送渠道報文、渠道返回原始報文、解析后報文等）。
- 設計各種處理Handler：內(nèi)部參數(shù)轉(zhuǎn)外部參數(shù)Handler，加密Handler，簽名Handler，報文組裝Handler，發(fā)送Handler，報文解析Handler，驗簽Handler，解密Handler，外部參數(shù)轉(zhuǎn)內(nèi)部參數(shù)Handler等。
- 設計Handler工廠類：GatewayHandlerFactory（通過getHandlers()獲取處理的責任鏈）。
- 設計內(nèi)聯(lián)函數(shù)：用于處理一些復雜操作。比如外部渠道返回的幣種和金額兩個字段轉(zhuǎn)成內(nèi)部的一個Money類。這部分在這里略過。
下面是核心代碼組件包括GatewayContext、GatewayHandlerFactory 和一系列的 GatewayHandler 基本實現(xiàn)：
GatewayContext 類用于保存處理過程中的上下文信息，包括臨時參數(shù)、報文信息等。
public class GatewayContext {
// 接口配置信息
private InterfaceInfo interfaceInfo;
// 原始請求
private Map<String, Object> originalRequestParam;
// 轉(zhuǎn)換后參數(shù)
private String requestParam;
// 簽名明文
private String signPlanContext;
// 省略部分參數(shù)，以及getter和setter方法
... ...
}GatewayHandlerFactory 是一個工廠類，用于構(gòu)建處理責任鏈。
public class GatewayHandlerFactory {
private static final List<GatewayHandler> handlers = new ArrayList<>();
static {
handlers.add(new ParameterTransformHandler());
handlers.add(new EncryptionHandler());
handlers.add(new SignatureHandler());
// 添加其他handler
... ...
}
public List<GatewayHandler> getHandlers() {
// 添加其他handler
return handlers;
}
}GatewayHandler 接口定義了處理邏輯的執(zhí)行方法。
public interface GatewayHandler {
void execute(GatewayContext context);
}具體的 Handler 實現(xiàn)：
內(nèi)部參數(shù)轉(zhuǎn)外部參數(shù)Handler
public class ParameterTransformHandler implements GatewayHandler {
@Override
public void execute(GatewayContext context) {
// 實現(xiàn)內(nèi)部參數(shù)到外部參數(shù)的轉(zhuǎn)換邏輯
}
}簽名Handler
public class SignatureHandler implements GatewayHandler {
@Override
public void execute(GatewayContext context) {
// 不需要簽名
if (!context.isNeedSign()) {
return;
}
context.setSignMessage(sign(context.getSignPlainContext(),
context.getInterfaceInfo().getSignConfig()));
}
// 簽名方法略
}其它Handler的實現(xiàn)略。
執(zhí)行Service
public class GatewayServiceImpl implements GatewayService {
@Override
public GatewayResponse execute(GatewayRequest request) {
// 轉(zhuǎn)成網(wǎng)關(guān)的上下文
GatewayContext context = buildGatewayContext(request);
// 獲取責任鏈，依次執(zhí)行
List<GatewayHandler> handlers = GatewayHandlerFactory.getHandlers();
for(GatewayHandler hander : handlers) {
hander.execute(context);
}
// 轉(zhuǎn)換返回
return convertResponse(context.getResponseParam);
}
// 其它代碼略
... ...
}這些組件和處理器共同構(gòu)成了低代碼報文網(wǎng)關(guān)的核心功能，允許系統(tǒng)靈活地配置和處理支付系統(tǒng)與外部渠道之間的報文交換。通過這種設計，報文網(wǎng)關(guān)可以輕松適應不同支付渠道的接入和業(yè)務流程的變更，同時大大減少了傳統(tǒng)編碼方式所需的開發(fā)和維護工作。
7. 結(jié)束語
在本文中，我們深入探討了報文網(wǎng)關(guān)在支付系統(tǒng)中的重要性，從其在支付系統(tǒng)中的定位、不同形態(tài)的發(fā)展，到一種具體的低代碼設計思路，以及詳細的系統(tǒng)架構(gòu)。我們還看到了核心代碼的實現(xiàn)，展示了如何通過靈活的處理器和上下文管理，實現(xiàn)報文網(wǎng)關(guān)的關(guān)鍵功能。
產(chǎn)品化配置的低代碼報文網(wǎng)關(guān)通過提供直觀的配置界面和強大的后端處理能力，使得支付系統(tǒng)更加靈活，能夠快速適應新的支付渠道和業(yè)務模型。同時，它也降低了技術(shù)門檻，使得初始技術(shù)人員能夠更容易地參與到支付渠道的對接中，而不用擔心技術(shù)太菜可能導致的各種各樣的問題。
這是《百圖解碼支付系統(tǒng)設計與實現(xiàn)》專欄系列文章中的第（23）篇。點擊上方關(guān)注，和墨哥一起深入解碼支付系統(tǒng)的方方面面。文章來源：http://www.zghlxwxcb.cn/news/detail-826860.html
前一篇：《圖解渠道網(wǎng)關(guān)（二）：模型、狀態(tài)機與流程編排》文章來源地址http://www.zghlxwxcb.cn/news/detail-826860.html
到了這里，關(guān)于圖解報文網(wǎng)關(guān)：一種低代碼報文網(wǎng)關(guān)的創(chuàng)新設計的文章就介紹完了。如果您還想了解更多內(nèi)容，請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！
