com.HTTPRequest.getAsyncResponse
When available, returns the response produced by one of request methods.
Syntax
getAsyncResponse()
RETURNS com.HTTPResponse
Usage
If a response is available, the getAsyncResponse()
method returns a com.HTTPResponse
object corresponding to
the response that was produced by a call to one of the request methods: doRequest()
, doTextRequest(), doXmlRequest()
, doFormEncodedRequest()
, or beginXmlRequest()
and endXmlRequest()
.
Unlike getResponse()
, the getAsyncResponse()
method is
non-blocking: it returns immediatly and does not stop the program flow when waiting for a
response.
The method returns NULL
if the HTTP response was not yet received from the
server.
This method is typically called just after a do*Request()
call, and if the
returned value is NULL
, it is called again after a short period of time, to check
for a response. Within a dialog, use an ON IDLE
block to issue a
getAsyncRequest()
every seconds for example.
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)