Bridge
Simple Typed JSON HTTP Networking in Swift 4.0
GET
GET<Dict>("http://httpbin.org/ip").execute(success: { (response) in
let ip: Dict = response
})
let postID = "1"
GET<Dict>("http://jsonplaceholder.typicode.com/posts/#").execute(postID, success: { (response) in
let post: Dict = response
})
POST
let userComment = ["justin": "wow this is cool"]
let endpoint = POST<[String: AnyObject]>("https://api.bridge.com/comments")
endpoint.execute(params: userComment, success: { (commentResponse: [String: AnyObject]) -> () in
// Handle success
}, failure: { (error, data, request, response) in
// Handle failure
})
Interceptors
The power of Bridge is that it lets you create custom "Interceptors" to intercept process your requests before they are sent off to the internets, or to intercept and process your responses before they are returned to the caller's success block.
Attach custom headers based on the endpoint, write retry handling, write authentication handlers, use method tunneling. Interceptors allow Bridge to be extremely extensible to your project needs.
/**
* Conform to the `ResponseInterceptor` protocol for any Bridge that
* needs to work with or alter a request before it's sent over the wire
*/
public protocol ResponseInterceptor {
func process<ReturnType>(endpoint: Endpoint<ReturnType>, inout mutableRequest: NSMutableURLRequest)
}
/**
* Conform to the `ResponseInterceptor` protocol to work with data after
* the request is returned with a response.
*/
public protocol ResponseInterceptor {
func process<ReturnType>(endpoint: Endpoint<ReturnType>, response: NSHTTPURLResponse?, responseObject: ResponseObject) -> ProcessResults
}
Examples:
- Retry (Retries requests on response if not 2xx code)
- Model Cache (Caches objects on response)
- Method Tunneling (Changes the HTTP Verb)
Object Serialization
Bridge is implemented using generics which allow you to serialize to objects as long as your objects conform to the Parseable
protocol.
public protocol Parseable {
static func parseResponseObject(responseObject: AnyObject) throws -> AnyObject
}
It is left completely up to the developer on how you want to implement the Parseable
protocol. You can manually create and serialize your objects:
class User: AnyObject, Parseable {
var name: String?
var email: String?
var pictureURL: NSURL?
static func parseResponseObject(responseObject: AnyObject) throws -> AnyObject {
if let dict = responseObject as? Dictionary<String, AnyObject> {
let user = User()
user.name = dict["name"] as? String
user.email = dict["email"] as? String
user.pictureURL = NSURL(string: dict["avatar_url"] as! String)
return user
}
// If parsing encounters an error, throw enum that conforms to ErrorType.
throw BridgeErrorType.Parsing
}
}
Or you can also serialize them using whatever serialization libraries you like. This gist is an example of out out-of-box working solution for Mantle if you're already using Mantle models. No code change is required to your Mantle models.
Once models are setup, making calls are as simple as:
let endpoint = GET<GithubUser>("https://api.github.com/users/rawrjustin")
endpoint.execute(success: { (user: GithubUser) in
print(user)
})
let endpoint = GET<Array<GithubUser>>("https://api.github.com/users")
endpoint.execute(success: { (users: Array<GithubUser>) in
print(users)
}, failure: { (error: NSError?) in
print(error)
})
Advanced Features
Base URL
You can set the base url of your Bridge client
Bridge.sharedInstance.baseURL = "http://api.github.com"
GET<GithubUser>("/users/rawrjustin") // expands to http://api.github.com/users/rawrjustin
Cancellation by Tag
Easily cancel any requests tagged with an identifier.
Bridge.sharedInstance.cancelWithTag("DebouncedSearch")
Variable endpoints
Similar to how Rails maps :id for resources, #
is used as the character where a variable would be inserted into the path.
GET<Dict>("/photos/#")
will map to /photos/1
if you pass in 1
in the first variadic parameter when you call execute(). You can have multiple variables, they will be mapped in order respectively.
Additional HTTP headers
Endpoint Specific Interceptors
Requirements
- iOS 8.0+
- Swift 4.0
Installation
pod 'Bridge', '0.4.3'
github "rawrjustin/Bridge"
License
Bridge is licensed under MIT license.
Questions?
Open an issue