isCOBOL EIS : Appendices : HTTPClient class (com.iscobol.rts.HTTPClient) : getResponseJSON
getResponseJSON
Returns the HTTP response parsed with JSON rules.
Format 1
void getResponseJSON( json )
Format 2
void getResponseJSON( json, encoding )
Format 3
void getResponseJSON( json, encoding, hasDummyRoot )
Syntax rules
1. json is a level 01 data item for which the IS IDENTIFIED clause has been used.
2. encoding is a string literal or data item that specifies the character set to be used while parsing the JSON stream. It accepts the same values as the iscobol.encoding * configuration property.
3. hasDummyRoot is an alphanumeric data item or literal hosting a boolean value (e.g. "0", "1", "true", "false", "yes", "no", "on" or "off"). If the boolean value is TRUE, then the top level item of Record-Definition is ignored and will not be retrieved from the JSON stream. This parameter can be NULL, in such case, FALSE is assumed.
General rules
1. This method should be called after a request performed via one of the following methods: doGet, doPost, doPostEx or doPostMultipart.
2. The following escapes are allowed: \b, \f, \n, \r, \t, \" and \\. Any other character preceeded by a backslash is considered invalid and makes the read fail unless you set iscobol.jsonstream.allow_backslash_escaping_any_character (boolean) to true in the configuration.