Aus öffentlichen Paketdaten erstellte Orientierung.
Das async_queue-Paket stellt sicher, dass eine Reihe asynchroner Aufgaben nacheinander ausgeführt werden, wobei die Reihenfolge beibehalten und Konkurrenzprobleme vermieden werden. Es bietet einen einfachen Warteschlangenmechanismus zur kontrollierten Behandlung asynchroner Operationen, ideal für Szenarien, in denen Abhängigkeiten zwischen Aufgaben oder die Ausführungsreihenfolge entscheidend sind. Mit Dart entwickelt, integriert es sich nahtlos in Flutter-Projekte auf allen wichtigen Plattformen. Das Paket ist leichtgewichtig und auf Zuverlässigkeit ausgerichtet, was es für Hintergrundverarbeitung, das Sequenzieren von API-Aufrufen oder jedes andere Anwendungsfall geeignet macht, bei dem eine geordnete asynchrone Ausführung erforderlich ist.
Anwendungsfälle
Sequenzielle API-Aufrufe
Hintergrundaufgabenverarbeitung
Reihenfolgeabhängige Operationen
Zustandsverwaltung mit asynchronen Aktionen
Ressourcen in Folge laden
Hauptmerkmale
Gewährleistet sequenzielle Ausführung
Einfache Warteschlangenschnittstelle
Plattformübergreifende Unterstützung
Leichtgewichtig und minimale Abhängigkeiten
Thread-sichere Operation
Geeignet für
Entwickler, die geordnete asynchrone Ausführung benötigen
Apps mit abhängigen asynchronen Workflows
Projekte, die eine vorhersagbare Aufgabenscheduling erfordern
Flutter-Anwendungen für mehrere Plattformen
Teams, die Code-Einfachheit priorisieren
Hinweise
Nicht für parallele Aufgabenausführung
Beschränkt auf eine einzelne Warteschlange pro Instanz
Erfordert sorgfältige Verwaltung des Warteschlangen-Lebenszyklus
Am besten geeignet für kleine bis mittlere Aufgabenbatches
Behandelt keine Wiederholungslogik oder Fehlerwiederherstellung
Original-README
Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.
Async Queue - ensure your list of async tasks execute in order
This dart package ensures your pack of async tasks executes in order, one after the other.
What's new in v3.0.0
addJob returns a Future — await individual job results directly, no more listener workarounds
Automatic retry on exceptions — jobs that throw are retried up to retryTime without manual retry() calls
onError callback — handle errors at the queue level: AsyncQueue(onError: (error, label) { ... })
Priority queue — addJob(..., priority: 10) to run important jobs first
final asyncQ = AsyncQueue();
asyncQ.addQueueListener((event) => print("$event"));
Await job result (v3.0.0+)
addJob returns a Future that completes with the job's return value. This works alongside previousResult — they serve different purposes.
final q = AsyncQueue.autoStart();
// Each addJob returns a Future you can await for its resultfinal userFuture = q.addJob((_) async {
returnawait api.getUser(); // returns "Sam"
});
// previousResult still chains between jobsfinal postsFuture = q.addJob((previousResult) async {
returnawait api.getPostsFor(previousResult);
});
final user = await userFuture; // "Sam"final posts = await postsFuture; // [Post, Post, ...]
Automatic retry on exceptions (v3.0.0+)
Jobs that throw are automatically retried up to retryTime times. You no longer need to catch errors and call retry() manually (though you still can for custom logic).
q.addJob((_) async {
// if this throws, it will be retried automaticallyreturnawait api.fetchData();
}, retryTime: 3);
onError callback (v3.0.0+)
Handle errors at the queue level without parsing events:
This package would be useful if you have multiple widgets in a screen or even in multiple screens that need to do some async requests that are related to each other.
For examples:
To make one request from a widget wait for another request from another widget to finish.
To avoid multiple requests from the front end hitting the backend in a short time, which would confuse the backend.