Pakete, Repositories und App-Kategorien suchen

ducafecatFlutter-Ökosystem
Paketdetailsv2.0.8

dio_retry_plus

Ein Plugin für Dio, das fehlgeschlagene Anfragen wiederholt.

AndroidiOSWebmacOSWindowsLinux
pub.dev API-Dokumentation Quellcode
30-Tage-Downloads
837
Likes
29
Pub-Punkte
120

Paket installieren

flutter pub add dio_retry_plus

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

dio_retry_plus ist ein Flutter-Paket, das Dio, einen beliebten HTTP-Client, erweitert, indem es automatische Wiederholungsfunktionen für fehlgeschlagene Anfragen hinzufügt. Es verbessert die Zuverlässigkeit bei Netzwerkoperationen, indem Anfragen basierend auf konfigurierbaren Bedingungen wie Fehlerart, Statuscode oder Timeout wiederholt werden. Das Plugin unterstützt verschiedene Wiederholungsstrategien und Backoff-Mechanismen und ist daher ideal für Anwendungen, die eine robuste Netzwerkresilienz erfordern. Es integriert sich nahtlos in bestehende Dio-Einstellungen und funktioniert auf allen wichtigen Plattformen wie Android, iOS, Web, macOS, Windows und Linux.

Anwendungsfälle

  • Behandlung vorübergehender Netzwerkfehler
  • Verbesserung der Zuverlässigkeit des API-Aufrufs
  • Verringern der Frustration des Benutzers bei fehlgeschlagenen Anfragen
  • Unterstützung von Offline-First-Anwendungs-Mustern
  • Automatisierung der Wiederholungslogik für Hintergrundaufgaben

Hauptmerkmale

  • Konfigurierbare Wiederholungsbedingungen
  • Exponentielle Backoff-Unterstützung
  • Anpassung der Wiederholungsbeschränkung
  • Integration mit Dio-Middleware
  • Automatische Wiederholung bei Zeitüberschreitung oder Verbindungsfehlern

Geeignet für

  • Apps mit unzuverlässigen Netzwerkverbindungen
  • API-Clients, die Fehlertoleranz benötigen
  • Hintergrund-Daten-Synchronisationsdienste
  • Anwendungen zur Echtzeit-Datenabruf
  • Entwickler, die Dio für HTTP-Operationen verwenden

Hinweise

  • Kann die Latenz erhöhen, wenn Wiederholungen zu häufig sind
  • Erfordert sorgfältige Konfiguration, um Endlosschleifen zu vermeiden
  • Nicht geeignet für ausschließlich idempotente Operationen
  • Kann die Akkulaufzeit auf mobilen Geräten beeinträchtigen
  • Benötigt Tests unter simulierten Netzwerkausfall-Szenarien

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

dio_retry_plus

A plugin for dio that retries failed requests.

Usage

import 'package:dio_retry_plus/dio_retry_plus.dart';
Basic configuration
final dio = Dio()
  ..interceptors.add(RetryInterceptor());
Global retry options
final dio = Dio()
  ..interceptors.add(RetryInterceptor(
    options: const RetryOptions(
      retries: 3, // Number of retries before a failure
      retryInterval: const Duration(seconds: 1), // Interval between each retry
      retryEvaluator: (error) => error.type != DioErrorType.CANCEL && error.type != DioErrorType.RESPONSE, // Evaluating if a retry is necessary regarding the error. It is a good candidate for updating authentication token in case of a unauthorized error (be careful with concurrency though)
    )
  )
);
Sending a request with options
final response = await dio.get("http://www.flutter.dev", options: Options(
    extra: RetryOptions(
      retryInterval: const Duration(seconds: 10),
    ).toExtra(),
  ));
Sending a request without retry
final response = await dio.get("http://www.flutter.dev", options: Options(
    extra: RetryOptions.noRetry().toExtra(),
  ));
Logging retry operations
final dio = Dio()
  ..interceptors.add(RetryInterceptor(logger: Logger("Retry")));

Features and bugs

Please file issues.

Kategorien

HTTP-Client und HilfsmittelDio

Abhängigkeiten

Abhängigkeiten 1 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden

Noch keine Daten verfügbar.