在企業系統開發中,API 架構扮演關鍵角色。它不僅是前後端溝通的橋樑,更是跨模組、跨服務協作的核心。相較於 REST 著重資源導向、gRPC 聚焦高效能與嚴格協定,JSON-RPC 則提供一種更靈活且結構化的方案:以方法為核心設計,格式輕量、請求與 JSON 高度相容,極適合需要明確業務流程邏輯的應用系統。
除了架構彈性,JSON-RPC 更具備資料編碼上的延展性。在 Bee.NET 的設計中,JSON-RPC 的資料傳輸流程可支援 MessagePack 序列化、壓縮與加密,確保資料在內部系統或跨網路傳輸時兼顧「效能」、「安全」與「易於維護」。相較於 protobuf,MessagePack 在動態物件結構與 .NET 環境中更具開發友善性,且不需維護 .proto 檔案,開發流程更簡潔。
Bee.NET 架構同時支援「近端除錯」與「遠端部署」兩種呼叫模式,能大幅提升開發效率並降低部署成本。本文將以 jsonrpc-sample 專案為例,展示如何構建一套模組化、可維護、具備資料編碼與雙模式呼叫能力的 JSON‑RPC 架構。
📦 專案來源:jsonrpc-sample on GitHub
🧱 為何選擇 N‑Tier 架構與近/遠端雙模式?
在企業級系統(如 ERP/HRM)中,常見的 N‑Tier 架構會將應用程式邏輯分層: