com.HTTPRequest.doXmlRequest

Performs the request by sending an entire XML document at once.

Syntax

doXmlRequest(
   doc xml.DomDocument )
  1. doc defines the XML document containing the data to be sent..

Usage

The doXmlRequest() method performs the request by sending the entire passed xml.DomDocument at once.

Supported methods are PUT and POST.

The default Content-Type header is text/xml, but it can be changed if of the form */xml or */*+xml. For example: application/xhtml+xml.

In HTTP 1.1, if the body size is greater than 32 KB, the request will be sent in several chunks of the same size.

The character set used to send the XML data is defined by the encoding attribute in the XML document prolog. It is recommended that you define the HTTP request character set to NULL with the setCharSet() method, or that you use the same character set that was set in the XML Document.

This HTTP request method is non-blocking: It returns immediately after the call. Use the com.HTTPRequest.getResponse method, to perform a synchronous HTTP request, suspending the program flow until the response returns from the server. If the program must keep going on, use the com.HTTPRequest.getAsyncResponse method, to check if a response is available.

In case of error, the method throws an exception and sets the STATUS variable. Depending on the error, a human-readable description of the problem is available in the SQLCA.SQLERRM register. See Error handling in GWS calls (STATUS).

The INT_FLAG variable is checked during GWS API call to handle program interruptions, for more details, see Interruption handling in GWS calls (INT_FLAG)