Saxon » SaxonJS

As well as allowing a timeout to be specified for schedule-action HTTP requests (as specified by ixsl:schedule-action/@http-request), we should also allow a timeout to be specified for schedule-action document retrieve HTTP requests (as specified by ixsl:schedule-action/@document).

Further changes in IXSLScheduleAction.java to update compile-time validation of ixsl:schedule-action attributes: must have at least one attribute, but not both @http-request and @document. Committed on 9.8 and trunk.

This allows @wait can be used with either @http-request or @document to specify a timeout for the relevant requests.

Various further changes committed on 1.x and 2.0 branches:

1. Can now cancel HTTP requests (including those for document fetches) by specifying a timeout using @wait, or by aborting

2. Aborting is made possible by the fact that ixsl:schedule-action now returns the associated XMLHttpRequest (XHR) objects (when called with @document or @http-request), rather than returning nothing. This means abort() can be called directly on the XHR object e.g. using ixsl:call(), for instance triggered by user interaction.

3. The relevant methods in BrowserPlatform have been updated to allow this (e.g. makeHttpRequest, asyncGet, asyncGetXml now return XHR objects)

4. The tempOutputState for the new context for the called template (i.e. the scheduled action) is set to false, to allow the result of ixsl:schedule-action to be stored in a variable

5. For asynchronous document fetches (ixsl:schedule-action with @document) if the document pool holds an XError (as is the case when the document fetch fails because of an error, or abort, or timeout), then we now retry to fetch the document, and update the entry in the document pool.

6. When ixsl:schedule-action/@document is used to fetch a single document, the instruction returns a single XHR object. When it is used to fetch multiple documents, it returns an object containing multiple XHR objects indexed by absolute URIs.

7. When an XHR specified by ixsl:schedule-action/@http-request is terminated because of an error, timeout or abort event, the called template is invoked (i.e. this is treated as an alternative to receiving a response from the HTTP request). In this case the context item (which is usually a map representation of the HTTP response) is an XDM map with information about the request termination: with entries for keys 'status' (with value 0), 'message' (a Saxon-JS error message), 'type' (the type of the event which caused the request to end, i.e. error|timeout|abort), and 'error' (a Saxon-JS internal error code).

Various tests committed in svn/tests/saxon-js/http (Servlex webapp for testing different HTTP requests).