[Cocoa]在工程中使用Three20库：下拉刷新 tableview
[Cocoa]在工程中使用Three20库：下拉刷新 tableview
本文遵循“署名-非商业用途-保持一致”创作公用协议
Three20 是 facebook 开源的一款功能齐全又强大的库，覆盖 UI，network，JSON/XML解析等。其 github 仓库在这里：https://github.com/facebook/three20 ，这个页面也有如何在工程中添加 three20 库的介绍，不过在 Lion 版下以及 xcode 4.2 下有些许不同，英文好的同学可以参看原文。现整理如下：
1，新建一个名为 Three20Demo 的 Empty Application；
2，在这页面上下载 three20 zip源代码工程；解压到与 Three20Demo 项目平级的目录下；
3，拖拽 "three20/src/Three20/"
目录下的 Three20.xcodeproj 到 Three20Demo 工程中，如下图。
4，选中 Three20Demo 的 target ，在 Build Phases 的 Link Binary With Libraries 中添加 three20 的静态库。如下图：
5，拖拽 "three20/src" 下面的Three20.bundle 到 Three20Demo 工程下，在弹出的对话框中不要选择 Copy Item into 那个选项，选择第二个 Create groups for any added folders。
6，类似第4步，向 three20Demo 中添加 QuartzCore.framework 。
7，在工程的 Build settings 中向 "Other Linker Flags" 添加 -ObjC 和 -all_load 两项。
8，编译运行工程，然后至你自己用户的 Library 目录下拷贝 three20 头文件至你的项目目录下。（Lion版本无法查看隐藏目录，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 选项。
10, 至此，所有的配置工作完成，你可以在工程中使用包含如下头文件：#import <Three20/Three20.h> 来使用 Three20 库。
Three20 解压的包里面有个 sample 目录，里面展示了大部分 api 的使用，可以运行看看。
下面我将演示如何使用 TTTableViewController。向工程中添加类 KSDataSource 这个类作为 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
现在编译运行，你应该可以看到一个 loading 界面，2秒（代码中有设定）之后进入 tableview 界面，在 tableview 中进行下拉操作，可以看到刷新功能以及在里面了！这个效果和我们使用下拉刷新库 EGOTableViewPullRefresh 的效果是一样的。
