[Cocoa]在工程中使用Three20庫(kù)：下拉刷新 tableview

Three20 是 facebook 開(kāi)源的一款功能齊全又強(qiáng)大的庫(kù)，覆蓋 UI，network，JSON/XML解析等。其 github 倉(cāng)庫(kù)在這里：https://github.com/facebook/three20 ，這個(gè)頁(yè)面也有如何在工程中添加 three20 庫(kù)的介紹，不過(guò)在 Lion 版下以及 xcode 4.2 下有些許不同，英文好的同學(xué)可以參看原文?，F(xiàn)整理如下：

羅朝輝 (http://www.rzrgm.cn/kesalin/)

本文遵循“署名-非商業(yè)用途-保持一致”創(chuàng)作公用協(xié)議

Three20 是 facebook 開(kāi)源的一款功能齊全又強(qiáng)大的庫(kù)，覆蓋 UI，network，JSON/XML解析等。其 github 倉(cāng)庫(kù)在這里：https://github.com/facebook/three20 ，這個(gè)頁(yè)面也有如何在工程中添加 three20 庫(kù)的介紹，不過(guò)在 Lion 版下以及 xcode 4.2 下有些許不同，英文好的同學(xué)可以參看原文?，F(xiàn)整理如下：

1，新建一個(gè)名為 Three20Demo 的 Empty Application；

2，在這頁(yè)面上下載 three20 zip源代碼工程；解壓到與 Three20Demo 項(xiàng)目平級(jí)的目錄下；

3，拖拽 "three20/src/Three20/" 目錄下的 Three20.xcodeproj 到 Three20Demo 工程中，如下圖。

4，選中 Three20Demo 的 target ，在 Build Phases 的 Link Binary With Libraries 中添加 three20 的靜態(tài)庫(kù)。如下圖：

5，拖拽 "three20/src" 下面的Three20.bundle 到 Three20Demo 工程下，在彈出的對(duì)話框中不要選擇 Copy Item into 那個(gè)選項(xiàng)，選擇第二個(gè) Create groups for any added folders。

6，類似第4步，向 three20Demo 中添加 QuartzCore.framework 。

7，在工程的 Build settings 中向 "Other Linker Flags" 添加 -ObjC 和 -all_load 兩項(xiàng)。

8，編譯運(yùn)行工程，然后至你自己用戶的 Library 目錄下拷貝 three20 頭文件至你的項(xiàng)目目錄下。（Lion版本無(wú)法查看隱藏目錄，command + shift + G ，然后輸入 ~/Library，就可以找到隱藏的library）。 three20 目錄位于：

/Users/yourname/Library/Developer/Xcode/DerivedData/Three320Demo-XXXXXX/Build/Products/three20

9，在工程的 Build settings 中向 "Header Search Paths" 添加 three20，并選中 Recursive 選項(xiàng)。

10, 至此，所有的配置工作完成，你可以在工程中使用包含如下頭文件：#import <Three20/Three20.h> 來(lái)使用 Three20 庫(kù)。

Three20 解壓的包里面有個(gè) sample 目錄，里面展示了大部分 api 的使用，可以運(yùn)行看看。

下面我將演示如何使用 TTTableViewController。向工程中添加類 KSDataSource 這個(gè)類作為 TTTableView 的 datasource。

KSDataSource.h

//
//  DataSource.h
//  Three320Demo
//
//  Created by LuoZhaohui on 12/31/11.
//  Copyright (c) 2011 kesalin@gmail.com. All rights reserved.
//

#import <Three20/Three20.h>

// Model
//
@interface KSMockModel : NSObject <TTModel> 
{
@private
    NSArray * allNames;
    NSMutableArray * names;
    NSMutableArray * delegates;
    
    NSTimer* fakeSearchTimer;
    NSTimeInterval fakeSearchDuration;
    NSTimer* fakeLoadingTimer;
    NSTimeInterval fakeLoadingDuration;
}

@property(nonatomic,retain) NSArray * names;
@property(nonatomic) NSTimeInterval fakeSearchDuration;
@property(nonatomic) NSTimeInterval fakeLoadingDuration;

+ (NSMutableArray *) fakeNames;

- (id)initWithNames:(NSArray *)names;
- (void)search:(NSString *)text;

@end

// DataSource
//
@interface KSDataSource : TTSectionedDataSource
{
    KSMockModel * mockModel;
}

@property(nonatomic,readonly) KSMockModel * mockModel;

@end

KSDateSource.m

//
//  DataSource.m
//  Three320Demo
//
//  Created by LuoZhaohui on 12/31/11.
//  Copyright (c) 2011 kesalin@gmail.com. All rights reserved.
//

#import "KSDataSource.h"

@interface KSMockModel ()

- (void) loadNames;

@end

@implementation KSMockModel

@synthesize names;
@synthesize fakeSearchDuration, fakeLoadingDuration;

+ (NSMutableArray *) fakeNames
{
    return [NSMutableArray arrayWithObjects:
            @"Hector Lewis",
            @"Juanita Fredrick",
            @"Richard Raymond",
            @"Marcia Myer",
            @"Shannon Mahoney",
            @"James Steiner",
            @"Daniel Lloyd",
            @"Fredrick Hutchins",
            @"Tracey Smith",
            @"Brandon Rutherford",
            @"Megan Lopez",
            @"Jean Trujillo",
            @"Franklin Diamond",
            @"Mildred Jacobsen",
            @"Sandra Adams",
            @"Debra Pugliese",
            @"Cynthia Hall",
            @"Joshua Hicks",
            @"Lorenzo Evatt",
            @"Erica Dozier",
            @"Barbara Lazarus",
            @"Joye Hocker",
            @"Henry Arana",
            @"Glen Cabrales",
            nil];
}

- (id) initWithNames:(NSArray *)nameArray
{
    self = [super init];
    if (self)
    {
        delegates = nil;
        allNames = [nameArray copy];
        names = nil;
        fakeSearchTimer = nil;
        fakeSearchDuration = 0;
    }

    return self;
}

- (void) dealloc
{
    TT_INVALIDATE_TIMER(fakeSearchTimer);
    TT_INVALIDATE_TIMER(fakeLoadingTimer)
    TT_RELEASE_SAFELY(allNames);
    TT_RELEASE_SAFELY(names);
    TT_RELEASE_SAFELY(delegates);
    
    [super dealloc];
}

// TTModel
//
- (NSMutableArray*) delegates
{
    if (!delegates)
    {
        delegates = TTCreateNonRetainingArray();
    }
    
    return delegates;
}

- (BOOL)isLoadingMore
{
    return NO;
}

- (BOOL)isOutdated
{
    return NO;
}

- (BOOL)isLoaded
{
    return !!names;
}

- (BOOL)isLoading
{
    return !!fakeSearchTimer || !!fakeLoadingTimer;
}

- (BOOL)isEmpty
{
    return !names.count;
}

- (void)fakeLoadingReady
{
    fakeLoadingTimer = nil;
    
    [self loadNames];
    
    [delegates perform:@selector(modelDidFinishLoad:) withObject:self];
}

- (void)load:(TTURLRequestCachePolicy)cachePolicy more:(BOOL)more
{
    [delegates perform:@selector(modelDidStartLoad:) withObject:self];
    
    if (fakeLoadingDuration)
    {
        TT_INVALIDATE_TIMER(fakeLoadingTimer);
        fakeLoadingTimer = [NSTimer scheduledTimerWithTimeInterval:fakeLoadingDuration
                                                            target:self
                                                           selector:@selector(fakeLoadingReady)
                                                          userInfo:nil
                                                           repeats:NO];
        [delegates perform:@selector(modelDidStartLoad:) withObject:self];
    } 
    else
    {
        [self loadNames];

        [delegates perform:@selector(modelDidFinishLoad:) withObject:self];
    }
}

- (void)invalidate:(BOOL)erase 
{
}

- (void)cancel
{
    if (fakeSearchTimer)
    {
        TT_INVALIDATE_TIMER(fakeSearchTimer);
        [delegates perform:@selector(modelDidCancelLoad:) withObject:self];
    }
    else if (fakeLoadingTimer)
    {
        TT_INVALIDATE_TIMER(fakeLoadingTimer);
        [delegates perform:@selector(modelDidCancelLoad:) withObject:self];    
    }
}

// public
//
- (void)loadNames
{
    TT_RELEASE_SAFELY(names);
    names = [allNames mutableCopy];
}

- (void)search:(NSString *)text
{
    [self cancel];
    
    TT_RELEASE_SAFELY(names);
    if (text.length)
    {
        if (fakeSearchDuration)
        {
            TT_INVALIDATE_TIMER(fakeSearchTimer);
            fakeSearchTimer = [NSTimer scheduledTimerWithTimeInterval:fakeSearchDuration
                                                               target:self
                                                              selector:@selector(fakeSearchReady:)
                                                             userInfo:text
                                                              repeats:NO];
            [delegates perform:@selector(modelDidStartLoad:) withObject:self];
        }
        else
        {
            [self fakeSearch:text];
            [delegates perform:@selector(modelDidFinishLoad:) withObject:self];
        }
    }
    else
    {
        [delegates perform:@selector(modelDidChange:) withObject:self];
    }
}

@end

//
// DataSource
//
@implementation KSDataSource

@synthesize mockModel;

- (id) init
{
    self = [super init];
    if (self)
    {
        mockModel = [[KSMockModel alloc] initWithNames:[KSMockModel fakeNames]];
        self.model = mockModel;
    }
    return self;
}

- (void)dealloc
{
    TT_RELEASE_SAFELY(mockModel);

    [super dealloc];
}

// UITableViewDataSource
//
- (NSArray *)sectionIndexTitlesForTableView:(UITableView *)tableView
{
    return [TTTableViewDataSource lettersForSectionsWithSearch:YES summary:NO];
}

- (void) tableViewDidLoadModel:(UITableView *)tableView
{
    self.items = [NSMutableArray array];
    self.sections = [NSMutableArray array];
    
    NSMutableDictionary * groups = [NSMutableDictionary dictionary];
    for (NSString * name in mockModel.names)
    {
        NSString * letter = [NSString stringWithFormat:@"%C", [name characterAtIndex:0]];
        NSMutableArray * section = [groups objectForKey:letter];
        if (!section)
        {
            section = [NSMutableArray array];
            [groups setObject:section forKey:letter];
        }
        
        TTTableItem * item = [TTTableTextItem itemWithText:name URL:nil];
        [section addObject:item];
    }
    
    NSArray * letters = [groups.allKeys sortedArrayUsingSelector:@selector(caseInsensitiveCompare:)];
    for (NSString * letter in letters)
    {
        NSArray * items = [groups objectForKey:letter];
        [_sections addObject:letter];
        [_items addObject:items];
    }
}

- (id<TTModel>) model
{
    return mockModel;
}

@end

然后修改 KSViewController.h 為：

#import <Three20/Three20.h>

@interface KSViewController : TTTableViewController <TTTableViewDataSource, TTTableViewDelegate>

@end

修改 KSViewController.m 為：

//
//  KSViewController.m
//  Three320Demo
//
//  Created by LuoZhaohui on 12/31/11.
//  Copyright (c) 2011 kesalin@gmail.com. All rights reserved.
//

#import "KSViewController.h"
#import "KSDataSource.h"

@implementation KSViewController

// TTTableView
//
- (void) createModel
{
    KSDataSource *dataSource = [[KSDataSource alloc] init];
    dataSource.mockModel.fakeLoadingDuration = 2.0;
    dataSource.mockModel.fakeSearchDuration  = 2.0;
   
    self.dataSource = dataSource;
    [dataSource release];
}

- (id<TTTableViewDelegate>) createDelegate
{
    TTTableViewDragRefreshDelegate *delegate = [[TTTableViewDragRefreshDelegate alloc] initWithController:self];
    
    return [delegate autorelease];
}

// TTTableViewDelegate
//
- (void)tableView:(UITableView *)tableView touchesBegan:(NSSet *)touches withEvent:(UIEvent*)event
{
    
}

- (void)tableView:(UITableView *)tableView touchesEnded:(NSSet *)touches withEvent:(UIEvent*)event
{
    
}

@end

現(xiàn)在編譯運(yùn)行，你應(yīng)該可以看到一個(gè) loading 界面，2秒（代碼中有設(shè)定）之后進(jìn)入 tableview 界面，在 tableview 中進(jìn)行下拉操作，可以看到刷新功能以及在里面了！這個(gè)效果和我們使用下拉刷新庫(kù) EGOTableViewPullRefresh 的效果是一樣的。

posted @ 2011-12-31 17:26 飄飄白云閱讀(957) 評(píng)論(2) 收藏舉報(bào)

刷新頁(yè)面返回頂部

本博客遵循

“署名-非商業(yè)用途-保持一致”創(chuàng)作共用協(xié)議。與我聯(lián)系

[Cocoa]在工程中使用Three20庫(kù)：下拉刷新 tableview

公告