| Latest | 0.2.4 |
|---|---|
| Homepage | https://github.com/tigerraj32/RTWebService |
| License | MIT |
| Platforms | ios 8.0 |
| Dependencies | Alamofire, AEXML |
| Authors |
Introduction
RTWebService is a wrapper around Alamofire for making REST and SOAP call in easiest possible way. RTWebService also focus on connecting to server by other protocol such as SSH and FTP. Right now we are in beta phase of developing this library and soon we will come up with pretty impressive way of communicate with server from your iOS application.
Installation
RTWebService is available through CocoaPods. To install
it, simply add the following line to your Podfile:
pod "RTWebService"Example
To run the example project, clone the repo, and run pod install from the Example directory first.
Usage
1. Rest GET (JSON formatted Response)
/*
//Get single user
let payload = RTPayload.init(parameter:nil, parameterEncoding:.defaultUrl)
let req = RTRequest.init(requestUrl: "https://reqres.in/api/users/2",
requestMethod: .get,
header: ["language":"en"],
payload: payload)
*/
//Get user list
let payload = RTPayload.init(parameter: ["page":2], parameterEncoding:.defaultUrl)
let req = RTRequest.init(requestUrl: "https://reqres.in/api/user",
requestMethod: .get,
header: ["language":"en"],
payload: payload)
RTWebService.restCall(request: req) { (response) in
print("actual output ------------------------")
switch response {
case .success(let res):
print("response value")
print(res)
case .failure(let error):
print("error value")
print(error)
}
}In this sample uses every thing is pretty simple to understand except the parameterEncoding. .defaultUrl will send your query parameter as urlEncoding such as http://demo0947187.mockable.io/get?name=rajan
2. Rest POST (JSON formatted Response)
Form Data: Create user
$ curl -i
-X POST
-H "language: en"
-H "User-Agent: RTWebService_Example/1.0 (org.cocoapods.demo.RTWebService-Example; build:1; iOS 10.2.0) Alamofire/4.3.0"
-d "job=leader&name=morpheus"
"https://reqres.in/api/users" let payload = RTPayload.init(parameter: ["name": "morpheus",
"job": "leader"], parameterEncoding:.bodyUrl)
let req = RTRequest.init(requestUrl: "https://reqres.in/api/users",
requestMethod: .post,
header: ["language":"en"],
payload: payload)JSON formatted Body Data
$ curl -i
-X POST
-H "language: en"
-H "User-Agent: RTWebService_Example/1.0 (org.cocoapods.demo.RTWebService-Example; build:1; iOS 10.2.0) Alamofire/4.3.0"
-d "{"job":"leader","name":"morpheus"}"
"https://reqres.in/api/users" let payload = RTPayload.init(parameter: ["name": "morpheus",
"job": "leader"], parameterEncoding:.defaultJson)
let req = RTRequest.init(requestUrl: "https://reqres.in/api/users",
requestMethod: .post,
header: ["language":"en"],
payload: payload)XML formatted Body Data
$ curl -i
-X POST
-H "language: en"
-H "User-Agent: RTWebService_Example/1.0 (org.cocoapods.demo.RTWebService-Example; build:1; iOS 10.2.0) Alamofire/4.3.0"
-d "<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>job</key>
<string>leader</string>
<key>name</key>
<string>morpheus</string>
</dict>
</plist>"
"https://reqres.in/api/users" let payload = RTPayload.init(parameter: ["name": "morpheus",
"job": "leader"], parameterEncoding:.xmlProperty)
let req = RTRequest.init(requestUrl: "https://reqres.in/api/users",
requestMethod: .post,
header: ["language":"en"],
payload: payload)1. SOAP Web Service Handling
TO make a soap call we need to have following things setup before making a service call
- Host address
- SOAP Action
- SOAP Message Body
Webservicex have tons of soap request to work with.
Soap Get Request
let soapPayload = RTPayload(parameter: ["IPAddress" : "124.41.219.215"], parameterEncoding: .defaultUrl)
let req1 = RTRequest.init(requestUrl: "http://www.webservicex.net//geoipservice.asmx/GetGeoIP",
requestMethod: .get,
header: ["language":"en",
"Content-Type": "text/xml"],
payload: soapPayload)
RTWebService.soapCall(request: req1) { (response) in
print("actual output ------------------------")
switch response {
case .success(let res):
print("response value")
print(res)
case .failure(let error):
print("error value")
print(error)
}
}
Soap Post Request
Let’s make a SOAP request with following request configuration
POST /geoipservice.asmx HTTP/1.1
Host: www.webservicex.net
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://www.webservicex.net/GetGeoIP"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetGeoIP xmlns="http://www.webservicex.net/">
<IPAddress>string</IPAddress>
</GetGeoIP>
</soap:Body>
</soap:Envelope>Now with RTWebservice
// Create XML Document
let soap = AEXMLDocument()
let envelope = soap.addChild(name: "soap:Envelope",
attributes: ["xmlns:xsi":"http://www.w3.org/2001/XMLSchema-instance",
"xmlns:xsd":"http://www.w3.org/2001/XMLSchema",
"xmlns:soap":"http://schemas.xmlsoap.org/soap/envelope/"])
//let header = envelope.addChild(name: "soap:Header")
let body = envelope.addChild(name: "soap:Body")
let geoIp = body.addChild(name:"GetGeoIP", attributes:["xmlns":"http://www.webservicex.net/"])
geoIp.addChild(name: "IPAddress", value: "124.41.219.215", attributes: [:])
let soapPayload = RTPayload(parameter: ["soapdata" : soap.xml], parameterEncoding: .defaultUrl)
let req1 = RTRequest.init(requestUrl: "http://www.webservicex.net/geoipservice.asmx",
requestMethod: .post,
header: ["language":"en",
"SOAPAction":"http://www.webservicex.net/GetGeoIP",
"length": String(soap.xml.characters.count),
"Content-Type": "text/xml"],
payload: soapPayload)
RTWebService.soapCall(request: req1) { (response) in
print("actual output ------------------------")
switch response {
case .success(let res):
print("response value")
print(res)
case .failure(let error):
print("error value")
print(error)
}
}Author
rajan, [email protected]
Contribution
We welcome any contribution.
License
RTWebService is available under the MIT license. See the LICENSE file for more info.
Latest podspec
{
"name": "RTWebService",
"version": "0.2.4",
"summary": "Elegant library to connect with server through REST, SOAP, FTP, SSH",
"description": "RTWebService is a wrapper around Alamofire for making REST and SOAP call in easiest possible way.",
"homepage": "https://github.com/tigerraj32/RTWebService",
"license": {
"type": "MIT",
"file": "LICENSE"
},
"authors": {
"rajan": "[email protected]"
},
"source": {
"git": "https://github.com/tigerraj32/RTWebService.git",
"tag": "0.2.4"
},
"social_media_url": "https://twitter.com/tigerraj32",
"platforms": {
"ios": "8.0"
},
"source_files": "RTWebService/Classes/**/*",
"dependencies": {
"Alamofire": [
"~> 4.3"
],
"AEXML": [
"~> 4.0"
]
},
"pushed_with_swift_version": "3.0"
}
Fri, 24 Feb 2017 01:40:04 +0000