Sunday 15 April 2012

Core Data


Core Data

In simplest terms, Core Data is an object graph that can be persisted to Disk. [...] Core Data can do a lot more for us. It serves as the entire model layer for us. It is not just the persistence on disk, but it is also all the objects in memory that we normally consider to be data objects.
—Marcus Zarra, Core Data
Core data that would be it is used to store data from your iPhone application into a sqlite file which is present in the document directory of your application. Core data is a framework that provides you the support to make your data objects persist in the memory.  As a programmer you are supposed to deal more with the objects and less with the sql queries, opening the db connection, closing the db connection etc. Core data makes you focus on that part better. You will be creating objects and core data will take care of storing the objects in the memory. You send a fetch request and core date will fetch those objects from the database to the main memory back again. This is how it works.
With the release of version 3.0, Apple has made their Core Data system available on the iPhone OS. Core Data has been available on the Macintosh platform for a number of years, and provides a high-level data abstraction framework that offers integrated design tools and runtime support to address complex data management needs unlike SQLite, the Core Data model is not strictly relational in nature.

if core data is used to store data for our application then why do we use SQlite,

Sqlite is a relation db, so you can use SQL to talk to a sqlite database. You can create tables, columns. You can create relationships between these tables etc. So you will be having a sqlite database file and a C language API to open the db connection, executing an SQL query and closing the db. This way you can persist the data from your application.
Core Data is not a relational database. Though you can go for sqlite as a store type where core data stores the data, its not a relational database. Rather we should not compare it with relation database. It’s an object graph persistence system. You can user core data to persist objects on the hard drive. Some operations are not possible with core data like Join Query, Merge query, Union query, inner query etc.


Core Data Architecture

In Core Data each and every entity is referred to as objects, objects that have relationship with them. Let’s say there are two entities Parent and Child having relationship with them then in this case Parent and Child will be referred as objects and in Core data and you can easily manipulate them. If your application is particularly well suited to the Relational Model, there may be advantages to having direct SQL query access to the data storage layer. Some of the basic classes that you must know in order to precede with core data are given below:



 Core Data Architecture


ManagedObject: Managed objects are the objects that are created by your application code to store data. A managed object can be thought of as a row or a record in a relational database table. For each new record to be added, a new managed object must be created to store the data. Similarly, retrieved data will be returned in the form of managed objects, one for each record matching the defined retrieval criteria. Managed objects are actually instances of the NSManagedObject class, or a subclass thereof. These objects are contained and maintained by the managed object context.
Persistance store coordinator: The persistent store coordinator is responsible for coordinating access to multiple persistent object stores. As an iPhone developer you will never directly interact with the persistence store coordinator and, in fact, will very rarely need to develop an application that requires more than one persistent object store. When multiple stores are required, the coordinator presents these stores to the upper layers of the Core Data stack as a single store.

Managed Object Context: Core Data based applications never interact directly with the persistent store. Instead, the application code interacts with the managed objects contained in the managed object context layer of the Core Data stack. The context maintains the status of the objects in relation to the underlying data store and manages the relationships between managed objects defined by the managed object model. All interactions with the underlying database are held temporarily in within the context until the context is instructed to save the changes, at which point the changes are passed down through the Core Data stack and written to the persistent store.

We will be following some steps to make the core data application so that we don’t mess up while using core data. We are going to work with the database having two entities Album and Song . We will have two tables Album and Song. Album will have two attributes name and year. Song will have one attribute name.

* Create a new project , select Empty Application ( Window based Application on XCode ). This time, check the checkbox saying, “Use core data”



Once you create project, you will see below files


You can see the CoreData framework and a CoreDataDemo.xcdatamodeld file have been added in the project. If you observer AppDelegate.h, three properties must have been added too.
@interface AppDelegate : UIResponder <UIApplicationDelegate>
{

}
@property (strong, nonatomic) UIWindow *window;

@property (readonly, strong, nonatomic) NSManagedObjectContext *managedObjectContext;

@property (readonly, strong, nonatomic) NSManagedObjectModel *managedObjectModel;

@property (readonly, strong, nonatomic) NSPersistentStoreCoordinator *persistentStoreCoordinator;

- (void)saveContext;
- (NSURL *)applicationDocumentsDirectory;

@end

All three are ready only. If you go to AppDelegate.m, a getter method has been defined for all three properties. These getter methods setup the coredata database and all the required objects that are managedObjectContext, managedObjectModel and persistentStoreCoordinator.  You can go ahead and check the AppDelegate.m for these getter methods.
Next lets open the CoreDataDemo.xcdatamodel file. This file represents the database schema of the database. It opens in a GUI editor into the XCode only. We will be designing the database schema using this editor. It should look like below.


This displays the database schema in two different editor style. You can see an Editor style button at the bottom right.





                                               Style 1                                              Style 2


Style 1 is what it looks like in the above screenshot. We will be using this style to actually edit the database schema. We will be adding new Entities ( Tables ) , attributes (columns) to an Entity . We will be adding the relationships in two Entities etc.
Style 2 will displays the graphical representation of the schema. Once done designing the schema in the first style, you can verify that in the second style visually.
Style 2 looks like as the screen shot below.


Ok, lets switch to the style 1 and start designing the database schema. You will see left pane with three sections Entites, Fetch Requests and Configurations.
Click on “Add Entity” button at the bottom. This will add the entity. Name it Album. Then add the attributes to the Album table in the Attributes section on the right.






