minor
#29552
TLPhotoViewer ruft sein Bild ab, nachdem das Steuerelement entsorgt wurde, wenn es durch ein „ <switch> “ ersetzt wird (404 bei react-api/data, Warnung „Command target NOT FOUND“).
Betrifft 8.0.0-SNAPSHOT (11.09.2026), tl-layout-react / tl-layout-view.
Reproduktion
Eine Ansicht mit einem <switch> über einem abgeleiteten Kanal, der in einem Fall <image input="receipt"/> und in einem anderen Fall <pdf input="receipt"/> rendert (die App „Expenses“, my-expenses.view.xml, rechter Bereich). Wählen Sie eine Zeile aus, deren Beleg ein Bild ist (der Bildbetrachter rendert es), und wählen Sie anschließend eine Zeile aus, deren Beleg ein PDF ist.
Der PDF-Viewer wird korrekt angezeigt, doch im Moment des Wechsels:
- wird in der Browserkonsole Folgendes protokolliert : „Failed to load resource: 404 … /react-api/data?controlId=v66&windowName=…“, gefolgt von [TLPhotoViewer] „Failed to fetch image: 404 (tl-react-controls.js:1054)“,
- der Server protokolliert : WARN SSEUpdateQueue – Befehlsziel „v66“ im Fenster „…“ NICHT GEFUNDEN: 48 Steuerelemente registriert, 37 angehängt.
v66 ist die ID des entsorgten Foto-Viewer-Steuerelements.
Analyse
Die Zeilenauswahl ändert einen Kanal, den zwei Listener beobachten. Der ImageElement-Listener aktualisiert den ` BinaryDataValue` des Fotobetrachters, wodurch der ` dataRevision` -Zustand erhöht wird und sofort ein `PatchEvent` an den Client gesendet wird (SSEUpdateQueue.enqueue führt eine sofortige Entleerung durch). Der „ReactSwitchControl“-Listener wechselt den aktiven Fall, verschiebt jedoch die Entsorgung des alten Teilbaums, bis die Kanalbenachrichtigung abgearbeitet ist (ChannelNotificationScope.afterNotification). Der Patch erreicht den Client daher für ein Steuerelement, dessen Registrierung durch dieselbe Interaktion gerade aufgehoben wird: Der clientseitige TLPhotoViewer-Effekt ruft das Bild mit der veralteten Steuerelement-ID ab, und bis die Anfrage eintrifft, hat der Server das Steuerelement bereits entfernt (404 + WARN).
Kanal-Listener werden in der Reihenfolge ihrer Registrierung ausgeführt. Abgeleitete Kanäle werden beim Laden der Ansicht registriert, der Fallinhalt erst später; daher hängt es von der Ansicht ab, ob zuerst der Viewer oder der Container benachrichtigt wird: Wenn der Viewer den Eingabekanal des Schalters liest, wird der Container zuerst ausgeführt; wenn der Viewer einen davon abgeleiteten Kanal liest, wird der Viewer zuerst ausgeführt. In der React-Demo reproduziert: Bei jedem Schalter erhielt der Client „PatchEvent {hasPhoto:false}“ und „{dataRevision:2}“ für den zu ersetzenden Viewer, noch bevor der „activeChild“-Patch des Containers eintraf. Die beiden SSE-Nachrichten werden in separaten Browser-Tasks verarbeitet, sodass das Abbrechen des Abrufs allein beim Unmount nicht verhindern kann, dass die Anfrage den Server erreicht.
Ein zweites Detail: „ImageElement“ akzeptierte beliebige „BinaryData“ als Bild, sodass ein PDF im Kanal „hasPhoto“ auf „true“ setzte und an ein <img> -Element übergeben wurde.
Dasselbe Muster im Formular: Felder werden an ein Objekt zurückgebunden, das das Formular verlässt
Das Löschen eines Tickets auf der Tickets-Seite der React-Demo führte zu folgendem Protokoll: ERROR ReactCommandInvoker – @ReactCommandHandler schlug fehl mit „Auswertung von ‚container($comment).comments‘ fehlgeschlagen … Zielobjekt wurde gelöscht“; der Löschvorgang selbst war erfolgreich und die Benutzeroberfläche wurde aktualisiert. Der Löschbefehl leert den Ticket-Kanal, die <object-list> des Konversationsfensters wird neu ausgewertet und setzt ihren Kommentarentwurf zurück, da sich der Container geändert hat, und das Erstellungsformular erhält den neuen Entwurf über seinen Eingabekanal. FormControl.handleInputChanged führte zunächst exitEditMode() aus, was eine vollständige Änderung des Formularzustands auslöst, während das Formular noch den alten Entwurf enthält: Jedes Feld wird erneut daran gebunden, und das Auswahlfeld von „Comment#cited“ berechnet seine Optionen neu, indem es den Container des Entwurfs – das gelöschte Ticket – auswertet. Die gleiche Zwischenbenachrichtigung lief in `onCurrentObjectDeleted` ab; `AttributeFieldControl` enthielt eine `tValid() `-Prüfung genau für diese Benachrichtigung, die ein gelöschtes gebundenes Objekt abdeckt, nicht jedoch einen gültigen Entwurf, dessen Container nicht mehr vorhanden ist. Die Berechnung von Werten für ein Objekt, das das Formular bald nicht mehr anzeigen wird, ist das Pendant auf Formularebene zum Patching eines getrennten Steuerelements.
Da der Composer ungespeicherte Eingaben enthielt, schlug dieselbe Löschung auf einem anderen Pfad fehl: Das Zurücksetzen des Entwurfs wurde durch das geänderte Formular verhindert, ein Dialogfeld „Ungespeicherte Änderungen“ wurde für ein Ticket geöffnet, das nicht mehr existierte, und „Verwerfen“ brach das Formular ab, dessen Benachrichtigung für den unveränderten Entwurf den gelöschten Container erneut auswertete. Modellereignisse werden erst nach Ausführung des Befehls synthetisiert, sodass kein Löschereignis das Formular vor dem Schreiben in den Kanal erreichen kann; der Entwurf selbst muss wissen, dass er zu einem gelöschten Objekt gehört.
Lösung
- Die Übermittlung wird pro Interaktion abgewickelt. ReactWindowRegistry.beginInteraction() gibt ein Interaction (AutoCloseable) zurück, das die Anforderungssperre der Sitzung hält und einen thread-lokalen DeliveryScope öffnet. Darin stellt SSEUpdateQueue.enqueue lediglich Elemente in die Warteschlange; wenn die äußerste Interaktion geschlossen wird, werden alle betroffenen Warteschlangen abgearbeitet: PatchEvents/ StateEvents, die an ein Steuerelement adressiert sind, das nicht mehr registriert oder nicht mehr angehängt ist, werden verworfen, der Rest wird geleert. Befehlsausführung, Routennavigation, Ansichtsauswahl, Upload, Fenster schließen, das Durchlaufen entladener Fenster, Skriptwiedergabe und das headless AgentServlet laufen alle als Interaktionen ab (getRequestLock() wird durch beginInteraction() ersetzt). Ereignisse, die außerhalb einer Interaktion in die Warteschlange gestellt werden (SSE-Verbindung, Heartbeat-Modell-Ereignis-Synthese), werden wie bisher sofort geleert. Innerhalb einer Interaktion gelangen die Aktualisierungen erst bei deren Beendigung an das Netzwerk, d. h. nachdem die HTTP-Antwort des Befehls geschrieben wurde.
- ReactControl sendet kein „PatchEvent“ bzw. keine erneute Zustandsübermittlung, solange es abgekoppelt ist (receivesUpdates()): Ein abgekoppeltes Steuerelement wird nicht angezeigt; ein Steuerelement, das wieder angezeigt wird, wird mit seinem vollständigen Zustand serialisiert.
- ContentControls.retire(ReactControl) trennt ersetzten Inhalt synchron ab und verschiebt lediglich dessen Entsorgung (cleanupTree) über ChannelNotificationScope.afterNotification; wird von ReactSwitchControl, ReactAdaptiveDetailControl und ReactTileStackControl verwendet.
- Der clientseitige TLPhotoViewer bricht einen laufenden Bildabruf ab, wenn sein Effekt bereinigt wird (AbortController), und protokolliert nichts für eine abgebrochene Anfrage.
- ImageElement behandelt nur BinaryData mit dem Inhaltstyp image/* als Bild (Groß-/Kleinschreibung wird nicht berücksichtigt, Parameter werden toleriert).
- Die Seite „Document Viewer“ der React-Demo (demo/pdf-demo.view.xml, Eintrag in der Seitenleiste „Dokumentanzeige“) ist ein geteiltes Fenster: Die Tabelle auf der linken Seite listet die Objekte des Demotyps demo.documents:Document auf (Name, Daten vom Typ tl.core:Binary), der Bereich auf der rechten Seite zeigt eine Vorschau des ausgewählten Objekts über einen <switch> basierend auf dem Inhaltstyp seiner Daten an – den Foto-Viewer für image/* und den PDF-Viewer für application/pdf. Beide Viewer lesen einen Kanal, der aus der Switch-Eingabe abgeleitet wird, sodass die Reihenfolge der Listener, die den Fehler reproduziert hat, in der App nachverfolgbar bleibt. Zwei Dokumente werden aus der Datei „WEB-INF/data/Z03-documents-demo.objects.xml“ geladen (ein SVG-Bild und ein PDF); der <upload-command> der Symbolleiste fügt pro hochgeladener Datei ein Dokument hinzu und wählt es aus, und ein Löschbefehl entfernt das ausgewählte Dokument. Das einzige Inhaltselement des Vorschaufensters ist der Schalter, sodass der PDF-Viewer die gesamte Höhe des Fensters ausfüllt.
- Binäre Werte im Instanzen-XML-Format behalten den Inhaltstyp und den Dateinamen bei. XMLInstanceExporter.serialize schreibt eine BinaryDataSource als Daten-URI im Format data:<type>;name=<prozentkodierter Name>;base64,… (BinaryDataURI in tl-basic); XMLInstanceImporter.parse liest sowohl dieses Format als auch die reine Base64-Zeichenkette bestehender Dateien (die als „application/octet-stream“ ohne Namen importiert werden). Ohne den Inhaltstyp würde ein vorbelegtes Bild vom Fotobetrachter nicht akzeptiert werden.
- TL-Script binaryContentType($data) und binarySize($data) (BinaryFunctions, @ScriptPrefix("binary")) lesen den Content-Type und die Größe eines binären Werts aus; beide sind null-sicher. Ein Content-Type kann Parameter enthalten (; charset=utf-8), daher wird eine Überprüfung auf eine bestimmte Art von Inhalt mit `stringStartsWith` geschrieben.
- SSEUpdateQueue.pendingEventCount() stellt die in der Warteschlange befindlichen Ereignisse für Tests bereit.
- Ein Formular, das ein Objekt verlässt, benachrichtigt dessen Felder einmalig über das neue Objekt. FormControl trennt das Abbauen der Bearbeitungssitzung (Overlay, Sperre, Eingabesperre, Validierungsmodell, Teilnehmer, Bearbeitungsmodus und „dirty“-Zustand) von der Benachrichtigung über den Formularzustand. Ein Wechsel des Eingabekanals und das Löschen des aktuellen Objekts bauen die Sitzung stillschweigend ab, wechseln das Objekt und lösen eine einzige Formularzustandsänderung aus, sodass kein Feld erneut an das verlassene Objekt gebunden wird; „Speichern“ und „Abbrechen“ behalten den Abbau sowie die Benachrichtigung bei, da das Objekt dort verbleibt und die Felder wieder ihre Basiswerte anzeigen.
- Ein transienter Teil vergeht mit seinem Ganzen. TransientTLObjectImpl.tValid() (sowie NewObject des Rasters und das andere in einem Container erstellte TransientObject ) ist nur dann wahr, solange der tContainer(), in dem das Objekt erstellt wurde, gültig ist oder gar nicht vorhanden ist; TLObject.tValid() dokumentiert diese Regel. Ein Formular, dessen aktuelles Objekt ungültig ist, enthält nichts, was gespeichert werden könnte: FormControl meldet sich als „clean“, veröffentlicht keinen „dirty“-Zustand und lehnt keinen Objektwechsel ab. Eine <object-list> behandelt einen gelöschten Container als nicht vorhanden (ListContainer.aliveOrNull): Es wird keine Elementfunktion darauf ausgewertet, es wird nichts dafür angezeigt, und der dafür erstellte Entwurf wird durch einen ersetzt, der niemandem gehört. Das Löschen des Tickets, während der Ersteller Eingaben enthält, öffnet somit keinen Dialog und protokolliert keinen Fehler.
- DefaultReactContext verfügt lediglich über den Konstruktor, der die ReactWindowRegistry entgegennimmt: Die Variante ohne Registry diente ausschließlich Testzwecken, und ihre Methode getModelScope() schlug mit einer NullPointerException fehl, sodass ein Steuerelement, das das Modell beim Anhängen beobachtet, damit nicht getestet werden konnte. Die Tests übergeben eine eigene ` ReactWindowRegistry`; der Fenster-Eintrag und sein Modellbereich werden beim ersten Zugriff erstellt.
Tests: TestInteractionDelivery, TestDetachedControlUpdates (tl-layout-react), TestContentControls, TestImageElement, TestFormObjectSwitch, TestObjectListControl (tl-layout-view), TestTransientObjectValidity (tl-core), TestBinaryDataURI (tl-basic), TestXMLInstanceImporter Round-Trip (tl-element), TestBinaryFunctions (tl-model-search). Im Browser im Dokumentenbetrachter der Demo überprüft: Der PDF-Rahmen füllt die Inhaltshöhe des Vorschaufensters aus, kein Patch für einen ersetzten Betrachter, kein 404-Fehler, keine WARN-Meldung beim Wechsel zwischen Bild und PDF; das Hochladen und Löschen eines Dokuments funktioniert; beim Neuladen der Seite nach einem Sprachwechsel bleibt der Fenstername erhalten, sodass die im Kommentar erwähnte zweite Variante nicht auftritt. Das Löschen eines Tickets auf der Tickets-Seite, mit und ohne ungespeicherte Eingaben im Editor, führt zu keiner Fehlermeldung und öffnet keinen Dialog; das anschließende Hinzufügen eines Kommentars funktioniert.
Anmerkungen
Bei der Überprüfung beobachtet, hier nicht geändert: Wenn ein Kanal-Listener in einen anderen Kanal schreibt und dieser Schreibvorgang abgelehnt wird (Auswahl eines anderen Tickets, während der Editor einen Entwurf enthält: Der Ticket-Kanal benachrichtigt die Objektliste, deren Entwurf das „Dirty-Form“-Veto auslöst), wird die `ChannelVetoException` über die Benachrichtigung des äußeren Kanals weitergeleitet. Der äußere Kanal enthält bereits den neuen Wert, seine verbleibenden Listener werden nicht benachrichtigt, und die Fortsetzung des Dialogs wiederholt nur den inneren Schreibvorgang. Nach „Verwerfen“ zeigt die URL das neu ausgewählte Ticket an, während die Markierung in der Tabelle und der Konversationsbereich weiterhin das vorherige anzeigen, bis die Auswahl erneut getroffen wird. Das Veto müsste vor dem äußeren Schreibvorgang abgefragt werden (ViewChannel.dirtyHandlers(), wie es OpenDialogAction bei Dialog-Bindungen tut), transitiv über die Schreibvorgänge der Listener hinweg.