com.HttpServiceRequest.readFileRequest

Returns the body of a request in a file.

Syntax

readFileRequest( )
    RETURNS STRING

Usage

The readFileRequest() method returns the body of the request to a file on disk.

The file is created in the temporary directory used by the runtime system (DBTEMP). The name of the file is the basename found in the HTTP Content-Disposition Header. If this basename is not specified, the file name is created with a UUID. If a file with the same name already exists in the temporary directory, the API prefixes the new file with a number. It is then of the form: /tmp/ABC/filename_index.ext, where index represents the number of files with the same name on disk.

Supported methods are: PUT, POST, PATCH.

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)