...
Begins an asynchronious GET request and uses the contents to create an object of the specified type. Events will be sent to the message port associated with the object. If this method returns False, the request could not be issued and no events will be delievered. Only supported types are roSyncSpec and roXMLElement.
AsyncCancel() As Boolean
...
Name | Type | Description |
method | String | An HTTP method. Normal values include "HEAD", "GET", "POST", "PUT", and "DELETE". Other values are supported; however, depending on server behavior, they may not work as expected. |
request_body_string | String | A string containing the request body. |
request_body_file | String | The name of a file that contains the request body |
response_body_string | Boolean | If specified and set to True, the response will be stored in a string and provided via the roUrlEvent.GetString() method. |
response_body_file | String | The name of the file that will contain the response body. The body is written to a temporary file and then renamed to the specified filename if successful. |
response_body_resume_file | String | The name of the file that will contain the response body. For a GET request, a RANGE header is sent based on the current size of the file, which is written in place rather than using a temporary file. |
response_body_object | String | Uses the response body to create an object of the specified type. See the entry for AsyncGetToObject() for supported object types. |
response_pipe | roArray | Use a pipeline of handlers to process the response body as it is received. See below for more details. |
...
The roArray response for response_pipe consists of one or more roAssociativeArray instances containing a filter description (see below). The last associative array is usually an output filter.
Name | Type | Description |
hash | String | Calculate a hash (digest) of the data using the specified algorithm as it passes through the pipeline. Supported hashes include the following: "CRC32", "MD5", "SHA1", "SHA256", "SHA384", "SHA512". The resulting hash can be retrieved as a hexadecimal string using the roUrlEvent.GetHash() method. |
decompress | String | Decompress the response body using the specified algorithm. Currently, the only supported algorithm is “gzip”. It is often easier to use an HTTP Content-Encoding rather than explicitly decompressing the body. |
prefix_capture | Integer | Capture the specified number of bytes (between 1 and 16384) from the start of the stream and store them separately. The bytes can be retrieved using the roUrlEvent.GetPrefix() method, but they cannot be passed on to subsequent filters. |
output file | String | Output the pipeline to the specified file. The output is written to a temporary file and then renamed to the specified filename if successful. |
output_string | Boolean | If specified and set to True, the response will be stored in a string and provided via the roUrlEvent.GetString() method. |
...
The following example code specifies an array of handlers to filter the response body of an HTTP request.
...