Rust/Axum Tip: Mutate State In Route Handlers
Zusammenfassung
Kurz
Der vollständige Beitrag demonstriert eine veränderbare In-Memory-Zählerliste in Axum, die Handler mit `Arc` und `tokio::sync::Mutex` gemeinsam nutzen. Der Autor empfiehlt den Tokio-Mutex für komplexere asynchrone Handler und nennt `tokio::sync::RwLock` als Alternative für getrennte Lese- und Schreibzugriffe; die Hinweise sind nicht durch dokumentierte Tests oder Messungen belegt.
Mittel
Der vollständige Beitrag zeigt, wie Axum-Handler auf gemeinsam veränderbaren Zustand zugreifen können. Als Beispiel dient eine In-Memory-Liste von Zählern in `AppState`, die über `Arc<tokio::sync::Mutex<_>>` geteilt wird. Drei Handler lesen die Liste aus, fügen einen Zähler mit dem Wert 5 hinzu oder erhöhen den ersten Zähler. Ist die Liste beim Aktualisieren leer, gibt der Handler eine JSON-Fehlermeldung zurück.
Der Autor empfiehlt `tokio::sync::Mutex` statt `std::sync::Mutex`. Für den einfachen Beispielcode seien laut ihm beide verwendbar; bei komplexeren Handlern, etwa mit Sitzungen aus `tower_sessions`, könne der Standard-Mutex jedoch einen Fehler auslösen, wonach ein Future nicht sicher zwischen Threads gesendet werden könne. Für getrennte Lese- und Schreibzugriffe nennt er `tokio::sync::RwLock` als Möglichkeit. Diese Hinweise beruhen auf der Erfahrung des Autors: Der Beitrag dokumentiert weder Tests noch Messungen oder eine umfassende Prüfung. Er behandelt eine einfache Laufzeitdatenstruktur, keine weitergehenden Datenbankanforderungen.
Ausführlich lesen
Der vollständige Bericht ist ein kurzer Praxisbeitrag von Itsuki zur gemeinsamen Zustandsverwaltung in Axum-Route-Handlern. Als Anlass nennt der Autor Tests, bei denen eine einfache, während der Laufzeit veränderbare Datenbank nachgebildet werden soll. Eine globale Variable wie in Express/Node.js sei in Rust nicht der passende Weg. Der Beitrag verweist auf ein offizielles Tokio/Axum-Beispiel für einen Key-Value-Speicher, berichtet aber, dass dieses bei komplexeren Handlern – etwa mit Sitzungen aus dem `tower_sessions`-Extractor – für den eigenen Bedarf nicht mehr funktioniert habe.
Der gezeigte Code legt einen `AppState` mit einer gemeinsam genutzten `Vec<Counter>` an und übergibt ihn dem Axum-Router. Die Liste liegt in `Arc<tokio::sync::Mutex<_>>`. Drei Handler veranschaulichen den Zugriff: Der GET-Handler sperrt die Liste, kopiert sie und gibt sie als JSON zurück. Der INSERT-Handler fügt einen Zähler mit dem Wert 5 am Anfang der Liste ein und liefert anschließend eine Kopie zurück. Der UPDATE-Handler sucht den ersten Zähler, erhöht dessen Wert um eins und gibt die Liste aus; falls kein Zähler vorhanden ist, antwortet er mit einer Fehlermeldung als JSON. Im Beitrag wird außerdem vorgeschlagen, für getrennte Lese- und Schreibzugriffe gegebenenfalls `tokio::sync::RwLock` zu verwenden.
Die zentrale Empfehlung des Autors lautet, in diesem asynchronen Beispiel `tokio::sync::Mutex` statt `std::sync::Mutex` zu verwenden. Für den einfachen gezeigten Code funktionierten laut Beitrag beide Varianten. Bei komplexeren Handlern mit dem genannten Session-Extractor könne die Verwendung des Standard-Mutex jedoch zu einem Fehler führen, wonach ein Future nicht sicher zwischen Threads gesendet werden könne. Der Bericht bietet dazu eine konkrete Codeillustration, aber keinen dokumentierten Testlauf, keine Messwerte und keine systematische Gegenüberstellung der Mutex-Varianten. Die Aussagen zu komplexeren Handlern und zum Fehlerbild sind daher als Erfahrungsbericht und Empfehlung des Autors wiedergegeben, nicht als umfassender Nachweis für alle Axum-Anwendungen. Der Beitrag behandelt eine einfache In-Memory-Liste; weitergehende Datenbank- oder Produktionsanforderungen werden nicht erörtert.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Lunas beide Zusammenfassungen geben den Bericht im Kern korrekt wieder und erfinden keine Angaben. Die Kurzfassung lässt den std-Mutex-Fehler aus, die mittlere Fassung nennt ihn. Die Einordnung ist leer, weil im Prüfauftrag keine Fragen angegeben wurden und deshalb nichts zu bewerten ist.
Im Bericht, aber nicht in der Zusammenfassung
- In der Kurzfassung fehlt die zentrale Aussage, dass std::sync::Mutex in komplexeren Handlern (etwa mit tower_sessions) den Fehler 'future cannot be sent between threads safely' auslösen kann
- Der Motivationshintergrund des Autors (Dummy-Datenbank zum Testen, Vergleich mit Express/NodeJS) fehlt in beiden Fassungen
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.