तीन20 विध्वंसकारी: TTModel

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

पुस्तकालय का मुख्य नुकसान यह है कि इसमें सामान्य प्रलेखन का अभाव है, और जो इस पुस्तकालय के अंदर हो रहा है, उसकी सामान्य समझ के लिए अपर्याप्त है।

यह लाइब्रेरी का एकमात्र माइनस नहीं है, और इंटरनेट पर आप तीन20 के पेशेवरों और विपक्षों के बारे में कई चर्चा पा सकते हैं।

यह कहा जाना चाहिए कि मुख्य डेवलपर ने तीन20 के विकास को रोक दिया , और एक नया निंबस लाइब्रेरी बनाने का फैसला किया, जिसका मुख्य विचार सादगी और उच्च प्रलेखन होगा:
"निंबस एक आईओएस फ्रेमवर्क है जिसका फीचर सेट उसके प्रलेखन के अनुसार ही बढ़ता है।"

फिर भी, यह परियोजना आज तक मौजूद है, और इस परियोजना के कुछ हिस्से ध्यान देने योग्य हैं, और डिजाइन के दृष्टिकोण से काफी दिलचस्प हैं।

इस पोस्ट में TTModel के संचालन से संबंधित विस्तार से चर्चा की जाएगी ।

उन लोगों के लिए जो अपनी परियोजनाओं में तीन20 का उपयोग नहीं करने जा रहे हैं, यह एमवीसी टेम्पलेट में मॉडल के संभावित उल्लेखनीय कार्यान्वयन में से एक पर नज़र रखना उपयोगी होगा।

मैं उन सभी से पूछता हूं जो अभी भी रुचि रखते हैं ।

TTModel

जो लोग अभी भी एमवीसी (मॉडल-व्यू-कंट्रोलर) डिजाइन पैटर्न से परिचित नहीं हैं, या यह भूल गए हैं कि यह सब क्या है, इसे विकी पर देख सकते हैं। ( "दोहराव सीखने की माँ है," आखिर)

आर्किटेक्चर

तो, तीन20 लाइब्रेरी में TTModel MVC का एक क्लासिक मॉडल है। यही है, यह सिर्फ एक अमूर्त डेटा सेट है जो दृश्य या नियंत्रक पर निर्भर नहीं करता है।

TTModel आर्किटेक्चर शुरू में यह दर्शाता है कि मॉडल विभिन्न राज्यों में हो सकता है:

• - (BOOL) isLoaded - मुख्य ध्वज, जो इंगित करता है कि मॉडल लोड किया गया है, और इसमें प्रासंगिक डेटा है
• - (BOOL) isLading है
• - (BOOL) isLadingMore - मुख्य डेटा लोड होने पर मॉडल की स्थिति, लेकिन अतिरिक्त डेटा के लिए एक अनुरोध किया गया था
• - (BOOL) अलग है - यह दर्शाता है कि मॉडल में डेटा पुराना है और वर्तमान स्थिति में मॉडल को पुनर्स्थापित करने के लिए डेटा फिर से लोड किया जाना चाहिए।

इसके अलावा, TTModel इसके साथ काम करने के लिए कई बुनियादी तरीके प्रदान करता है।

• - (शून्य) लोड: (TTURLRequestCachePolicy) cachePolicy अधिक: (BOOL) अधिक - एक विधि जो मॉडल में प्रासंगिक डेटा को लोड करने का कारण बनती है
• - (शून्य) रद्द - मॉडल में डेटा लोड करने को रद्द करता है
• - (शून्य) अमान्य: (BOOL) मिटा - एक विधि जो "अप्रासंगिकता" की स्थिति में मॉडल डालती है। मिटा पैरामीटर कैश से डेटा को हटाने की आवश्यकता को इंगित करता है

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

//      DBRequestModel * someModel = [[DBRequestModel alloc] initWithQuery:@"SELECT * FROM TABLE USERS"]; //    [someModel load:TTURLRequestCachePolicyNone more:NO]; //    while ([someModel isLoading]) { [[NSRunLoop currentRunLoop] runMode:NSDefaultRunLoopMode beforeDate:[NSDate distantFuture]]; } if ([someModel isLoaded]) { //    result DBRequestModel //   NSArray * users = [someModel result]; } else { //  ? } 

उपरोक्त कोड केवल यह समझने के लिए लिखा गया है कि मॉडल में तुरंत प्रासंगिक डेटा नहीं है

