Woohoo … my first Objective-C related post!
Ok, so this is nothing new but I thought I’d log a couple of things that caught me out as a NOOB to the whole iPhone development malarky.
First off archiving your objects is a way of saving them to a property list file that sits on your device and can be unarchived the next time your app loads as a way to persist data locally on the device. Very handy it is too. Now there are better ways to manage data in Obj-C … CoreData for a start. This is a much more powerful way to persist data to a SQL lite database and allows you loads more freedom in what you can actually archive. There are limitations to the property list method you see. You can only archive NS objects and simple scalars so your class structure needs to compensate for this. The ‘plist’ objects you can archive are … NSArray, NSDictionary, NSString, NSNumber, NSDate and NSData along with their mutable subclasses. The scalars are int, float, double etc.
I don’t want to write a massive chapter on this and there’s loads of information online about the technical ins and outs of what’s happening behind the scenes. What I do want to do is share the classes I’ve used in a recent project and explain in basics what’s happening.
Firstly we’ll create the object we want to be archived. Any object that needs to be archived and is a subclass of NSObject must adopt the NSCoding protocol. Take a look at this object …
DataModel Object for archiving
- /* INTERFACE */
- #define kfavesArray @"favesArray"
- #define kCurrentFave @"currentFave"
- #define kCurrentFaveIndex @"currentFaveIndexPath"
- #import <Foundation/Foundation.h>
- @class FaveVO;
- @interface DataModel : NSObject <NSCoding>
- {
- NSMutableArray *favesArray;
- FaveVO *currentFave;
- int faveIndex;
- }
- @property (nonatomic, retain) NSMutableArray *favesArray;
- @property (nonatomic, retain) FaveVO *currentFave;
- @property int faveIndex;
- -(void)addNewFaveLocation:(FaveVO *)fave;
- -(void)createNewFaveVOFromFaveVO:(FaveVO *)fave;
- -(void)setFaveLocation:(int)index;
- -(void)removeFaveLocation;
- @end
- /* IMPLEMENTATION */
- #import "DataModel.h"
- #import "FaveVO.h"
- @implementation DataModel
- @synthesize favesArray;
- @synthesize currentFave;
- @synthesize faveIndex;
- //------------------------------------------------------
- -(id)init
- {
- if(self = [super init])
- {
- favesArray = [[NSMutableArray alloc] init];
- }
- return self;
- }
- //--------------------------------------------------
- -(void)addNewFaveLocation:(FaveVO *)fave
- {
- if(!favesArray) favesArray = [[NSMutableArray alloc] init];
- [favesArray insertObject:fave atIndex:0];
- currentFave = [favesArray objectAtIndex:0];
- faveIndex = 0;
- NSLog(@"DataModel currentFave: %@ faveIndex: %i", currentFave,faveIndex);
- }
- //--------------------------------------------------
- -(void)setFaveLocation:(int)index
- {
- currentFave = [favesArray objectAtIndex:index];
- faveIndex = index;
- NSLog(@"DataModel currentFave: %@ faveIndex: %i", currentFave,faveIndex);
- }
- //--------------------------------------------------
- -(void)removeFaveLocation
- {
- currentFave = nil;
- NSLog(@"DataModel currentFave: %@ faveIndex: %i", currentFave,faveIndex);
- }
- //--------------------------------------------------
- -(void)createNewFaveVOFromFaveVO:(FaveVO *)fave
- {
- double lat = fave.lat;
- double lon = fave.lon;
- FaveVO *newFaveVO = [[FaveVO alloc] initWithLabel:[NSString stringWithString:fave.label]
- streetAddress:[NSString stringWithString:fave.streetAddress]
- city:[NSString stringWithString:fave.city]
- state:[NSString stringWithString:fave.state]
- zip:[NSString stringWithString:fave.zip]
- lat:lat
- lon:lon];
- [favesArray addObject:newFaveVO];
- [newFaveVO release];
- }
- //--------------------------------------------------
- -(void)dealloc
- {
- [favesArray release];
- [currentFave release];
- [super dealloc];
- }
- //--------------------------------------------------
- //--------------------------------------------------
- #pragma mark NSCoding
- - (void)encodeWithCoder:(NSCoder *)encoder
- {
- [encoder encodeObject:favesArray forKey:kfavesArray];
- [encoder encodeObject:currentFave forKey:kCurrentFave];
- [encoder encodeInt:faveIndex forKey:kCurrentFaveIndex];
- }
- //--------------------------------------------------
- - (id)initWithCoder:(NSCoder *)decoder
- {
- NSLog(@"DataModel initWithCoder: %@", decoder);
- if (self = [super init])
- {
- self.favesArray = [decoder decodeObjectForKey:kfavesArray];
- self.faveIndex = [decoder decodeIntForKey:kCurrentFaveIndex];
- self.currentFave = [favesArray objectAtIndex:faveIndex];
- }
- return self;
- }
- @end
This object also references another object called FaveVO this is an object that I’m feeding into an array and also adopts the NSCoding protocol so you can see that you can archive quite a complicated object overall.
The important stuff is after the line that says “#pragma mark NSCoding”. These methods (using Actionscript terminology but I don’t care) handle what happens when the encoder and decoder go to work on your object.
- (void)encodeWithCoder:(NSCoder *)encoder
{
[encoder encodeObject:favesArray forKey:kfavesArray];
[encoder encodeObject:currentFave forKey:kCurrentFave];
[encoder encodeInt:faveIndex forKey:kCurrentFaveIndex];
}
The encodeObject message takes each of my class variables and copies them into an NSData object using the keys which I defined in the interface. These are unique identifiers that I can use when I want to decode them later like so :
- (id)initWithCoder:(NSCoder *)decoder
{
if (self = [super init])
{
self.favesArray = [decoder decodeObjectForKey:kfavesArray];
self.faveIndex = [decoder decodeIntForKey:kCurrentFaveIndex];
self.currentFave = [favesArray objectAtIndex:faveIndex];
}
return self;
}
And that’s all you need to know about the Object you want to archive. Next comes the class that I’m using to do the archiving and unarchiving.
Here’s the class :
Archiving and Unarchiving DataModel Object
- /* INTERFACE */
- #import <Foundation/Foundation.h>
- #define kFilename @"dataarchive.plist"
- #define kDataKey @"Data"
- @class DataModel;
- @interface DataManager : NSObject {
- DataModel *dataModel;
- }
- @property (nonatomic, retain) DataModel *dataModel;
- -(NSString *)dataFilePath;
- -(void)initDataModel;
- -(void)applicationWillTerminate:(NSNotification *)notification;
- +(DataManager *)sharedDataManager;
- @end
- /* IMPLEMENTATION */
- #import "DataManager.h"
- #import "SynthesizeSingleton.h"
- #import "DataModel.h"
- #import "FaveVO.h"
- @implementation DataManager
- SYNTHESIZE_SINGLETON_FOR_CLASS(DataManager);
- @synthesize dataModel;
- //-----------------------------------------------------------------------------------------------------
- - (NSString *)dataFilePath
- {
- NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
- NSString *documentsDirectory = [paths objectAtIndex:0];
- return [documentsDirectory stringByAppendingPathComponent:kFilename];
- }
- //-----------------------------------------------------------------------------------------------------
- -(void)initDataModel
- {
- NSString *filePath = [self dataFilePath];
- if([[NSFileManager defaultManager] fileExistsAtPath:filePath])
- {
- NSLog(@"FILE EXISTS");
- NSData *data = [[NSMutableData alloc] initWithContentsOfFile:[self dataFilePath]];
- NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc] initForReadingWithData:data];
- DataModel *decodedDataModel = [unarchiver decodeObjectForKey:kDataKey];
- dataModel = [[DataModel alloc] init];
- NSEnumerator *enumerator;
- enumerator = [decodedDataModel.favesArray objectEnumerator];
- FaveVO *decodedFaveVO;
- while (decodedFaveVO = [enumerator nextObject])
- {
- [dataModel createNewFaveVOFromFaveVO:decodedFaveVO];
- }
- int index = decodedDataModel.faveIndex;
- dataModel.faveIndex = index;
- dataModel.currentFave = [dataModel.favesArray objectAtIndex:index];
- [unarchiver finishDecoding];
- [unarchiver release];
- [data release];
- }
- else
- {
- NSLog(@"FILE DOES NOT EXIST");
- dataModel = [[DataModel alloc] init];
- }
- UIApplication *app = [UIApplication sharedApplication];
- [[NSNotificationCenter defaultCenter] addObserver:self
- selector:@selector(applicationWillTerminate:)
- name:UIApplicationWillTerminateNotification
- object:app];
- }
- //-------------------------------------------------------------
- - (void)applicationWillTerminate:(NSNotification *)notification
- {
- NSLog(@"Application will terminate");
- NSMutableData *data = [[NSMutableData alloc] init];
- NSKeyedArchiver *archiver = [[NSKeyedArchiver alloc] initForWritingWithMutableData:data];
- [archiver encodeObject:dataModel forKey:kDataKey];
- [archiver finishEncoding];
- [data writeToFile:[self dataFilePath] atomically:YES];
- [archiver release];
- [data release];
- }
- //--------------------------------------------------
- -(void)dealloc
- {
- [dataModel release];
- [super dealloc];
- }
- @end
The initDataModel method looks for the property list and then uses the NSKeyedUnarchiver object to decode the objects. When the application terminates the objects are encoded using the NSKeyedArchiver object. The class listens for the ApplicationWillTerminate notification using the NSNotificationCenter object. This is similar to the Actionscript event model that uses listeners. The NSEnumerator object is used to step through an array of objects. The decoded FaveVO objects are then sent through to my DataModel class and passed to the createNewFaveVOFromFaveVO method which is where the objects are re-created as shiny new objects. Remember the NSKeyedUnarchiver object is released so you need to retain the objects you need … usually better to create new ones within the correct scope.
Recent Comments