Dio Refresh Bot は、Dio HTTP クライアント向けのリフレッシュトークンメカニズムの実装を簡素化する Flutter/Dart パッケージです。進行中のリクエストを妨げることなく、トークンの有効期限切れとリフレッシュを自動的に処理できるリアクティブで柔軟なインターセプター・システムを提供します。Dio とシームレスに統合されることで、安全かつ途切れのない API 通信を保証します。このパッケージは Android、iOS、Web、macOS、Windows、Linux を含む複数のプラットフォームをサポートしており、堅牢な認証ワークフローを必要とするクロスプラットフォームアプリケーションに最適です。
用途
- 401 エラー時にトークンを自動更新
- APIにおける有効期限切れのJWTトークンの処理
- OAuth を用いた RESTful サービスのセキュリティ保護
- アプリの再起動後に認証されたセッションを維持する
- トークン更新後のリアクティブなリクエストの再試行
主な機能
- リアクティブなトークン再読み込み処理
- 設定可能な再試行ロジック
- 複数の認証タイプをサポートしています
- 最小限のボイラープレートコード
- クロスプラットフォーム互換性
適している対象
- JWT や OAuth2 を使用するアプリ
- 自動認証回復が必要な開発者
- 頻繁なAPI呼び出しを持つプロジェクト
- セキュリティとUXを最優先とするチーム
- 複雑な認証フローを持つFlutterアプリ
注意事項
- 適切なサーバーサイドトークンリフレッシュエンドポイントが必要です
- エッジケースのためのカスタムエラーハンドリングが必要になる可能性があります
- DioがHTTPクライアントとして使用されていることに依存しています
- ステートレストークンシステムには適していません
- 無限ループを回避するためには注意深い構成が必要です
