Read the REST Response Body in Chunks

See more REST Examples

Demonstrates Rest.ReadRespChunkBd, which reads the response body one chunk at a time, appending each chunk to a BinData. A return value of 0 signals the body is complete, while -1 indicates a read failure.

Dim success As Boolean
success = False

Dim rest As New Chilkat.Rest
Dim bTls As Boolean
bTls = True
Dim bAutoReconnect As Boolean
bAutoReconnect = True
success = rest.Connect("example.com",443,bTls,bAutoReconnect)
If (success = False) Then
    System.DebugLog(rest.LastErrorText)
    Return
End If

success = rest.SendReqNoBody("GET","/api/largefile")
If (success = False) Then
    System.DebugLog(rest.LastErrorText)
    Return
End If

Dim statusCode As Int32
statusCode = rest.ReadResponseHeader()
If (statusCode < 0) Then
    System.DebugLog(rest.LastErrorText)
    Return
End If

//  Check for the expected success status code.  If the response is not 200, the body is likely
//  error text formatted as JSON, XML, or HTML rather than the expected content.  In that case read
//  the body as text, report it, and return.
If (statusCode <> 200) Then
    Dim sbError As New Chilkat.StringBuilder
    success = rest.ReadRespSb(sbError)
    If (success = False) Then
        System.DebugLog(rest.LastErrorText)
        Return
    End If

    System.DebugLog("Request failed with status code " + Str(statusCode))
    System.DebugLog(sbError.GetAsString())
    Return
End If

//  The status code is 200.  Read the response body in chunks, appending each chunk to the BinData.
//  Each call waits until at least the requested number of bytes is available, unless the response
//  ends first.  A return value of 0 means the final bytes were returned and the body is complete;
//  -1 indicates a read failure.
Dim bdBody As New Chilkat.BinData
Dim chunkResult As Int32
chunkResult = rest.ReadRespChunkBd(8192,bdBody)
While chunkResult > 0
    chunkResult = rest.ReadRespChunkBd(8192,bdBody)
Wend
If (chunkResult < 0) Then
    System.DebugLog(rest.LastErrorText)
    Return
End If

System.DebugLog("Received " + Str(bdBody.NumBytes) + " bytes.")