उपरोक्त कोड कुछ ब्रह्मांड में मौजूद हो सकता है, लेकिन मैं इसे हमारे में उपयोग करने की अनुशंसा नहीं करेगा।

ट्रैकिंग मॉडल राज्य परिवर्तन

हमें मॉडल की स्थिति की निगरानी करने की आवश्यकता क्यों है? यह जानने के लिए कि इसमें वास्तविक डेटा कब होगा।

मॉडल की स्थिति की निगरानी करने के लिए, आपको मॉडल के प्रतिनिधि सरणी में एक ऑब्जेक्ट (आमतौर पर नियंत्रक) जोड़ने की आवश्यकता है।

 [[someModel delegates] addObject:self]; 

बदले में, मॉडल, जब अपना राज्य बदल रहा है, तो TTModelDelegate प्रोटोकॉल का उपयोग करके अपने सभी प्रतिनिधियों को यह रिपोर्ट करेगा

TTModelDelegate प्रोटोकॉल उन विधियों का एक सेट प्रदान करता है जिनसे कई बुनियादी चीजों को अलग करने की आवश्यकता होती है:

• (शून्य) मॉडलडीडस्टार्टलड: (आईडी <TTModel>) मॉडल - सूचित करता है कि मॉडल लोड करना शुरू कर दिया है
• (शून्य) modelDidFinishLoad: (आईडी <TTModel>) मॉडल - सूचित करता है कि मॉडल सफलतापूर्वक डेटा लोड किया गया है
• (शून्य) मॉडल: (आईडी <TTModel>) मॉडल didFailLoadWithError: (NSError *) त्रुटि - मॉडल लोडिंग विफल होने पर कॉल किया गया। त्रुटि का कारण चर त्रुटि में इंगित किया गया है
• (शून्य) modelDidCancelLoad: (आईडी <TTModel>) मॉडल - रद्द किए गए विधि को कॉल करके मॉडल लोड हो रहा है या नहीं

कुल मिलाकर, मॉडल परिवर्तनों की सदस्यता लेकर, हम उन तरीकों को लागू करते हैं जिनकी हमें आवश्यकता है। उपरोक्त सभी विधियां वैकल्पिक हैं, और आपको केवल उस कार्यक्षमता पर ध्यान केंद्रित करने की अनुमति देती है जिसकी हमें आवश्यकता है।

 - (void)showModelDataIfPossible { //      self.model = [[DBRequestModel alloc] initWithQuery:@"SELECT * FROM TABLE USERS"]; //        [[[self model] delegates] addObject:self]; // ,     //        if (! [[self model] isLoaded] && [[self model] isOutdated]) { //    [someModel load:TTURLRequestCachePolicyNone more:NO]; } else { //   ,           //     [self showModelData:[self model]]; } } #pragma mark - TTModelDelegate - (void)modelDidStartLoad:(id<TTModel>)model { //   .. //       [self showLoading]; } - (void)modelDidFinishLoad:(id<TTModel>)model { //      [self hideLoading]; //    //      [self showModelData:[self model]]; } - (void)model:(id<TTModel>)model didFailLoadWithError:(NSError*)error { //      [self hideLoading]; //      User-Friendly  TTAlertNoTitle(@"Error code #10"); //   User-Friendly  [self showReloadScreen]; self.reloadLabel.title = @"Something went wrong" "But you could try to reload data"; } - (void)modelDidCancelLoad:(id<TTModel>)model { //      [self hideLoading]; //      , //       //  ,       //    } - (void)showModelData:(id<TTModel>)model { //    result DBRequestModel //   NSArray * users = [someModel result]; //    [self showUsers:users]; } 

मुझे उम्मीद है कि यह कम या ज्यादा स्पष्ट हो गया है कि TTModel क्या है और इसके साथ कैसे काम करना है। अब हम मॉडल के प्रतिनिधियों के बारे में थोड़ी बात करते हैं।

प्रतिनिधियों बनाम श्रोताओं

TTModel में प्रतिनिधि सरणी एक विशेष सरणी है जो वस्तुओं को जोड़े रखने पर उन्हें बनाए नहीं रखती है। यह TTCreateNonRetainingArray फ़ंक्शन का उपयोग करके बनाया गया है।
यह परिपत्र संदर्भों से बचने के लिए किया जाता है, और इस सम्मेलन का पालन करने के लिए कि प्रतिनिधि को सेवानिवृत्त नहीं होना चाहिए ।

वास्तव में, संपत्ति के लिए नाम सही ढंग से नहीं चुना गया है। अपनी कार्यक्षमता में प्रतिनिधि को मुख्य ऑब्जेक्ट (इस मामले में, मॉडल) को समस्या को हल करने में मदद करनी चाहिए, और वर्तमान कार्यान्वयन में, प्रतिनिधियों का सरणी वास्तव में श्रोताओं का एक सरणी है।

श्रोता और प्रतिनिधि के बीच मुख्य अंतर यह है कि श्रोता को आधार ऑब्जेक्ट में परिवर्तन के बारे में सूचित किया जाता है , और प्रतिनिधि को सबसे अधिक बार कुछ डेटा के लिए कहा जाता है जो आधार ऑब्जेक्ट के कामकाज के लिए आवश्यक है।

इसलिए, वास्तव में, TTModel में, कार्यक्षमता पर आधारित प्रतिनिधियों का एक समूह श्रोताओं का एक सरणी है।

TTURLRequestModel

नेटवर्क से डेटा लेने वाले मॉडल के साथ काम करने के लिए, थ्री 20 TTURLRequestModel क्लास का उपयोग करता है। यह TTURLRequest से बंधा है और इस तथ्य का एक स्पष्ट उदाहरण प्रदान करता है कि आप मॉडल के एक विशिष्ट कार्यान्वयन को छिपा सकते हैं।

TTURLRequestModel अनिवार्य रूप से अमूर्त, एक वर्ग है, और यह वास्तव में कुछ भी नहीं जानता है, जब तक कि यह नेटवर्क घटक से संबंधित मॉडल में कुछ अतिरिक्त फ़ील्ड नहीं जोड़ता है।

सामान्य दस्तावेज की कमी के कारण इस मॉडल में अभी भी क्या दिलचस्प है, यह तुरंत स्पष्ट नहीं है कि यह कैसे काम करता है और इसे सही तरीके से कैसे उपयोग किया जाए :)

