Explicit XFA Host Transport

Unit: HPDFXFARuntime

Declaration

Options := TXFAWidgetRuntimeOptions.Default;
Options.ScriptOptions.EnableJavaScript := True;
Options.HostTransport := ApplicationHost.Transport;
Options.OnHostTransactionCompleted := ApplicationHost.Completed;

Behavior

Configureert expliciete applicatie-callbacks om xfa.host.messageBox, response, beep, print, gotoURL, submitForm, importData en exportData en FormCalc Get, Post en Put uit te voeren

De library roept automatisch geen dialoog, reader, netwerkrequest of bestandsoverdracht aan; de callback implementeert het application transport en geeft een getypeerde response terug

Elk gedispatcht request draait één keer binnen een omvattende runtime-transactie; QuickJS-suspensie-retries en gecommitte-session-replay consumeren geregistreerde responses zonder callbacks te herhalen

Requests behouden positionele argumenten als Unicode-strings, lege argumenten inbegrepen; request-sequentie begint op nul voor elke transactie

Gefaalde transacties herstellen document- en script-object-status en verwittigen de completion-callback met Committed=False; de applicatie moet diens externe effecten stagen of compenseren, want document-rollback kan een externe operatie niet ongedaan maken

Completion-callbacks draaien één keer na geslaagde documentvalidatie en -layout of na rollback, vóór normale succes-observators; callbacks mogen geen exceptions raisen of de runtime opnieuw binnenkomen

Host-callbacks vragen de meegeleverde QuickJS-session; custom JavaScriptEvaluator-callbacks leveren het checkpoint- en replay-contract niet

Request-aantal, argument-aantal, encoded request-bytes en response-bytes hebben onafhankelijke positieve limieten; callback-verstreken tijd telt mee voor de transactie-deadline, maar synchrone applicatiecode kan niet gedwongen worden onderbroken

Script-functies ontvangen number, Boolean, string, null of undefined volgens de response Kind; numerieke responses moeten eindig zijn en Unicode-responses moeten geldige surrogate pairs bevatten

Related APIs

Explicit XFA Host Transport, TXFAHostTransaction en Interactive Dynamic XFA Widget Runtime