/STHTTPRequest

A NSURLConnection wrapper for humans

Primary LanguageObjective-C

STHTTPRequest

A NSURLConnection wrapper for humans

Simple...
  • 400 lines of Objective-C you can understand
  • runs on iOS 4+ and Mac OS X 10.6+
  • just drag-and-drop .h and .m in your project
  • new BSD license
... yet powerful
  • synchronous and asynchronous (block based) calls
  • easy to set request headers, cookies and POST data
  • easy to get response status, headers and encoding
  • HTTP and proxy authentication
  • file upload
Usable in unit tests

You can fill a queue with fake responses to be consumed by requests started from unit tests.

Typical usage
STHTTPRequest *r = [STHTTPRequest requestWithURLString:@"http://google.com"];
    
r.completionBlock = ^(NSDictionary *headers, NSString *body) {
    // ...
};

r.errorBlock = ^(NSError *error) {
    // ...
};

[r startAsynchronous];
Starting a synchronous request
NSError *error = nil;
NSString *body = [r startSynchronousWithError:&error];
Getting HTTP data and metadata
NSInteger     status   = r.responseStatus;
NSDictionary *headers  = r.responseHeaders;
NSString     *encoding = r.responseStringEncodingName;
NSData       *data     = r.responseData;
Adding a request header
[r addHeaderWithName:@"test" value:@"1234"];
Adding a request cookie
[r addCookieWithName:@"test" value:@"1234"];
Setting a POST dictionary
r.POSTDictionary = [NSDictionary dictionaryWithObject:@"1234" forKey:@"test"];
Setting credentials
[r setUsername:@"test" password:@"1234"];
Setting proxy credentials
[r setProxyUsername:@"test" password:@"1234"];
Uploading a file
[r setFileToUpload:@"/tmp/photo.jpg" parameterName:@"photo"];