套件概覽
Dio Refresh Bot 是一個 Flutter/Dart 套件,可簡化為 Dio HTTP 客戶端實作重新整理權杖機制。它提供了一個反應式、彈性的攔截器系統,可在不中斷進行中的請求情況下自動處理權杖過期與重新整理。透過與 Dio 無縫整合,確保安全且持續的 API 通訊。此套件支援多種平台,包含 Android、iOS、Web、macOS、Windows 與 Linux,非常適合需要強大驗證流程的跨平台應用程式。
適用情境
- 在 401 錯誤時自動重新整理權杖
- 處理API中的過期JWT令牌
- 使用 OAuth 保護 RESTful 服務
- 在應用重啟後保持已認證的會話
- 令牌刷新後的反應式請求重試
主要特色
- 響應式令牌刷新處理
- 可設定的重試邏輯
- 支援多種驗證類型
- 最小化樣板程式碼
- 跨平台相容性
適合對象
- 使用 JWT 或 OAuth2 的應用
- 需要自動驗證恢復的開發者
- 頻繁呼叫 API 的專案
- 優先考慮安全性與使用者體驗的團隊
- 具有複雜認證流程的 Flutter 應用
使用建議
- 需要正確的伺服器端權杖刷新端點
- 可能需要為邊緣情況自定義錯誤處理
- 依賴使用Dio作為HTTP客戶端
- 不適用於無狀態令牌系統
- 需要仔細設定以避免無限循環