अपना खुद का मॉडल बनाएं?

मान लीजिए कि एक मॉडल को हमें कुछ संस्थाओं की सूची प्रदान करनी चाहिए, हम उन्हें उपयोगकर्ताओं को सरलता के लिए कहेंगे।

सर्वर पेज द्वारा डेटा पेज प्रदान करता है। प्रत्येक पृष्ठ पर एन उपयोगकर्ता हैं।

रास्ते में!

इंटरफ़ेस की घोषणा करें

 @interface ItemsListModel : TTURLRequestModel { /*      */ NSMutableArray * _items; /*  URL  */ NSString * _baseURLString; /*   */ int _page; /*     */ int _itemsOnPage; } @property(nonatomic, readonly) NSMutableArray * users; @property(nonatomic, readonly) NSString * baseURLString; @property(nonatomic, assign) int page; @property(nonatomic, readonly) int itemsOnPage; /*   c  URL'      */ - (id)initWithBaseURLString:(NSString *)baseURLString itemsOnPage:(int)itemsOnPage; /* ,    TTURLRequest          */ - (TTURLRequest *)requestForDataWithCachePolicy:(TTURLRequestCachePolicy)cachePolicy more:(BOOL) more; /* ,   NSData * data          */ - (NSArray *)parseDataToItems:(NSData *)data error:(NSError **)error; @end 

