IOS 7 Directory Handling and File I/O – A Worked Example

From Techotopia
Revision as of 19:59, 27 October 2016 by Neil (Talk | contribs) (Text replacement - "<table border="0" cellspacing="0">" to "<table border="0" cellspacing="0" width="100%">")

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
PreviousTable of ContentsNext
Working with Files on iOS 7Preparing an iOS 7 App to use iCloud Storage


Learn SwiftUI and take your iOS Development to the Next Level
SwiftUI Essentials – iOS 16 Edition book is now available in Print ($39.99) and eBook ($29.99) editions. Learn more...

Buy Print Preview Book


In the Working with Directories on iOS 7 and Working with Files on iOS 7 chapters of this book we discussed in some detail the steps involved in working with the iOS 7 file system in terms of both file and directory handling from within iOS applications. The goal of this chapter is to put theory into practice by working through the creation of a simple application that demonstrates some of the key concepts outlined in the preceding chapters.


Contents


The Example Application

The steps in this chapter walk through the creation of an iOS 7 application consisting of a text field and a button. When the user touches the button after entering text into the text field, that text is saved to a file. The next time the application is launched the content of the file is read by the application and pre-loaded into the text field.

Setting up the Application Project

The first step in creating the application is to set up a new project. To do so, start the Xcode environment and select the option to create a new project (or select the File -> New -> Project menu option if Xcode is already running or the welcome screen does not appear by default).

Select the Single View Application template, select either iPad or iPhone from the Devices and name the product and class prefix FileExample.


Designing the User Interface

The example application is going to consist of a button and a text field. To begin the user interface design process, select the Main.storyboard file to load it into the Interface Builder environment. Drag a Button and then a Text Field from the Object Library panel (View -> Utilities -> Show Object Library) onto the view. Double click on the button and change the text to Save. Position the components and resize the width of the text field so that the layout appears as illustrated in Figure 33-1:

The user interface layout for an IOS 7 file handling example app

Figure 33-1


Select the Text Field object in the view canvas, display the Assistant Editor panel and verify that the editor is displaying the contents of the FileExampleViewController.h file. Ctrl-click on the text field object and drag to a position just below the @interface line in the Assistant Editor. Release the line and in the resulting connection dialog establish an outlet connection named textBox.

Ctrl-click on the button object and drag the line to the area immediately beneath the newly created outlet in the Assistant Editor panel. Release the line and, within the resulting connection dialog, establish an Action method on the Touch Up Inside event configured to call a method named saveText.

Learn SwiftUI and take your iOS Development to the Next Level
SwiftUI Essentials – iOS 16 Edition book is now available in Print ($39.99) and eBook ($29.99) editions. Learn more...

Buy Print Preview Book

Checking the Data File on Application Startup

Each time the application is launched by the user it will need to check to see if the data file already exists (if the user has not previously saved any text, the file will not have been created). If the file does exist, the contents need to be read by the application and displayed within the text field. A good place to put initialization code of this nature is in the viewDidLoad method of the view controller. With this in mind, select the FileExampleViewController.m file, scroll down to the viewDidLoad method and edit it as follows:

- (void)viewDidLoad {
        [super viewDidLoad];
        NSFileManager *filemgr;
        NSString *dataFile;
        NSString *docsDir;
        NSArray *dirPaths;

        filemgr = [NSFileManager defaultManager];

        // Identify the documents directory
        dirPaths = NSSearchPathForDirectoriesInDomains(
           NSDocumentDirectory, NSUserDomainMask, YES);

        docsDir = dirPaths[0];

        // Build the path to the data file
        dataFile = [docsDir stringByAppendingPathComponent:
           @"datafile.dat"];

        // Check if the file already exists
        if ([filemgr fileExistsAtPath: dataFile])
        {
                // Read file contents and display in textBox
                NSData *databuffer;
                databuffer = [filemgr contentsAtPath: dataFile];

                NSString *datastring = [[NSString alloc]
                  initWithData: databuffer
                  encoding:NSASCIIStringEncoding];

                _textBox.text = datastring;
        }
}

Before proceeding we need to take some time to talk about what the above code is doing. First, we declare some variables that will be used in the method and then create an instance of the NSFileManager class. Because each iOS application on a device has its own Documents directory, we next make the appropriate calls to identify the path to that directory and assign the result to the docsDir variable. Once we know where the documents directory is located we construct the full path to our file (which is named datafile.dat) before checking whether the file already exists. If it exists, we read the contents of the file and assign it to the text property of our text field object so that it is visible to the user. Finally, we release the file manager object.

Now that we have the initialization code implemented, we need to write the code for our action method.

Implementing the Action Method

When the user enters text into our text field component and touches the save button, the text needs to be saved to the datafile.dat file located in the application’s Documents directory. In order to make this happen we need, therefore, to implement the code in our saveText action method. Select the FileExampleViewController.m file if it is not already open and modify the template saveText method we created previously so that it reads as follows:

- (void)saveText:(id)sender
{
        NSFileManager *filemgr;
        NSData *databuffer;
        NSString *dataFile;
        NSString *docsDir;
        NSArray *dirPaths;

        filemgr = [NSFileManager defaultManager];

        dirPaths = NSSearchPathForDirectoriesInDomains(
           NSDocumentDirectory, NSUserDomainMask, YES);

        docsDir = dirPaths[0];
        dataFile = [docsDir
          stringByAppendingPathComponent: @"datafile.dat"];
        databuffer = [_textBox.text
          dataUsingEncoding: NSASCIIStringEncoding];
        [filemgr createFileAtPath: dataFile
          contents: databuffer attributes:nil];
}

This code creates a file manager instance, identifies the documents directory and constructs the full path to our data file. It then converts the text contained in the text field object and assigns it to an NSData object, the contents of which are written to the data file by calling the createFileAtPath method of the file manager object.

Building and Running the Example

Once the appropriate code changes have been made, test the application by clicking on the Run button located in the toolbar of the main Xcode project window. Assuming no compilation errors are encountered, the application should run within the iOS Simulator.

When the application has loaded, enter some text into the text field and click on the Save button. Next, stop the app by clicking on the stop button in the Xcode toolbar and then restart the app by clicking Run again. On loading for a second time the text field will be primed with the text saved during the previous session:


An iOS 7 file handling example app running

Figure 33-2


Learn SwiftUI and take your iOS Development to the Next Level
SwiftUI Essentials – iOS 16 Edition book is now available in Print ($39.99) and eBook ($29.99) editions. Learn more...

Buy Print Preview Book



PreviousTable of ContentsNext
Working with Files on iOS 7Preparing an iOS 7 App to use iCloud Storage