範例應用程式導覽
隨 SQLly Embedded 附帶的範例管理後台應用程式逐畫面導覽:狀態與授權、設定檔與連線、標籤、使用者,以及啟動 SQLly。
此套件包含一個小型管理應用程式(sample-app/,Node.js 20+、無相依套件),會實際演練 SQLly Embedded 能做的所有事。它扮演的角色是 你的 應用程式:一個用於設定檔、標籤和使用者的管理端,以及一個讓使用者登入並開啟 SQLly 的使用者端。下面的每個畫面都是在一或兩個 管理 API 呼叫,每張螢幕截圖下方都會標出名稱,讓你看得出自己的應用程式會呼叫哪些。
這些螢幕截圖來自實際運作的橋接器(綁定試用授權),背後是一個 SQL Server Northwind 資料庫。
管理員登入
狀態與授權
狀態 是 GET /manage/status 會渲染成一個頁面。未以金鑰或授權檔啟動的橋接器 未授權:你已經可以建立並測試設定檔,但安裝尚未連結之前,SQLly 不會啟動。
連線到 sqlly.app 會向 sqlly.app 索取一組連結碼(POST /api/embedded/links)並顯示它。 請開啟 sqlly.app 進行核准 會帶領授權擁有者前往 sqlly.app,在那裡確認相同的代碼並選擇授權:
幾秒後,管理應用程式會收集該安裝的金鑰,連同 PUT /manage/license,而 Status 會顯示授權資訊:
設定檔
設定檔是一組使用者所看到的連線集合。清單顯示每個設定檔的連線以及被指派的人員, 啟動 就能以你自己的身分搭配該設定檔開啟 SQLly。
編輯連線
連線編輯器會提供所選引擎的認證資訊格式支援的每個欄位。引擎清單與每個引擎的登入類型來自 GET /manage/engines. 測試 檢查表單上已有的資料,不論是否已儲存,並在行內顯示該引擎本身的回答:
標籤
客戶、專案及環境在 SQLly 中為連線上色並分組,並攜帶安全規則。範例應用程式保留一組共用設定,並隨每個設定檔傳送,因此重新命名標籤會更新使用該標籤的所有連線。
使用者與席位
範例應用程式的使用者是它自己的帳戶,每個帳戶各指派一個設定檔。在你的應用程式中,使用者及其存取權就是你現有的機制。這個頁面也會顯示目前誰佔用了席位(GET /manage/seats),並 釋放席位 (DELETE /manage/seats/{user}).
你的使用者所看到的內容
使用者在應用程式根目錄登入,而不是在 /admin 下:
SQLly 開啟期間,狀態會顯示正在使用的席位:
閱讀程式碼
| 檔案 | 從中得到的重點 |
|---|---|
lib/bridge.js | 完整的管理 API 用戶端:每個呼叫、錯誤處理、逾時,一應俱全。複製去用,或直接移植。 |
lib/credentials.js | 將表單欄位與共用標籤轉換為 sqlly-credentials 文件。 |
lib/sqllyapp.js | 連結流程的 sqlly.app 端:建立連結,輪詢取得金鑰。 |
server.js | 路由。 GET /app/ 是啟動的途徑; /admin/* 是管理端; /admin/link* 負責連結。 |
views/pages.js | HTML 內容,包括 injectLaunch,它會先把兩個全域變數設好,然後才 boot.js. |
test/ | node --test 這些測試套件會以假的橋接器執行應用程式,很適合作為測試你自己整合功能的範本。 |
準備好取代它了嗎? 建立你自己的應用程式 會逐一介紹你自己技術堆疊中的每項工作。