概要
Dio Smart Retry は、Dio HTTP クライアント向けのリトライユーティリティで、事前に定義された条件に基づいてリクエストを自動的に再試行するように設計されています。デフォルトでは、5xx サーバーエラーまたはネットワークタイムアウトなど、リトライ可能な HTTP ステータスコードに対してのみリトライを行います。シンプルさと信頼性を重視して開発されており、既存の Dio 設定にスムーズに統合できます。このパッケージは Android、iOS、Web、macOS、Windows、Linux といったすべての主要プラットフォームをサポートしており、クロスプラットフォームな Flutter アプリにおける堅牢なネットワーク操作に最適です。
用途
- 一時的なネットワーク障害の処理
- サーバーエラーに対する再試行の自動化
- 接続状態が悪いときのアプリの回復力向上
- API 呼び出しにおけるエラー処理の簡素化
- ビジネスコード内の手動リトライロジックの削減
主な機能
- 再試可能HTTPステータスの自動リトライ
- Dioとの簡単な統合
- 複数のプラットフォームをサポートしています
- 設定可能な再試行動作
- 軽量でオーバーヘッドが最小限
適している対象
- 頻繁なAPI呼び出しを持つFlutterアプリ
- 信頼性のあるネットワーク通信を必要とするアプリ
- シンプルな再試行ロジックを求める開発者
- HTTPリクエストにDioを使用しているプロジェクト
- ボイラープレートエラー処理を減らしたいチーム
注意事項
- デフォルトでは、クライアントエラー（4xx）に対して再試行しません
- カスタム再試行ロジックには追加の構成が必要です
- DioベースのHTTPクライアントに限定
- 高遅延環境向けに調整が必要になる可能性があります
- 基本的な再試行を超える組み込みのバックオフ戦略はありません