Eksplicit XFA Host Transport

Unit: HPDFXFARuntime

Declaration

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

Adfærd

Konfigurér eksplicitte applikations-callbacks til at afvikle xfa.host.messageBox, response, beep, print, gotoURL, submitForm, importData og exportData samt FormCalc Get, Post og Put

Biblioteket kalder ingen dialog, reader, netværksanmodning eller filoverførsel automatisk; callbacken implementerer applikationstransporten og returnerer et typet respons

Hver dispatchet forespørgsel kører én gang inden for en omsluttende runtime-transaktion; QuickJS suspension-retries og committed sessions-replay forbruger registrerede responser uden at gentage callbacks

Forespørgsler bevarer positionelle argumenter som Unicode-strenge, inklusive tomme argumenter; forespørgselssekvensen starter ved nul for hver transaktion

Mislykkede transaktioner gendanner dokument- og script-object-tilstand og underretter completion-callbacken med Committed=False; applikationen skal stage'e eller kompensere sine eksterne effekter, fordi dokumentrollback ikke kan fortryde en ekstern operation

Completion-callbacks kører én gang efter succesfuld dokumentvalidering og layout eller efter rollback før normale succes-observatører; callbacks må ikke udløse exceptions eller genindtræde runtime'en

Host-callbacks kræver den medfølgende QuickJS-session; custom JavaScriptEvaluator-callbacks leverer ikke checkpoint- og replay-kontrakten

Forespørgselsantal, argumentantal, kodede forespørgselsbytes og responsbytes har uafhængige positive grænser; callback forløbet tid tæller med i transaktionsfristen, men synkron applikationskode kan ikke tvinges afbrudt

Script-funktioner modtager number, Boolean, string, null eller undefined efter respons-Kind; numeriske responser skal være finitære, og Unicode-responser skal indeholde gyldige surrogate-par

Relaterede API'er

Eksplicit XFA Host Transport, TXFAHostTransaction og Interactive Dynamic XFA Widget Runtime