com.HttpRequest.beginXmlRequest

Starts a streaming HTTP request.

Syntax

beginXmlRequest()
  RETURNS xml.StaxWriter

Usage

The beginXmlRequest() starts a streaming HTTP request and returns an xml.StaxWriter object ready to send to the server.

Supported methods are: PUT, POST, PATCH, and DELETE.

Warning:

A message body is allowed in a DELETE request, but servers may ignore it if they do not support it.

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.

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)