Objective-C

Explaining the Rest ClearResponseBodyStream Method

See more Azure Cloud Storage Examples

The ClearResponseBodyStream method would be needed if your applicaiton called SetResponseBodyStream to send the response to a stream for one request, but then wants to subsequently do something else. The application must call ClearResponseBodyStream to no longer send responses to the stream. Objective-C

#import <CkoRest.h>
#import <CkoStream.h>
#import <NSString.h>
#import <CkoBinData.h>

BOOL success = NO;

//  This example requires the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

CkoRest *rest = [[CkoRest alloc] init];

//  Connect to the web server
BOOL bTls = YES;
int port = 443;
BOOL bAutoReconnect = YES;
success = [rest Connect: @"www.chilkatsoft.com" port: [NSNumber numberWithInt: port] tls: bTls autoReconnect: bAutoReconnect];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

//  Setup a file stream for the download
CkoStream *fileStream = [[CkoStream alloc] init];
fileStream.SinkFile = @"qa_output/starfish.jpg";

//  Indicate that the call to FullRequestNoBody should send the response body
//  to fileStream if the response status code is 200.
//  If a non-success response status code is received, then nothing
//  is streamed to the output file and the error response is returned by FullRequestNoBody.
int expectedStatus = 200;
[rest SetResponseBodyStream: [NSNumber numberWithInt: expectedStatus] autoSetStreamCharset: YES responseStream: fileStream];

NSString *responseStr = [rest FullRequestNoBody: @"GET" uriPath: @"/images/starfish.jpg"];
if (rest.LastMethodSuccess == NO) {
    //  Examine the request/response to see what happened.
    NSLog(@"%@%d",@"response status code = ",[rest.ResponseStatusCode intValue]);
    NSLog(@"%@%@",@"response status text = ",rest.ResponseStatusText);
    NSLog(@"%@%@",@"response header: ",rest.ResponseHeader);
    NSLog(@"%@%@",@"response body (if any): ",responseStr);
    NSLog(@"%@",@"---");
    NSLog(@"%@%@",@"LastRequestStartLine: ",rest.LastRequestStartLine);
    NSLog(@"%@%@",@"LastRequestHeader: ",rest.LastRequestHeader);
    return;
}

NSLog(@"%@",@"downloaded starfish.jpg");

//  Clear the response body stream previously set in the call to SetResponseBodyStream.
[rest ClearResponseBodyStream];

//  Download something else, but this time send the response body to bd.
CkoBinData *bd = [[CkoBinData alloc] init];
success = [rest FullRequestNoBodyBd: @"GET" uriPath: @"/images/penguins.jpg" binData: bd];
if (success == NO) {
    //  Examine the request/response to see what happened.
    NSLog(@"%@%d",@"response status code = ",[rest.ResponseStatusCode intValue]);
    NSLog(@"%@%@",@"response status text = ",rest.ResponseStatusText);
    NSLog(@"%@%@",@"response header: ",rest.ResponseHeader);
    NSLog(@"%@%@",@"response body (if any): ",[bd GetString: @"utf-8"]);
    NSLog(@"%@",@"---");
    NSLog(@"%@%@",@"LastRequestStartLine: ",rest.LastRequestStartLine);
    NSLog(@"%@%@",@"LastRequestHeader: ",rest.LastRequestHeader);
    return;
}

//  Save the contents of bd to a file.
success = [bd WriteFile: @"qa_output/penguins.jpg"];

NSLog(@"%@%d",@"Success: ",success);