本文試著用 5W1H 方式切入，試圖快速建立自己對 apijson 的整體認知，所以這不是一趟快速入門的 demo 之旅，而是顯得比較務虛的探索式知識體系整合過程。
十多年的徐匯網站建設經驗，針對設計、前端、開發(fā)、售后、文案、推廣等六對一服務，響應快，48小時及時工作處理。網絡營銷推廣的優(yōu)勢是能夠根據用戶設備顯示端的尺寸不同，自動調整徐匯建站的顯示方式，使網站能夠適用不同顯示終端，在瀏覽器中調整網站的寬度，無論在任何一種瀏覽器上瀏覽網站，都能展現優(yōu)雅布局與設計，從而大程度地提升瀏覽體驗。成都創(chuàng)新互聯公司從事“徐匯網站設計”,“徐匯網站推廣”以來，每個客戶項目都認真落實執(zhí)行。
持續(xù)更新中...
后端。
后端實現一種萬能查詢，并能減少絕大部分重復的常規(guī)數據CRUD功能及數據拼裝等開發(fā)過程，定義一套統一的規(guī)范讓前端來學習掌握，以后后端除了維護好這個 DSL 的運行時，就只需要做好數據實體的定義及權限維護可以了。
這里的前端，不一定只是 Web 前端開發(fā)，而是包含了更廣義的 Client 端開發(fā)的大前端開發(fā)人員，比如安卓客戶端開發(fā)人員、甚至包含部分在平臺上做小應用的后端開發(fā)人員。
前端是時候 Get 一門新技能了。
官方：
APIJSON 是一種專為 API 而生的 JSON 網絡傳輸協議 以及 基于這套協議實現的 ORM 庫。
據個人理解，它定義了一整套 DSL 作為 API Client 的查詢語言（Query Language）的規(guī)范(Specification)，同時也是的一款對應的后端具體實現(Implementation for the Spec at server side)。
是的，這會讓人想起 GraphQL，如果做一些對比工作的話，會發(fā)現他們在 Spec 還是有重疊的部分的。 當然，一般國產的都是精品，APIJSON 也不會例外，APIJSON 在功能、安全、性能、易用性、Java 版生態(tài)(繼承 JSON 的相關生態(tài)) 等方面都會比 GraphQL 更實用易用。
因此，可以考慮為這種 QL 取個名字，比如 ApijsonQL、或者短一點 apiQL。我選 apiQL。
Client 應用使用 apiQL 查詢語言來請求支持 apiQL 的服務。
apiQL 是基于 JSON 數據格式定義的一種 DSL，對于 Cleint 開發(fā)人員來說，語法學習成本極低。剩下的，主要是熟悉領域特定的部分。
請求：
重慶分公司
重慶分公司
{
"[]":{
"page":0,
"count":3,
"Moment":{},
"User":{
"id@":"/Moment/userId"
},
"Comment[]":{
"count":3,
"Comment":{
"momentId@":"[]/Moment/id"
}
}
}
}
響應：
{
"[]":[
{
"Moment":{
"id":235,
"content":"xxx",
...
},
"User":{
...
},
"Comment[]":[
...
]
},
{
"Moment":{
"id":301,
"content":"xxx",
...
},
"User":{
...
},
...
},
...
],
"code":200,
"msg":"success"
}
apijson 如官方所述作為一款 ORM，其實質是將原來傳統開發(fā)模式中的三層架構中的數據持久化層直接開放給前端，即壓縮了領域層和表現層（很薄，僅做可選的權限校驗，但是可以通過重寫方法來自定義權限），幾乎是讓前端的視線直接穿透到數據持久化層來進行他們的對接開發(fā)工作。
前端開發(fā)需要建立一種新習慣 - 主動進行數據查詢和拼接，而非像以前那般，等待后端拼接好再給出來。當然，也可以延續(xù)傳統的開發(fā)習慣，由后端人員整理接口格式和生成文檔，再有前端去調用，可以無縫銜接；不同的是，后端開發(fā)人員并沒有“開發(fā)”的過程，只有寫文檔的過程。
具體如何實踐，可以按團隊實際情況來做選擇。
借鑒 Restful Api 中的 verbs 術語，實際請求時全用HTTP POST請求。
實際使用時，最好在前端封裝一套對應的 QueryBuilder，得到更 OO-Style 的體驗，而不是記憶一堆“方言”詞匯， 如 apijson-builder。
非金融類場景；中小型前后端分離的項目，尤其是 初創(chuàng)項目、內部項目、低代碼/零代碼、小程序、BaaS、Serverless 等。
APIJSON-ToDo-Demo 一個簡單的 todo 示例項目，精簡數據，簡化上手流程，帶自定義鑒權邏輯
apijson-examples APIJSON 的前端、業(yè)務后端、管理后端 Demo
TODO
APIJSON 后端教程（1）：簡介
https://www.bilibili.com/video/BV1vL411W7yd
APIJSON 后端教程（2）：數據庫
https://www.bilibili.com/video/BV1eB4y1N77s
APIJSON 后端教程（3）：Demo
https://www.bilibili.com/video/BV1FX4y1c7ug
APIJSON 后端教程（4）：Boot
https://www.bilibili.com/video/BV18h411z7FK
APIJSON 后端教程（5）：Final
https://www.bilibili.com/video/BV1GM4y1N7XJ
APIJSON 后端教程（6）：uliweb_apijson
https://www.bilibili.com/video/BV1yb4y1S79v/
APIJSON 后端教程（7）：問題答疑
https://www.bilibili.com/video/BV1dQ4y1h7Df
https://hanxu2018.github.io/APIJSON-DOC/md/QA/#q-a-常見問題
