com.HTTPServiceRequest.readFormEncodedRequest

Returns the string of a GET request with UTF-8 conversion option.

Syntax

readFormEncodedRequest(
   utf8 BOOLEAN )
  RETURNING result STRING
  1. utf8 defines if the string must be decoded to the current charset.

Usage

The readFormEncodedRequest() method returns the query of a POST "application/x-www-form-urlencoded" request or the query string of a GET request, decoded according to HTML4 or XFORM if utf8 is TRUE.

Note: If the result string contains & or = XForms special characters, these are doubled as follows: na&&me=va==lue.

If the utf8 parameter is TRUE, the decoded query string is translated from UTF-8 to the current character set. This may lead to a conversion error.

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)