http-request
An iOS Objective-C light-weight library that simplifies asynchronous HTTP operations.
Install
- Clone repo:
git clone https://github.com/langholz/http-request.git - Open workspace, select the
httprequestlibtarget and build (which generates a static library). - Follow Apple's documentation on how to use static libraries in iOS
Usage
With http-request you are able to perform simple HTTP operations in a light-weight manner.
Create and initialize instance
http_request *httpRequest = [http_request new];
GET request
NSURLSessionDataTask *task = [httpRequest
getAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
GET request with headers
NSURLSessionDataTask *task = [httpRequest
getAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withHeaders:@{@"MyHeaderName":@"MyHeaderValue"}
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
PUT request with NSData as the request body
NSURLSessionDataTask *task = [httpRequest
putAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withBody:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
PUT request with NSDictionary as the request body
NSURLSessionDataTask *task = [httpRequest
putAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withJson:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
PUT request with NSString as the request body
NSURLSessionDataTask *task = [httpRequest
putAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withString:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
PUT request with headers and NSData as the request body
NSURLSessionDataTask *task = [httpRequest
putAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withHeaders:@{@"MyHeaderName":@"MyHeaderValue"}
withBody:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
PUT request with headers and NSDictionary as the request body
NSURLSessionDataTask *task = [httpRequest
putAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withHeaders:@{@"MyHeaderName":@"MyHeaderValue"}
withJson:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
PUT request with headers and NSString as the request body
NSURLSessionDataTask *task = [httpRequest
putAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withHeaders:@{@"MyHeaderName":@"MyHeaderValue"}
withString:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
POST request with NSData as the request body
NSURLSessionDataTask *task = [httpRequest
postAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withBody:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
POST request with NSDictionary as the request body
NSURLSessionDataTask *task = [httpRequest
postAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withJson:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
POST request with NSString as the request body
NSURLSessionDataTask *task = [httpRequest
postAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withString:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
POST request with headers and NSData as the request body
NSURLSessionDataTask *task = [httpRequest
postAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withHeaders:@{@"MyHeaderName":@"MyHeaderValue"}
withBody:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
POST request with headers and NSDictionary as the request body
NSURLSessionDataTask *task = [httpRequest
postAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withHeaders:@{@"MyHeaderName":@"MyHeaderValue"}
withJson:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
POST request with headers and NSString as the request body
NSURLSessionDataTask *task = [httpRequest
posAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withHeaders:@{@"MyHeaderName":@"MyHeaderValue"}
withString:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
PATCH request with NSData as the request body
NSURLSessionDataTask *task = [httpRequest
patchAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withBody:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
PATCH request with NSDictionary as the request body
NSURLSessionDataTask *task = [httpRequest
patchAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withJson:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
PATCH request with NSString as the request body
NSURLSessionDataTask *task = [httpRequest
patchAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withString:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
PATCH request with headers and NSData as the request body
NSURLSessionDataTask *task = [httpRequest
patchAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withHeaders:@{@"MyHeaderName":@"MyHeaderValue"}
withBody:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
PATCH request with headers and NSDictionary as the request body
NSURLSessionDataTask *task = [httpRequest
patchAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withHeaders:@{@"MyHeaderName":@"MyHeaderValue"}
withJson:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
PATCH request with headers and NSString as the request body
NSURLSessionDataTask *task = [httpRequest
patchAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withHeaders:@{@"MyHeaderName":@"MyHeaderValue"}
withString:body
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
DELETE request
NSURLSessionDataTask *task = [httpRequest
deleteAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
DELETE request with headers
NSURLSessionDataTask *task = [httpRequest
deleteAsync:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withHeaders:@{@"MyHeaderName":@"MyHeaderValue"}
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
ISSUE verb request with automated parsing and status code validation
[http_request
constructRequest:@"GET"
withUrl:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withHeaders:@{@"MyHeaderName":@"MyHeaderValue"}
withBody:body];
NSURLSessionDataTask *task = [httpRequest
issueAsync:request
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
ISSUE verb request with optional parsing and optional status code validation
[http_request
constructRequest:@"GET"
withUrl:[[NSURL alloc] initWithString:@"http://www.langholz.net"]
withHeaders:@{@"MyHeaderName":@"MyHeaderValue"}
withBody:body];
NSURLSessionDataTask *task = [httpRequest
issueAsync:request
withBodyParser:nil
withResponseValidation:nil
onSuccess:^(NSURLResponse *response, id body)
{
// Success
}
onError:^(NSError *error)
{
// Error
}];
Tests
- Relies on the OHHTTPStubs CocoaPod and XCTest.
- Make sure you have the CocoaPod dependencies.
- Install by changing to the directory and running
pod install. - Run tests in Xcode.
Documentation
- HTML documentation
- The project includes a
Documentationtarget which generates, through appledoc, thedocsdirectory containing the corresponding documentation.