How to implement SOAP Web service with SWIFT 4.0 programming language?

Update (13 November, 2017): Updated codes for Xcode 9 and swift 4.0

Update (25 March, 2016): I’ve updated codes for Xcode 7 and swift 2.0

Update (16 September, 2016): Code updated for Xcode 7.2.1 and swift 2.1.1

Today I’ll show you how to develop SWIFT based application that communicates with a web service using SOAP.

We’ll use following  web service and convert temperature from celcious to fahrenheit:

http://www.webservicex.net/ConvertTemperature.asmx

If you are new to SOAP, then I’d recommend you to learn it from the following link:

http://www.w3schools.com/webservices/ws_soap_intro.asp

And to learn the basics of swift, you can read apple’s documentation by clicking here.

Requirements: Basic understanding of Web services, SOAP and swift.

First open Xcode 9 (or later version) and create a new project named “Temperature Converter”. Select swift as language from first dialog box. Created project will contain ViewController.swift, Main.storyboard and other files.

Screen Shot 2014-10-24 at 11.23.03 PM
Open Main.storyboard and add textfield, labels and a buttons as shown in the screenshot below.
Screen Shot 2014-10-24 at 11.30.28 PM
Add outlets of textfields and add an action for the button. If the image below is too small to view, please click on it to see the full size. In case if you don’t know how to do this, open storyboard and swift file side by side in Assistant editor view. Ctrl + Drag and drop textfields to the swift file. Do the same thing for action, just change the connection type from “Outlet” to “Action” in popup box. I gave the outlet names txtCelcius and txtFahrenheit. For button’s action name I used actionConvert. You can use any name. I didn’t add any outlet for button.
Screen Shot 2014-10-24 at 11.31.55 PM
Now let’s change the codes step by step to add SOAP service with this application.

Step 1: Add delegation names that we’ll be delegating through out this project. We’ll delegate:UITextFieldDelegate, NSURLConnectionDelegate, NSXMLParserDelegate.

 

Step 2: We need some variables to store received data from server and keep track of those data. Let’s declare them.

 

Step 3: Modify the actionConvert method to let it get user input from Celcius textfield and make a request to server using post method. The full actionConvert method will look like following code:

 


 

Step 4: Using following 3 methods we’ll delegate with NSURLConnection. First 2 methods will save data received from server in mutableData variable. The last method will start NSXMLparser to parse SOAP message.

 

Step 5: We need 2 methods to parse SOAP message returned from server. I’ll discuss one by one so that you can understand them.

The first method is called each time a new node or element of SOAP (or XML) is parsed. We need to  save this name so that we can detect each node in second method. Let’s see the first method:

 

 

The second method will check the current element name and if it finds “ConvertTempResult” element, then it displays the value in Fahrenheit text field.

Now, save and run the code. If you put any numeric value in Celsius box and tap Convert button, Fahrenheit box will display the result fetched from server.

 

iOS Simulator Screen Shot Oct 27, 2014, 7.33.25 PM

 

You can download the whole project from here.

Or can pull the latest project code from Github:

https://github.com/rubelbd82/soapwithswift

Best of luck!!!

How to customise UILabel using SWIFT 4.0?

Requirements:

Operating System: OS X 10.9.4+

IDE: Xcode 9

Level: Beginner to intermediate.

We can use Storyboard and interface builder to change the look and feel of UILabel. However, sometime, we have no other way but do these customizations programmatically. One of the reasons to do so is to keep all the styles in one place. In other words, it’s something like css stylesheet that can render all pages or views. Whatever the reason is, let’s try it.

Open Xcode 9 and create a new project. A dialog box will appear for selecting template. Choose single view application and press next.

Screen Shot 2014-09-14 at 2.05.25 PM

In the next box, type Product name – “Custom Label”. In Organization Identifier box, type reverse of your domain name. Choose Swift as language and press next.

 

customLabel1

From next dialog box select the location where you want to save the project and press “Create” button.

Screen Shot 2014-09-14 at 2.11.39 PM

Now open Main.storyboard from Project Navigator (If you can’t see project navigator in the left side of the screen, press Commad+O). You will see a blank View Controller in the workspace window.

 

customLabel2

Drag and drop a Label element from Utilities panel (If you can’t see Utilities Panel, press Command+Option+0) to the View Controller of the workspace (See above figure – bottom right corner).

Press Command+N (or File > New > File) to add a new file to the project. From template chooser box select Swift file and press next.Screen Shot 2014-09-14 at 2.24.46 PM

Save the file as MyCustomLabel.

customLabel3

Open MyCustomLabel.swift file.

import UIKit so that you can subclass MyCustomLabel class from UILabel.

import UIKit

Write a new subclass of UILabel and name it “MyCustomLabel”

class MyCustomLabel: UILabel {

}

We’ve to override init(coder aDecoder: NSCoder!)  function.

init(coder aDecoder: NSCoder!) {

super.init(coder: aDecoder)

}

The colour of the text that we write inside the UILabel can be changed as follows:

self.textColor = UIColor.blue

Finally, our whole code will look like :

Now, you’ve to attach this custom class with your Label. Let’s do them in 3 steps.

Go to Storyboard and select the label.

From Utility panel select the Identity Inspector.

In the class box Type MyCustomLabel

customLabel4

To see what you have done, press Command+R (or Product > Run) to run the application on simulator

How to customise UITextField in SWIFT 4.0?

Requirements:

Operating System: OS X 10.9.4+

IDE: Xcode 9

Level: Beginner to intermediate.

In my previous article I showed you how to customise UIButton. Here I’ll discuss about changing the look and feel of Text Field (UITextField)

As usual Open Xcode and create a new project. A dialog box will appear for selecting template. Choose single view application and press next.

Screen Shot 2014-09-14 at 2.05.25 PM

In the next box, type Product name. I typed Custom TextField. I’ve also used reverse of my website’s domain name com.webindream as Organization Identifier. You must choose Swift as language and press next.

Custom TextField

From next dialog box select the location where you want to save the project and press “Create” button.

Screen Shot 2014-09-14 at 2.11.39 PM

Now open Main.storyboard from Project Navigator (If you can’t see project navigator in the left side of the screen, press Commad+O). You will see a blank View Controller in the workspace window.

TextField3

 

 

Now drag and drop a TextField element from Utilities panel (If you can’t see Utilities Panel, press Command+Option+0) to the View Controller of the workspace (See above figure – bottom right corner). One more thing, don’t be confused with UITextField and UITextView.

  • UITextField: UITextField object is a control that displays editable text and sends an action message to a target object when the user presses the return button.”
  • UITextView: “The UITextView class implements the behavior for a scrollable, multiline text region.”

(Source: StackOverflow.com)

Press Command+N (or File > New > File) to add a new file to the project. From template chooser box select Swift file and press next. Screen Shot 2014-09-14 at 2.24.46 PM

Type MyCustomTextField as file name and create the file.

TextField1

Open MyCustomTextField.swift file and get ready to edit.

import UIKit as UITextField is a child class of UIKit.

import UIKit

Write a new subclass of UITextField and name it “MyCustomTextField”

class MyCustomTextField: UITextField {

}

We’ve to override init(coder aDecoder: NSCoder!)  function.

init(coder aDecoder: NSCoder!) {

super.init(coder: aDecoder)

}

First of all we’ll make the corners of the TextField round.

To do so, write the following code inside init(coder aDecoder: NSCoder!) function.

self.layer.cornerRadius = 5.0;

Now change the border color and border width with help of following 2 lines:

self.layer.borderColor = UIColor.gray.cgColor

self.layer.borderWidth = 1.5

To change the background colour of the Text Field modify backgroundColor property of UITextField:

self.backgroundColor  = UIColor.blue

The colour of the text that we write inside the Textfield can be changed as follows:

self.textColor = UIColor.white

You may be curious to customize the colour of the cursor that blinks when the TextField is focused. Don’t worry, you can do this too:

self.tintColor = UIColor.white

Finally, our whole code will look like :

 

Now, you’ve to attach this custom class with your button. Let’s do them in 3 steps.

Go to Storyboard and select the button.

From Utility panel select the Identity Inspector.

In the class box Type MyCustomTextField

Nothing is changed? No problem, press Command+R (or Product > Run) to run the application on simulator.

Voila, you’re done.