Same way, add Song Entity and add an attribute “name” in the Song table.


Next we need to add relationships in these two entities.  Select the Album entity and add a relation ship there. Give it a name albumToSong. Set the Destination as “Song”.



In the details view on the right side, we need to set some more properties. Check the “To-Many Relationship” checkmark. This how we can specify that Album to Song is one-to-many relationship. An Album can have multiple songs.

There are some other advanced options that you can set as well eg. You may set the Delete Rule to Cascade if you want.
Next add a relationship to the Song Entity. Name it  “songToAlbum”. You can simply make it the inverse of “albumToSong” by selecting it into the last drop down list. It should then look like below.


You can visually verify the design by changing the editor style to style 2. It should look like below.

That’s it, we are done with the design of the database schema. Its time to create the NSManagedObject classes for Album and Song entities.
Select these two entities and right click on resources section. Click on “Add New file” option. Navigate to CoreData section over there and select the NSManagedObject subclass. Click next and on the next page click create. This will add two classes to the project that are Album and Song.




The resources should have two more classes now.


If you check out the classes, every class has go the needed method. Like Album should have a methods like

-   (void)addAlbumToSongObject:(Song *)value;
-   (void)removeAlbumToSongObject:(Song *)value;
-   (void)addAlbumToSong:(NSSet *)values;
-   (void)removeAlbumToSong:(NSSet *)values;

Same goes for Song. All the required methods must have been added to the Song class as well. Now its time to go the AppDelegate and perform some operations like inserting objects to and reading objects from the database.
Go to AppDelegate.m and write a method insertData as below. insertData will insert some objects in to the database
                    
-(void)insertData
{
    Album * alb1 = [NSEntityDescription insertNewObjectForEntityForName:@"Album" inManagedObjectContext:self.managedObjectContext];
    alb1.name = @"Rockstar";
    alb1.year = [NSNumber numberWithInt:2011];
   
    Song * s1 = [NSEntityDescription insertNewObjectForEntityForName:@"Song" inManagedObjectContext:self.managedObjectContext];
    s1.name = @"Sadda haq";
   
    Song * s2 = [NSEntityDescription insertNewObjectForEntityForName:@"Song" inManagedObjectContext:self.managedObjectContext];
    s2.name = @"Jo Bhi Main";
   
    Album * alb2 = [NSEntityDescription insertNewObjectForEntityForName:@"Album" inManagedObjectContext:self.managedObjectContext];
    alb2.name = @"Nirvana";
    alb2.year = [NSNumber numberWithInt:1988];
   
    Song * s3 = [NSEntityDescription insertNewObjectForEntityForName:@"Song" inManagedObjectContext:self.managedObjectContext];
    s3.name = @"Come as You are";
   
    Song * s4 = [NSEntityDescription insertNewObjectForEntityForName:@"Song" inManagedObjectContext:self.managedObjectContext];
    s4.name = @"The man who sold The World";
   
    [alb1 addAlbumToSongObject:s1];
    [alb1 addAlbumToSongObject:s2];
    [alb2 addAlbumToSongObject:s3];
    [alb2 addAlbumToSongObject:s4];
   
    [self.managedObjectContext save:nil];
   
}


In the above method, we are creating two Album objects alb1 and alb2. There are four Song objects s1,s2,s3 and  s4. After that we add song objects to the corresponding album objects. Finally we save the context. Till this line all objects are created in the context. In order to save the objects into database, you need to call save method on the context object.  Lets call this method from didFinishLaunching as below.

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    self.window = [[[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]] autorelease];

    [self insertData];
   
    self.window.backgroundColor = [UIColor whiteColor];
    [self.window makeKeyAndVisible];
    return YES;
}


Run the App and it will insert the data into the database. Next we write a readData method that will read the data from the database.

-(void)readData
{
    NSFetchRequest * req = [[NSFetchRequest alloc]init];

    [req setEntity:[NSEntityDescription entityForName:@"Album" inManagedObjectContext:self.managedObjectContext]];
   
    NSArray * result = [self.managedObjectContext executeFetchRequest:req error:nil];
   
    for (Album * alb in result)
    {
        NSLog(@"Album Name : %@",alb.name);
        NSLog(@"Album Year : %@",alb.year);
       
        for( Song * sng in alb.albumToSong )
        {
            NSLog(@"    Song Name : %@",sng.name);
        }
    }     
}

NSFetchRequest : This class is used to create query objects.
We create fetch request, then set the Entity to Album. This is going to be simple “ select * from Album” query. After that we execute the fetch request on the context object. Context executes the fetch request and returns the result. The result of the query is going to be an array of Album objects. So we catch it in an array called “result”. After that we iterate through the “result” array and print the Album objects. When we get an album object we can access the “albumToSong” property of it to access all the song objects for this album. This property is of type NSSet because an album can have multiple songs as per the one-to-many relationship. We then iterate over all the songs for an album and print those as well.  Lets give a call to the readData method from didFinishLaunching and comment the insertData call.

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    self.window = [[[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]] autorelease];

    // [self insertData];
   
    [self readData];
   
    self.window.backgroundColor = [UIColor whiteColor];
    [self.window makeKeyAndVisible];
    return YES;
}


Run the App and you should see the below output on the Console.




2 comments: