🧚🏿 🏇🏽 ♟️ पार्सिंग iPhone कोर डेटा व्यंजनों। भाग 1 🍭 👩🏻‍🤝‍👨🏼 🌈

परिचय

इस लेख का उद्देश्य एक नौसिखिया iOS डेवलपर को यह समझने में मदद करना है कि कोर डेटा का उपयोग कर SQLite डेटाबेस के साथ iPhone कोर डेटा व्यंजनों का उपयोग करके एक उदाहरण के रूप में सही ढंग से कैसे काम किया जाए। लेखों की एक श्रृंखला के पहले भाग में, हम एप्लिकेशन और डेटाबेस की परस्पर क्रिया पर विचार करेंगे, साथ ही संबंधित अभिलेखों (संबंधों) के साथ काम करेंगे।

आवश्यक शर्तें

इस एप्लिकेशन के स्रोत कोड के स्वतंत्र अध्ययन के लिए, आपको उपकरणों के एक मानक सेट की आवश्यकता है:

मैक ओएस एक्स
Xcode

यह सेट आपको सिम्युलेटर पर एप्लिकेशन को देखने, संशोधित करने और चलाने की अनुमति देगा। यदि आप इसे वास्तविक iPhone पर चलाने का प्रयास करना चाहते हैं, तो iOS डेवलपर प्रोग्राम में भागीदारी आवश्यक है।

और इसके अलावा, महत्वपूर्ण रूप से, आपको ऑब्जेक्ट-सी भाषा और एप्लिकेशन की संरचना की एक बुनियादी समझ की आवश्यकता है।

उपयोग की गई सामग्रियों और उपकरणों के लिंक सन्दर्भ अनुभाग में दिए गए हैं।

क्या है iPhone कोर डाटा रेसिपी?

Xcode Apple डेवलपर्स का एक प्रोजेक्ट है जो iPhone एप्लिकेशन में व्यू कंट्रोलर, टेबल व्यू और कोर डेटा का उपयोग करने का एक सामान्य विचार देता है। बेशक, यह परियोजना आईपैड के लिए भी प्रासंगिक है, लेकिन आईपैड पर इसे सही ढंग से प्रदर्शित करने के लिए इंटरफ़ेस परिवर्तन करना आवश्यक है।

iPhone कोर डेटा व्यंजनों स्क्रीनशॉट

नीचे दिए गए स्क्रीनशॉट एप्लिकेशन इंटरफ़ेस का अवलोकन देते हैं। मुख्य व्यंजनों विंडो में, तैयार उत्पादों की एक सूची प्रदर्शित की जाती है। उनमें से एक पर क्लिक करके, एप्लिकेशन इस उत्पाद को कैसे पकाने के बारे में जानकारी प्रदर्शित करता है, इसकी श्रेणी, कितना समय की आवश्यकता है, क्या और कितनी सामग्री की आवश्यकता है, साथ ही एक बटन जो खाना पकाने के लिए शाब्दिक निर्देश प्रदर्शित करता है (स्क्रीनशॉट नहीं दिखाया गया है)। इसके अलावा आवेदन में ग्राम, पाउंड और औंस, साथ ही तापमान पत्राचार (सेल्सियस और फ़ारेनहाइट) की तालिका के बीच मूल्यों को परिवर्तित करने की संभावना है।

डेटाबेस संरचना

डेटाबेस संरचना का एक सामान्य विचार नीचे स्क्रीनशॉट से प्राप्त किया जा सकता है:

आप Xcode में Recipes.xcdatamodel फ़ाइल खोलकर संरचना का अधिक विस्तार से अध्ययन कर सकते हैं।

तालिकाओं का वर्णन

पकाने की विधि तालिका में निम्नलिखित विशेषताएं शामिल हैं:

स्ट्रिंग के निर्देश
स्ट्रिंग का नाम
स्ट्रिंग का प्रकार
प्रकार स्ट्रिंग का पूर्व-समय
थंबनेल प्रकार के ट्रांसफॉर्मेबल

संघटक तालिका में निम्नलिखित विशेषताएं हैं:

स्ट्रिंग का प्रकार
प्रदर्शनकर्ता प्रकार का पूर्णांक 16
स्ट्रिंग का नाम

रेसिपी टाइप तालिका में निम्नलिखित विशेषताएं हैं:

स्ट्रिंग का नाम

छवि तालिका में निम्नलिखित विशेषताएं हैं:

प्रकार की छवि

मुझे लगता है कि मानक प्रकारों के साथ सब कुछ स्पष्ट है। लेकिन यह किस तरह का ट्रांसफॉर्मेबल है? कोर डेटा कई प्रकार के मानक प्रकारों का समर्थन करता है, जैसे कि स्ट्रिंग, दिनांक, या संख्या। लेकिन कभी-कभी यह एक विशेषता बनाने के लिए आवश्यक है जिसका मूल्य सीधे समर्थित नहीं है। उदाहरण के लिए, एक चित्र या रंग को संग्रहीत करने के लिए जो NSImage और NSColor वर्गों के उदाहरण हैं। इसके लिए, ट्रांसफॉर्मेबल प्रकार की आवश्यकता है, इस प्रकार का एक विस्तृत विवरण, आप गैर-मानक स्थायी विशेषताओं अनुभाग में iOS डेवलपर लाइब्रेरी वेबसाइट पर पढ़ सकते हैं (संदर्भ अनुभाग में लिंक देखें)।

तालिकाओं के बीच संबंध

डेटाबेस संरचना में, एक मुख्य नुस्खा तालिका है, जिसमें तीन अन्य लोगों के साथ विभिन्न प्रकार के कनेक्शन हैं। उदाहरण के लिए, रेसिपी तालिका में संघटक तालिका के साथ एक-से-कई संबंध होते हैं। संचार के प्रकार और दिशा को तीरों और उनकी संख्या से समझा जा सकता है। उदाहरण के लिए, रेसिपी टेबल का रेसिपी टेबल के साथ एक-से-एक संबंध होता है, लेकिन रेसिपी टेबल का रेसिपी टेबल के साथ एक-से-कई संबंध होता है, अर्थात। दोतरफा संचार एक ही प्रकार का नहीं है। इसका मतलब यह है कि रेसिपी टेबल से रिकॉर्ड को रेसिपी टेबल से केवल एक रिकॉर्ड के साथ जोड़ा जा सकता है, लेकिन साथ ही रेसिपी टेबल से रिकॉर्ड को रिकाइप टेबल से कई रिकॉर्ड के साथ जोड़ा जा सकता है। इस विशेष उदाहरण में, सरल शब्दों में, हम कह सकते हैं कि एक उत्पाद केवल एक श्रेणी में हो सकता है, जबकि विभिन्न उत्पाद भी उसी श्रेणी में हो सकते हैं, उदाहरण के लिए, डेसर्ट श्रेणी में।

कोर डेटा स्वचालित रूप से संबंधों का प्रबंधन करता है, अर्थात आपको केवल उन्हें अपने मॉडल में सही ढंग से बनाने की आवश्यकता है।

संबंध का प्रकार डेटा मॉडल इंस्पेक्टर में संबंध गुणों में सेट किया गया है (नीचे उदाहरण देखें)।

अपने डेटाबेस की संरचना को डिज़ाइन करते समय, कनेक्शन गुणों में हटाए गए नियम के बारे में नहीं भूलना महत्वपूर्ण है। इस उदाहरण में, जब कोई उत्पाद हटाया जाता है, तो उसके सभी अवयव हटा दिए जाते हैं।

कक्षाएं

डेटाबेस डिज़ाइन पूरा करने के बाद, आपको अपने मॉडल के लिए ऑब्जेक्टिव-सी क्लासेस जेनरेट करना होगा। हमारे मामले में, हमारे पास नुस्खा और संघटक तालिकाओं के लिए कक्षाएं हैं।

Recipe.h

@interface ImageToDataTransformer : NSValueTransformer { } @end @interface Recipe : NSManagedObject { } @property (nonatomic, retain) NSString *instructions; @property (nonatomic, retain) NSString *name; @property (nonatomic, retain) NSString *overview; @property (nonatomic, retain) NSString *prepTime; @property (nonatomic, retain) NSSet *ingredients; @property (nonatomic, retain) UIImage *thumbnailImage; @property (nonatomic, retain) NSManagedObject *image; @property (nonatomic, retain) NSManagedObject *type; @end @interface Recipe (CoreDataGeneratedAccessors) - (void)addIngredientsObject:(NSManagedObject *)value; - (void)removeIngredientsObject:(NSManagedObject *)value; - (void)addIngredients:(NSSet *)value; - (void)removeIngredients:(NSSet *)value; @end

Ingredient.h

 @class Recipe; @interface Ingredient : NSManagedObject { } @property (nonatomic, retain) NSString *name; @property (nonatomic, retain) NSString *amount; @property (nonatomic, retain) Recipe *recipe; @property (nonatomic, retain) NSNumber *displayOrder; @end

स्रोत कोड

हम आवेदन और डेटाबेस की बातचीत के दौरान स्रोत का अध्ययन करना शुरू करते हैं।

RecipesAppDelegate.h फ़ाइल में NSManagedObjectModel, NSManagedObjectContext और NSPersistentStoreCoordinator गुणों की घोषणाएँ शामिल हैं जो डेटाबेस के साथ काम करने के लिए आवश्यक हैं:

 @class RecipeListTableViewController; @interface RecipesAppDelegate : NSObject <UIApplicationDelegate> { NSManagedObjectModel *managedObjectModel; NSManagedObjectContext *managedObjectContext; NSPersistentStoreCoordinator *persistentStoreCoordinator; } @property (nonatomic, retain, readonly) NSManagedObjectModel *managedObjectModel; @property (nonatomic, retain, readonly) NSManagedObjectContext *managedObjectContext; @property (nonatomic, retain, readonly) NSPersistentStoreCoordinator *persistentStoreCoordinator; - (NSString *)applicationDocumentsDirectory; @end

RecipesAppDelegate.m फ़ाइल इन गुणों का प्रबंधन करती है और यह भी सुनिश्चित करती है कि डेटा सुसंगत है।

 ... - (void)applicationDidFinishLaunching:(UIApplication *)application { recipeListController.managedObjectContext = self.managedObjectContext; ... } //   ,  ,    - (void)applicationWillTerminate:(UIApplication *)application { NSError *error; if (managedObjectContext != nil) { if ([managedObjectContext hasChanges] && ![managedObjectContext save:&error]) { NSLog(@"Unresolved error %@, %@", error, [error userInfo]); abort(); } } } //  NSManagedObjectContext,      - (NSManagedObjectContext *)managedObjectContext { if (managedObjectContext != nil) { return managedObjectContext; } NSPersistentStoreCoordinator *coordinator = [self persistentStoreCoordinator]; if (coordinator != nil) { managedObjectContext = [NSManagedObjectContext new]; [managedObjectContext setPersistentStoreCoordinator: coordinator]; } return managedObjectContext; } //  NSManagedObjectModel,      - (NSManagedObjectModel *)managedObjectModel { if (managedObjectModel != nil) { return managedObjectModel; } managedObjectModel = [[NSManagedObjectModel mergedModelFromBundles:nil] retain]; return managedObjectModel; } //   NSPersistentStoreCoordinator,     . NSPersistentStoreCoordinator       - (NSPersistentStoreCoordinator *)persistentStoreCoordinator { if (persistentStoreCoordinator != nil) { return persistentStoreCoordinator; } NSString *storePath = [[self applicationDocumentsDirectory] stringByAppendingPathComponent:@"Recipes.sqlite"]; /*        ,  ,     .        . */ NSFileManager *fileManager = [NSFileManager defaultManager]; if (![fileManager fileExistsAtPath:storePath]) { NSString *defaultStorePath = [[NSBundle mainBundle] pathForResource:@"Recipes" ofType:@"sqlite"]; if (defaultStorePath) { [fileManager copyItemAtPath:defaultStorePath toPath:storePath error:NULL]; } } NSURL *storeUrl = [NSURL fileURLWithPath:storePath]; NSError *error; persistentStoreCoordinator = [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel: [self managedObjectModel]]; if (![persistentStoreCoordinator addPersistentStoreWithType:NSSQLiteStoreType configuration:nil URL:storeUrl options:nil error:&error]) { NSLog(@"Unresolved error %@, %@", error, [error userInfo]); abort(); } return persistentStoreCoordinator; } //    Documents  - (NSString *)applicationDocumentsDirectory { return [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject]; } ...

अब, हमें मुख्य एप्लिकेशन विंडो में उत्पादों की सूची प्रदर्शित करने की आवश्यकता है। RecipeListTableViewController.m फ़ाइल (RecipeListTableViewController इंटरफ़ेस) में आवश्यक कोड है

 ... //     Recipe - (NSFetchedResultsController *)fetchedResultsController { if (fetchedResultsController == nil) { NSFetchRequest *fetchRequest = [[NSFetchRequest alloc] init]; NSEntityDescription *entity = [NSEntityDescription entityForName:@"Recipe" inManagedObjectContext:managedObjectContext]; [fetchRequest setEntity:entity]; //     NSSortDescriptor *sortDescriptor = [[NSSortDescriptor alloc] initWithKey:@"name" ascending:YES]; NSArray *sortDescriptors = [[NSArray alloc] initWithObjects:sortDescriptor, nil]; [fetchRequest setSortDescriptors:sortDescriptors]; NSFetchedResultsController *aFetchedResultsController = [[NSFetchedResultsController alloc] initWithFetchRequest:fetchRequest managedObjectContext:managedObjectContext sectionNameKeyPath:nil cacheName:@"Root"]; aFetchedResultsController.delegate = self; self.fetchedResultsController = aFetchedResultsController; [aFetchedResultsController release]; [fetchRequest release]; [sortDescriptor release]; [sortDescriptors release]; } return fetchedResultsController; } ... - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { //  RecipeTableViewCell      . RecipeTableViewCell      UITableViewCell static NSString *RecipeCellIdentifier = @"RecipeCellIdentifier"; RecipeTableViewCell *recipeCell = (RecipeTableViewCell *)[tableView dequeueReusableCellWithIdentifier:RecipeCellIdentifier]; if (recipeCell == nil) { recipeCell = [[[RecipeTableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:RecipeCellIdentifier] autorelease]; recipeCell.accessoryType = UITableViewCellAccessoryDisclosureIndicator; } [self configureCell:recipeCell atIndexPath:indexPath]; return recipeCell; } - (void)configureCell:(RecipeTableViewCell *)cell atIndexPath:(NSIndexPath *)indexPath { //   Recipe *recipe = (Recipe *)[fetchedResultsController objectAtIndexPath:indexPath]; cell.recipe = recipe; } ...

सब कुछ, यह कोड मुख्य विंडो में उत्पादों की सूची प्रदर्शित करने के लिए पर्याप्त है। बेशक, यह मत भूलो कि यहां मैंने सभी कोड नहीं दिए, लेकिन इसके केवल अंश हैं। उदाहरण के लिए, RecipeListTableViewController.m फाइल को खोलकर आप यह अध्ययन कर सकते हैं कि एप्लिकेशन मॉनिटर को कैसे बदलता है (didChangeSection, didChangeObject, नियंत्रकWillChangeContent, commEditingStyle, आदि)।

हम सामग्री की सूची प्रदर्शित करने के लिए आगे बढ़ते हैं। इसके लिए, हमारे पास RecipeDetailViewController इंटरफ़ेस है, जो बदले में, निम्नलिखित गुण रखता है

 Recipe *recipe; NSMutableArray *ingredients; @property (nonatomic, retain) Recipe *recipe; @property (nonatomic, retain) NSMutableArray *ingredients;

RecipeListTableViewController इंटरफ़ेस से RecipeDetailViewController इंटरफ़ेस करने के लिए वर्तमान नुस्खा पासिंग

 ... //    - (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath { Recipe *recipe = (Recipe *)[fetchedResultsController objectAtIndexPath:indexPath]; [self showRecipe:recipe animated:YES]; } ... - (void)showRecipe:(Recipe *)recipe animated:(BOOL)animated { RecipeDetailViewController *detailViewController = [[RecipeDetailViewController alloc] initWithStyle:UITableViewStyleGrouped]; //  detailViewController.recipe = recipe; [self.navigationController pushViewController:detailViewController animated:animated]; [detailViewController release]; } ...

नुस्खा प्रदर्शित करें

 - (void)viewWillAppear:(BOOL)animated { [super viewWillAppear:animated]; [photoButton setImage:recipe.thumbnailImage forState:UIControlStateNormal]; self.navigationItem.title = recipe.name; nameTextField.text = recipe.name; overviewTextField.text = recipe.overview; prepTimeTextField.text = recipe.prepTime; [self updatePhotoButton]; //  NSSortDescriptor *sortDescriptor = [[NSSortDescriptor alloc] initWithKey:@"displayOrder" ascending:YES]; NSArray *sortDescriptors = [[NSArray alloc] initWithObjects:&sortDescriptor count:1]; NSMutableArray *sortedIngredients = [[NSMutableArray alloc] initWithArray:[recipe.ingredients allObjects]]; [sortedIngredients sortUsingDescriptors:sortDescriptors]; self.ingredients = sortedIngredients; [sortDescriptor release]; [sortDescriptors release]; [sortedIngredients release]; [self.tableView reloadData]; }

TableView cellForRowAtIndexPath में नुस्खा प्रदर्शित करने के लिए एक सेल बनाएं

 static NSString *IngredientsCellIdentifier = @"IngredientsCell"; cell = [tableView dequeueReusableCellWithIdentifier:IngredientsCellIdentifier]; if (cell == nil) { cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:IngredientsCellIdentifier] autorelease]; cell.accessoryType = UITableViewCellAccessoryNone; }

यह सब, यह कोड सामग्री की एक सूची प्रदर्शित करने के लिए पर्याप्त है। इसका अर्थ यह है कि मुख्य विंडो से, हम उस रेसिपी ऑब्जेक्ट को पास करते हैं, जिस विंडो में सामग्री की सूची प्रदर्शित होती है। उसी समय, डेटाबेस से सामग्री की एक सूची प्राप्त करने के लिए, आपको एक नया NSEntityDescription बनाने की आवश्यकता नहीं है, बस नुस्खा पर जाएँ। संपत्ति के गुण और कोर डेटा डेटाबेस से आवश्यक सामग्री को स्वचालित रूप से वापस कर देगा।

निष्कर्ष

बेशक, यह लेख इस परियोजना का पूर्ण विवरण नहीं है। यदि आप, प्रिय पाठकों, रुचि रखते हैं, तो मैं लेखों की एक श्रृंखला जारी रखने के लिए तैयार हूं और उदाहरण के लिए, अगले एक में, यह वर्णन करने के लिए कि इस परियोजना में डेटाबेस में वस्तुओं को कैसे जोड़ा जाता है, हटा दिया जाता है और बदल दिया जाता है। आपका ध्यान और आपके धैर्य के लिए धन्यवाद।

पार्सिंग iPhone कोर डेटा व्यंजनों। भाग 1