और, वास्तव में, हम अपने मॉडल को लागू कर रहे हैं

 @implementation ItemsListModel @synthesize items = _items; @synthesize itemsOnPage = _itemsOnPage; @synthesize baseURLString = _baseURLString; @synthesize page = _page; /*   .   .      0 */ - (id)initWithBaseURLString:(NSString *)baseURLString itemsOnPage:(int)itemsOnPage { self = [super init]; if (self) { _baseURLString = [baseURLString copy]; _itemsOnPage = itemsOnPage; _page = 0; _items = [[NSMutableArray array] retain]; _itemsOnPage = 20; } return self; } /*    */ - (void)load:(TTURLRequestCachePolicy)cachePolicy more:(BOOL)more { //  ,    ,  //     if ( ! [self isLoading]) { //    _isLoadingMore = more; //      //        if ( ! more) { [self reset]; } //        TT_RELEASE_SAFELY(_loadingRequest); _loadingRequest = [[self requestForDataWithCachePolicy:cachePolicy more:more] retain]; //    [_loadingRequest send]; } } /* ,        */ - (TTURLRequest *)requestForDataWithCachePolicy:(TTURLRequestCachePolicy)cachePolicy more:(BOOL) more { //     //      page // hhtp://baseURL/sdfsd?page=0 // //          //        NSString * fullRequestURL = self.baseURLString; fullRequestURL = [fullRequestURL stringByAddingQueryDictionary: [NSDictionary dictionaryWithObject: [NSString stringWithFormat:@"%d", _page] forKey:@"page" ] ]; //    TTURLRequest * req = [TTURLRequest requestWithURL:fullRequestURL delegate:self]; req.cachePolicy = cachePolicy; req.response = [[TTURLDataResponse new] autorelease]; return req; } /*  ,         */ - (NSArray *)parseDataToItems:(NSData *)data error:(NSError **)error { NSString * dataString = [[[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding] autorelease]; //      SBJSON NSArray * tweets = [dataString JSONValue]; return tweets; } - (void)requestDidFinishLoad:(TTURLRequest *)request { TTURLDataResponse * response = nil; // ,        if ([[request response] isKindOfClass:[TTURLDataResponse class]]) { response = (TTURLDataResponse *)request.response; } if ( ! response) { //   -    [self request:request didFailLoadWithError:nil/*    */]; _isLoadingMore = NO; return; } NSError * error = nil; //  ,    NSArray * loadedItems = [self parseDataToItems:[response data] error:&error]; // ,       if (error) { //  ?    [self request:request didFailLoadWithError:error]; return; } //    ,  //      if ([self isLoadingMore]) { [_items addObjectsFromArray:loadedItems]; } else { TT_RELEASE_SAFELY(_items); _items = [[NSMutableArray arrayWithArray:loadedItems] retain]; } //    _page++; if ([loadedItems count] < _itemsOnPage) { /* ,          ,     */ // _hasMoreItems = NO } _isLoadingMore = NO; [super requestDidFinishLoad:request]; } /*      */ - (void)reset { _page = 0; TT_RELEASE_SAFELY(_items); [super reset]; } /*      */ - (void)dealloc { TT_RELEASE_SAFELY(_baseURLString); TT_RELEASE_SAFELY(_items); [super dealloc]; } @end 

खैर, और अंत में, वास्तविक परिस्थितियों में हमारे मॉडल का उपयोग करने का एक उदाहरण है

 @implementation MyModelViewController #pragma mark - View LifeCycle - (void)viewWillAppear:(BOOL)animated { [super viewWillAppear:animated]; [self createAndStartModelIfNeeded]; } //... #pragma mark - Model Showing - (void)showModelData:(id<TTModel>)model { //    result ItemsListModel //   NSArray * tweets = [(ItemsListModel *)model items]; //   " " NSLog(@"tweets : %{} ", tweets); //        :( //      @"tweets : %@" //    -  status Label if ([tweets count]) { NSDictionary * firstTweet = [tweets objectAtIndex:0]; NSString * tweetText = [firstTweet objectForKey:@"text"]; _statusLabel.text = [[_statusLabel text] stringByAppendingFormat:@"\n%@", tweetText]; } } #pragma mark - Model Creationg - (void)createAndStartModelIfNeeded { //   if ( ! _model) { _model = [[ItemsListModel alloc] initWithBaseURLString:@"http://api.twitter.com/1/statuses/user_timeline.json?user_id=18191307" itemsOnPage:20]; [[_model delegates] addObject:self]; } //       -    if ( ! [_model isLoaded] ) { [_model load:TTURLRequestCachePolicyNone more:NO]; } } #pragma mark - TTModel Delegate - (void)modelDidStartLoad:(id<TTModel>)model { _statusLabel.text = @""; } - (void)modelDidFinishLoad:(id<TTModel>)model { _statusLabel.text = @"!   "; [self showModelData:model]; } - (void)model:(id<TTModel>)model didFailLoadWithError:(NSError*)error { _statusLabel.text = [NSString stringWithFormat:@":(( %@", [error localizedDescription]]; } - (void)modelDidCancelLoad:(id<TTModel>)model { _statusLabel.text = @" "; } @end 

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

सारांश

तीन20 पुस्तकालय में TTModel एक बहुत अच्छा अमूर्त है जिसका उपयोग iOS के लिए प्रोग्रामिंग करते समय MVC दृष्टिकोण को व्यवस्थित करने के लिए किया जा सकता है। यहां तक ​​कि अगर आप तीन20 का उपयोग नहीं करने जा रहे हैं, तो भी, यह योग्य है, फिर भी, TTModel के कार्यान्वयन को देखने के लिए, और, यदि वांछित है, तो अपने मॉडल को प्रस्तुत के आधार पर बनाने के लिए।