{"id":611,"date":"2014-06-03T08:41:48","date_gmt":"2014-06-03T14:41:48","guid":{"rendered":"http:\/\/jamesonquave.com\/blog\/?p=611"},"modified":"2015-09-02T20:41:41","modified_gmt":"2015-09-03T02:41:41","slug":"developing-ios-apps-using-swift-part-3-best-practices","status":"publish","type":"post","link":"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/","title":{"rendered":"Developing iOS Apps Using Swift Part 3 – Best Practices"},"content":{"rendered":"

This section completely updated to reflect changes in Xcode 6.3, as of April 16, 2015<\/i><\/strong><\/b><\/p>\n

In parts 1 & 2 we went over some basics of Swift, and set up a simple example project that creates a Table View and a puts some API results from iTunes inside of them. If you haven’t read that yet, check out Part 1<\/a> and Part 2<\/a>. If you enjoy these tutorials, I’m also working on a book full of quality content for Swift developers, and it’s available for Pre-Order now<\/a>.<\/p>\n

In this section we’re going to take a stop and clean up some of the code we’ve created so far by removing our network logic from our view controller code, and fixing some other issues that will hurt our performance. This may not be the most glamorous part of writing a new app, but it’s important! Let’s do it…<\/p>\n

If you’re looking something that goes a little deeper than these tutorials, I also have written a book and created video tutorials which are available now. If that’s more your speed, check out my Swift Book & Video Packages »<\/a>.<\/p>\n

\n

\n\"Get
\nLearn About My Book & Video Packages »<\/a>
\n<\/center>\n<\/div>\n

Split up the code<\/strong><\/p>\n

First things first, let’s rename our View Controller to be something more meaningful. Open up your ViewController.swift file and replace the class name ‘ViewController’ with our new name, ‘SearchResultsViewController’. Rename the file as well to\u00a0SearchResultsViewController.swift.<\/p>\n

If you try to run the app from here you’ll get a crash. This is because our storyboard file hasn’t been updated to know about the new class! So open up the Main.storyboard, select your ‘View Controller’ object in the scene (the left-hand side nav), and then select the Identity Inspector (right-hand side, third button.) <\/p>\n

From here let’s change the class from ‘ViewController’ to ‘SearchResultsViewController’. Now we should be back on track. Check that the project still works, and let’s proceed.<\/p>\n

<\/p>\n

Let’s now move the API code out to it’s own class. Right click in the xcode navigation pane and select ‘New File…’. This one is going to be a regular Swift file, under the iOS->Source navigation option.<\/p>\n

<\/p>\n

This one handles all API work, so I’m going to call it APIController.<\/p>\n

Now let’s grab our searchItunesFor() function, and cut and paste it out of the Search controller and in to the APIController, inside of a new class ‘APIController’.<\/p>\n

Your complete APIController.swift file should look something like this:<\/p>\n

\r\nimport Foundation\r\n\r\nclass APIController {\r\n    \r\n    func searchItunesFor(searchTerm: String) {\r\n        \r\n        \/\/ The iTunes API wants multiple terms separated by + symbols, so replace spaces with + signs\r\n        let itunesSearchTerm = searchTerm.stringByReplacingOccurrencesOfString(\" \", withString: \"+\", options: NSStringCompareOptions.CaseInsensitiveSearch, range: nil)\r\n        \r\n        \/\/ Now escape anything else that isn't URL-friendly\r\n        if let escapedSearchTerm = itunesSearchTerm.stringByAddingPercentEscapesUsingEncoding(NSUTF8StringEncoding) {\r\n            let urlPath = \"http:\/\/itunes.apple.com\/search?term=\\(escapedSearchTerm)&media=software\"\r\n            let url = NSURL(string: urlPath)\r\n            let session = NSURLSession.sharedSession()\r\n            let task = session.dataTaskWithURL(url!, completionHandler: {data, response, error -> Void in\r\n                println(\"Task completed\")\r\n                if(error != nil) {\r\n                    \/\/ If there is an error in the web request, print it to the console\r\n                    println(error.localizedDescription)\r\n                }\r\n                var err: NSError?\r\n                \r\n                var jsonResult = NSJSONSerialization.JSONObjectWithData(data, options: NSJSONReadingOptions.MutableContainers, error: &err) as NSDictionary\r\n                if(err != nil) {\r\n                    \/\/ If there is an error parsing JSON, print it to the console\r\n                    println(\"JSON Error \\(err!.localizedDescription)\")\r\n                }\r\n                let results: NSArray = jsonResult[\"results\"] as NSArray\r\n                dispatch_async(dispatch_get_main_queue(), {\r\n                    self.tableData = results\r\n                    self.appsTableView!.reloadData()\r\n                })\r\n            })\r\n            \r\n            task.resume()\r\n        }\r\n    }\r\n    \r\n}\r\n<\/pre>\n
\nIf you try to build this straight away you’ll see three errors:<\/p>\n
1) searchItunesFor() is now undefined in our SearchResultsViewController.
\n2) self.tableData\u00a0is now undefined in the APIController.
\n3) self.appsTableView is now undefined in the APIController.<\/p>\n
To deal with this we need to let these objects know about each other. So let’s make APIController a child object of our SearchResultsViewController. It’s pretty easy to do, just add the following line underneath your SearchResultsViewController class definition:<\/p>\n
let api = APIController()<\/pre>\n
Now modify the line that calls searchItunesFor() to this:<\/p>\n
api.searchItunesFor(\"Angry Birds\")<\/pre>\n
The only difference here is that we’re calling the method from an instance of an APIController, as opposed to doing this all from a method in the View Controller.<\/p>\n
That takes care of the first set of errors, but now we need to also get APIController’s results back to the SearchResultsViewController. We would like for our API controller to be able to respond to arbitrary API calls, so we should define a protocol that views can subscribe to in order to get results!<\/p>\n
Defining an API protocol<\/strong><\/p>\n
There are two erroring lines in our APIController right now referencing the tableData results, let’s just remove these. We’re going to use something a little cleaner.<\/p>\n
\r\ndispatch_async(dispatch_get_main_queue(), {  \/\/ DELETE ME\r\n    self.tableData = results                 \/\/ DELETE ME\r\n    self.appsTableView!.reloadData()         \/\/ DELETE ME\r\n})                                           \/\/ DELETE ME\r\n<\/pre>\n
\nAbove the class definition in our APIController, let’s add a protocol that declare the function didReceiveAPIResults() as a required implementation. Note that the protocol goes outside<\/strong> of the class definition, so make sure it’s outside of the APIController{} curly braces.<\/p>\n
 <\/p>\n
\r\nprotocol APIControllerProtocol {\r\n   func didReceiveAPIResults(results: NSArray)\r\n}\r\n<\/pre>\n
 <\/p>\n
This doesn’t do anything on it’s own, but now we can add the protocol to our SearchResultsViewController. Not adhering to the protocol will now cause an error, so we don’t make the silly mistake of not implementing didReceiveAPIResults!<\/p>\n
Adhering to the protocol<\/strong><\/p>\n
Now modify your SearchResultsViewController to adhere to the protocol:<\/p>\n
class SearchResultsViewController: UIViewController, UITableViewDataSource, UITableViewDelegate, APIControllerProtocol {<\/pre>\n
Building now should give an error that SearchResultsViewController doesn’t conform to the APIControllerProtocol, great! This is exactly what a protocol does. It causes the compiler to spit out errors if you intended to implement a protocol, but didn’t completely do it. In this case it’s barfing because we’re missing the didReceiveAPIResults() callback method. Let’s add it…<\/p>\n
We just need to add the function within our SearchResultsViewController class. It will look pretty much like the contents of our dataTaskWithURL closure from before.<\/p>\n
\r\nfunc didReceiveAPIResults(results: NSArray) {\r\n    dispatch_async(dispatch_get_main_queue(), {\r\n        self.tableData = results\r\n        self.appsTableView!.reloadData()\r\n    })\r\n}<\/pre>\n
The one thing left to do is change our API Controller to include a delegate object, and to call this method when the connection finished loading some API data.<\/p>\n
Using the Protocol<\/strong><\/p>\n
Back in our APIController.swift file, let’s add the delegate and an empty constructor, just under the class definition.<\/p>\n
\r\nvar delegate: APIControllerProtocol?\r\n<\/pre>\n
The question mark at the end here indicates that delegate is an *optional* value. Without the question mark, we will get a compiler error for not using an initial value for this variable, but with it we’re okay. The delegate object can be of any class here, as long as it adheres to the APIControllerProtocol by defining the method didReceiveAPIResults(), as we have done in our SearchResultsViewController<\/p>\n
Now that we have the delegate variable added, let’s head back to our SearchResultsViewController, and in the method viewDidLoad, let’s set the delegate for our api controller to itself, so it will receive delegate function calls.<\/p>\n
\r\napi.delegate = self\r\n<\/pre>\n
Finally, in the dataTaskWithURL closure inside of our searchItunesFor() method, let’s add our protocol method where our tableview reloading code used to be. This will pass the responsibility of reloading the UI to the delegate, which in this case is SearchResultsViewController.<\/p>\n
This goes in place of where we delete the lines refreshing the tableview earlier on.<\/p>\n
\r\nif let results: NSArray = jsonResult[\"results\"] as? NSArray {\r\n    self.delegate?.didReceiveAPIResults(results)\r\n}\r\n<\/pre>\n
Here is the completed APIController.swift code up to this point:<\/p>\n
\r\nimport Foundation\r\n\r\nprotocol APIControllerProtocol {\r\n    func didReceiveAPIResults(results: NSArray)\r\n}\r\n\r\nclass APIController {\r\n    var delegate: APIControllerProtocol?\r\n    \r\n    func searchItunesFor(searchTerm: String) {\r\n        \/\/ The iTunes API wants multiple terms separated by + symbols, so replace spaces with + signs\r\n        let itunesSearchTerm = searchTerm.stringByReplacingOccurrencesOfString(\" \", withString: \"+\", options: NSStringCompareOptions.CaseInsensitiveSearch, range: nil)\r\n        \r\n        \/\/ Now escape anything else that isn't URL-friendly\r\n        if let escapedSearchTerm = itunesSearchTerm.stringByAddingPercentEscapesUsingEncoding(NSUTF8StringEncoding) {\r\n            let urlPath = \"http:\/\/itunes.apple.com\/search?term=\\(escapedSearchTerm)&media=software\"\r\n            let url = NSURL(string: urlPath)\r\n            let session = NSURLSession.sharedSession()\r\n            let task = session.dataTaskWithURL(url!, completionHandler: {data, response, error -> Void in\r\n                println(\"Task completed\")\r\n                if(error != nil) {\r\n                    \/\/ If there is an error in the web request, print it to the console\r\n                    println(error.localizedDescription)\r\n                }\r\n                var err: NSError?\r\n                if let jsonResult = NSJSONSerialization.JSONObjectWithData(data, options: NSJSONReadingOptions.MutableContainers, error: &err) as? NSDictionary {\r\n                    if(err != nil) {\r\n                        \/\/ If there is an error parsing JSON, print it to the console\r\n                        println(\"JSON Error \\(err!.localizedDescription)\")\r\n                    }\r\n                    if let results: NSArray = jsonResult[\"results\"] as? NSArray {\r\n                        self.delegate?.didReceiveAPIResults(results)\r\n                    }\r\n                }\r\n            })\r\n            \r\n            \/\/ The task is just an object with all these properties set\r\n            \/\/ In order to actually make the web request, we need to \"resume\"\r\n            task.resume()\r\n        }\r\n    }\r\n    \r\n}\r\n<\/pre>\n
\n
Common issue here<\/h2>\n
 *** Terminating app due to uncaught exception ‘NSUnknownKeyException’, reason: ‘[ setValue:forUndefinedKey:]: this class is not key value coding-compliant for the key appsTableView.’<\/p>\n
If you get this issue, it could be caused by a few bugs in Xcode surrounding the renaming of View Controller subclasses. The best way to fix this is to open up the storyboard, select the ‘Search Results View Controller’ object. Then in the identity inspector change its class back to UIViewController, build the app, then change it back to ‘SearchResultsViewController’. This resets some things and fixes the issue.\n<\/p><\/div>\n
PHEW!<\/strong><\/p>\n
Okay, I know that might have seemed like a lot of boilerplate, and now our app does the exact same thing as it did before, but now we have something much more flexible. We can now use APIController for any API call to the iTunes search API, and have a custom delegate get the response. I think we ran out of time on this one, so we’ll move on to the interaction in Part 4<\/a>. If you want to follow along make sure to sign up for them via e-mail<\/a>.<\/p>\n
I felt this step was more important than fixing the performance issues, but I promise we’ll speed things up before we’re done. There are just some things we need to get done first. Hold tight!<\/p>\n
Full code for this section visible here<\/a>.<\/p>\n
Go to Part 4 -><\/a><\/p>\n
 <\/p>\n","protected":false},"excerpt":{"rendered":"
This section completely updated to reflect changes in Xcode 6.3, as of April 16, 2015 In parts 1 & 2 we went over some basics of Swift, and set up a simple example project that creates a Table View and a puts some API results from iTunes inside of them. If you haven’t read that…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_links_to":"","_links_to_target":""},"categories":[26,25,10,32],"tags":[],"yoast_head":"\nDeveloping iOS Apps Using Swift Part 3 - Best Practices - Jameson Quave<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Developing iOS Apps Using Swift Part 3 - Best Practices - Jameson Quave\" \/>\n<meta property=\"og:description\" content=\"This section completely updated to reflect changes in Xcode 6.3, as of April 16, 2015 In parts 1 & 2 we went over some basics of Swift, and set up a simple example project that creates a Table View and a puts some API results from iTunes inside of them. If you haven’t read that...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/\" \/>\n<meta property=\"og:site_name\" content=\"Jameson Quave\" \/>\n<meta property=\"article:published_time\" content=\"2014-06-03T14:41:48+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2015-09-03T02:41:41+00:00\" \/>\n<meta property=\"og:image\" content=\"http:\/\/jamesonquave.com\/swiftebook\/img\/sm-cover.png\" \/>\n<meta name=\"author\" content=\"Jameson Quave\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Jameson Quave\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"8 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/\",\"url\":\"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/\",\"name\":\"Developing iOS Apps Using Swift Part 3 - Best Practices - Jameson Quave\",\"isPartOf\":{\"@id\":\"https:\/\/jamesonquave.com\/blog\/#website\"},\"datePublished\":\"2014-06-03T14:41:48+00:00\",\"dateModified\":\"2015-09-03T02:41:41+00:00\",\"author\":{\"@id\":\"https:\/\/jamesonquave.com\/blog\/#\/schema\/person\/db6184f355c7f4e3b876d0f228c2fcfc\"},\"breadcrumb\":{\"@id\":\"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/jamesonquave.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Developing iOS Apps Using Swift Part 3 – Best Practices\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/jamesonquave.com\/blog\/#website\",\"url\":\"https:\/\/jamesonquave.com\/blog\/\",\"name\":\"Jameson Quave\",\"description\":\"Using computer technology to educate, and improve lives.\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/jamesonquave.com\/blog\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/jamesonquave.com\/blog\/#\/schema\/person\/db6184f355c7f4e3b876d0f228c2fcfc\",\"name\":\"Jameson Quave\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/jamesonquave.com\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/d9786c83345117d560bbeab0e1f26814?s=96&d=retro&r=pg\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/d9786c83345117d560bbeab0e1f26814?s=96&d=retro&r=pg\",\"caption\":\"Jameson Quave\"},\"sameAs\":[\"http:\/\/jamesonquave.com\"],\"url\":\"https:\/\/jamesonquave.com\/blog\/author\/jquave\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Developing iOS Apps Using Swift Part 3 - Best Practices - Jameson Quave","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/","og_locale":"en_US","og_type":"article","og_title":"Developing iOS Apps Using Swift Part 3 - Best Practices - Jameson Quave","og_description":"This section completely updated to reflect changes in Xcode 6.3, as of April 16, 2015 In parts 1 & 2 we went over some basics of Swift, and set up a simple example project that creates a Table View and a puts some API results from iTunes inside of them. If you haven’t read that...","og_url":"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/","og_site_name":"Jameson Quave","article_published_time":"2014-06-03T14:41:48+00:00","article_modified_time":"2015-09-03T02:41:41+00:00","og_image":[{"url":"http:\/\/jamesonquave.com\/swiftebook\/img\/sm-cover.png"}],"author":"Jameson Quave","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Jameson Quave","Est. reading time":"8 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/","url":"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/","name":"Developing iOS Apps Using Swift Part 3 - Best Practices - Jameson Quave","isPartOf":{"@id":"https:\/\/jamesonquave.com\/blog\/#website"},"datePublished":"2014-06-03T14:41:48+00:00","dateModified":"2015-09-03T02:41:41+00:00","author":{"@id":"https:\/\/jamesonquave.com\/blog\/#\/schema\/person\/db6184f355c7f4e3b876d0f228c2fcfc"},"breadcrumb":{"@id":"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/jamesonquave.com\/blog\/developing-ios-apps-using-swift-part-3-best-practices\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/jamesonquave.com\/blog\/"},{"@type":"ListItem","position":2,"name":"Developing iOS Apps Using Swift Part 3 – Best Practices"}]},{"@type":"WebSite","@id":"https:\/\/jamesonquave.com\/blog\/#website","url":"https:\/\/jamesonquave.com\/blog\/","name":"Jameson Quave","description":"Using computer technology to educate, and improve lives.","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/jamesonquave.com\/blog\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/jamesonquave.com\/blog\/#\/schema\/person\/db6184f355c7f4e3b876d0f228c2fcfc","name":"Jameson Quave","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/jamesonquave.com\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/d9786c83345117d560bbeab0e1f26814?s=96&d=retro&r=pg","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/d9786c83345117d560bbeab0e1f26814?s=96&d=retro&r=pg","caption":"Jameson Quave"},"sameAs":["http:\/\/jamesonquave.com"],"url":"https:\/\/jamesonquave.com\/blog\/author\/jquave\/"}]}},"_links":{"self":[{"href":"https:\/\/jamesonquave.com\/blog\/wp-json\/wp\/v2\/posts\/611"}],"collection":[{"href":"https:\/\/jamesonquave.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jamesonquave.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/jamesonquave.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/jamesonquave.com\/blog\/wp-json\/wp\/v2\/comments?post=611"}],"version-history":[{"count":31,"href":"https:\/\/jamesonquave.com\/blog\/wp-json\/wp\/v2\/posts\/611\/revisions"}],"predecessor-version":[{"id":1937,"href":"https:\/\/jamesonquave.com\/blog\/wp-json\/wp\/v2\/posts\/611\/revisions\/1937"}],"wp:attachment":[{"href":"https:\/\/jamesonquave.com\/blog\/wp-json\/wp\/v2\/media?parent=611"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jamesonquave.com\/blog\/wp-json\/wp\/v2\/categories?post=611"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jamesonquave.com\/blog\/wp-json\/wp\/v2\/tags?post=611"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}