Three20中的TTThumbViewController类的学习

本文链接：https://blog.csdn.net/linvan/article/details/7614503
做相册小程序的时候需要用到Three20库。网上的教程真心少，果然还是要看源代码……
因为本人英语水平极差，变量或者方法设置成自解释的名称也几乎看不懂，所以还是多加点注释好了。留给自己看，如果也能顺便帮到其他人就更好了。
这个文件在Thee20/src/Three20UI/Sources 文件夹下。
我是看一点往上补一点的……如果这文章真的有人看的话，不要心急哈~
涉及到的一些相关文件有：
TTImageViewController
TTPhotoView
TTThumbsTableCell
还有若干

#import "Three20UI/TTThumbsViewController.h"

// UI
#import "Three20UI/TTNavigator.h"
#import "Three20UI/TTThumbsDataSource.h"
#import "Three20UI/TTThumbsTableViewCell.h"
#import "Three20UI/TTPhoto.h"
#import "Three20UI/TTPhotoSource.h"
#import "Three20UI/TTPhotoViewController.h"
#import "Three20UI/UIViewAdditions.h"

// UINavigator
#import "Three20UINavigator/TTGlobalNavigatorMetrics.h"

// UICommon
#import "Three20UICommon/TTGlobalUICommon.h"
#import "Three20UICommon/UIViewControllerAdditions.h"

// Style
#import "Three20Style/TTGlobalStyle.h"
#import "Three20Style/TTStyleSheet.h"

// Core
#import "Three20Core/TTGlobalCoreLocale.h"
#import "Three20Core/TTGlobalCoreRects.h"
#import "Three20Core/TTCorePreprocessorMacros.h"

// 相片缩略图的格子高度。过小会导致图片显示不全，过大会使图片间留很多空白。
static CGFloat kThumbnailRowHeight = 79;


///
///
///
@implementation TTThumbsViewController

@synthesize delegate    = _delegate;
@synthesize photoSource = _photoSource;


///
- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil {
	self = [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil];
	if (self) {
		self.statusBarStyle = UIStatusBarStyleBlackTranslucent;	// 将statusBar设为黑色透明。
		self.navigationBarStyle = UIBarStyleBlackTranslucent;	// 将导航栏设置为黑色透明
		self.navigationBarTintColor = nil;	// 将导航栏背景色设为nil
		self.wantsFullScreenLayout = YES;	// 全屏布局。略不懂，待研究。
		self.hidesBottomBarWhenPushed = YES;	// 隐藏TabBar。没用过，不了解。
	}
//	1. 如果仅仅使用TTThumbsViewController的话，那么用完了要手动将状态栏导航栏等等的颜色变为原配置。
//	2. 为了让图片缩略图滚动的时候有那种“还没到头”的感觉，所以要把XX栏都设置成透明的。
	return self;
}


///
// 起始我还不大明白delegate是什么意思⋯⋯待研究。
- (id)initWithDelegate:(id<TTThumbsViewControllerDelegate>)delegate {
	self = [self initWithNibName:nil bundle:nil];
	if (self) {
		self.delegate = delegate;
	}
	
	return self;
}


///
// 这个也不大懂。
- (id)initWithQuery:(NSDictionary*)query {
	id<TTThumbsViewControllerDelegate> delegate = [query objectForKey:@"delegate"];
	if (nil != delegate) {
		self = [self initWithDelegate:delegate];
		
	} else {
		self = [self initWithNibName:nil bundle:nil];
	}
	
	return self;
}


///
- (id)init {
	self = [self initWithNibName:nil bundle:nil];
	if (self) {
	}
	
	return self;
}


///
- (void)dealloc {
	[_photoSource.delegates removeObject:self];
	TT_RELEASE_SAFELY(_photoSource);
	
	[super dealloc];
}


///
///
#pragma mark -
#pragma mark Private


///
// 暂停加载缩略图
// 在viewDidDisapper里面用到。
// 大概涉及到TTThumbsDataSource类和TTThumbsTableViewCell类
// 如果photoSource里面有照片，那么就申请新格子
- (void)suspendLoadingThumbnails:(BOOL)suspended {
	if (_photoSource.maxPhotoIndex >= 0) {
		NSArray* cells = _tableView.visibleCells;
		for (int i = 0; i < cells.count; ++i) {
			TTThumbsTableViewCell* cell = [cells objectAtIndex:i];
			if ([cell isKindOfClass:[TTThumbsTableViewCell class]]) {
				[cell suspendLoading:suspended];
			}
		}
	}
}


///
// 在自身的loadView里面会调用到。
- (void)updateTableLayout {
	self.tableView.contentInset = UIEdgeInsetsMake(TTBarsHeight()+4, 0, 0, 0);
	self.tableView.scrollIndicatorInsets = UIEdgeInsetsMake(TTBarsHeight(), 0, 0, 0);
}


///
// 不知道在哪用到了这个，所以也不知道干嘛用
- (NSString*)URLForPhoto:(id<TTPhoto>)photo {
	if ([photo respondsToSelector:@selector(URLValueWithName:)]) {
		return [photo URLValueWithName:@"TTPhotoViewController"];
		
	} else {
		return nil;
	}
}


///
///
#pragma mark -
#pragma mark UIViewController


///
- (void)loadView {//最上面的RowHeigt就是在这里用的。对tableView进行一些初始化操作。
	[super loadView];
	self.tableView.rowHeight = kThumbnailRowHeight;//设置行高
	// 设置自动调整大小。方法是在UIView里面。
	self.tableView.autoresizingMask =
	UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
	// TTSTULEVAR看起来像是一个全局的设定。易于统一风格吧。
	self.tableView.backgroundColor = TTSTYLEVAR(backgroundColor);
	// 貌似是cell的分割风格。没发现none和singleLine的区别
	self.tableView.separatorStyle = UITableViewCellSeparatorStyleNone;
	[self updateTableLayout];
}


///
- (void)viewDidAppear:(BOOL)animated {
	[super viewDidAppear:animated];
	[self suspendLoadingThumbnails:NO];
}


///
- (void)viewDidDisappear:(BOOL)animated {
	[self suspendLoadingThumbnails:YES];
	[super viewDidDisappear:animated];
}


///
- (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation {
	return TTIsSupportedOrientation(interfaceOrientation);
}


///
- (void)didRotateFromInterfaceOrientation:(UIInterfaceOrientation)fromInterfaceOrientation {
	[self updateTableLayout];
	[self.tableView reloadData];
}


///
//
#pragma mark -
#pragma mark UIViewController (TTCategory)


///
- (BOOL)persistView:(NSMutableDictionary*)state {
	NSString* delegate = [[TTNavigator navigator] pathForObject:_delegate];
	if (delegate) {
		[state setObject:delegate forKey:@"delegate"];
	}
	return [super persistView:state];
}


///
- (void)restoreView:(NSDictionary*)state {
	[super restoreView:state];
	NSString* delegate = [state objectForKey:@"delegate"];
	if (delegate) {
		self.delegate = [[TTNavigator navigator] objectForPath:delegate];
	}
}


///
// 这里似乎是设置导航栏上的两个按钮
// 但我还是不明白为什么右边的按钮可以在被Photo调用的时候出现，而左边的只有直接打开Thumbs的时候才有。
- (void)setDelegate:(id<TTThumbsViewControllerDelegate>)delegate {
	_delegate = delegate;
	
	if (_delegate) {
		self.navigationItem.leftBarButtonItem =
		[[[UIBarButtonItem alloc] initWithCustomView:[[[UIView alloc] init]
													  autorelease]]autorelease];
		self.navigationItem.rightBarButtonItem =
		[[[UIBarButtonItem alloc] initWithTitle:TTLocalizedString(@"Done", @"")
										  style:UIBarButtonItemStyleBordered
										 target:self
										 action:@selector(removeFromSupercontroller)] autorelease];
	}
}


///
///
#pragma mark -
#pragma mark TTModelViewController


///
- (void)didRefreshModel {
	[super didRefreshModel];
	self.title = _photoSource.title;
}


///
///
#pragma mark -
#pragma mark TTTableViewController


///
// 不懂
- (CGRect)rectForOverlayView {
	return TTRectContract(CGRectOffset([super rectForOverlayView], 0, TTBarsHeight()-_tableView.top),
						  0, TTBarsHeight());
}


///
///
#pragma mark -
#pragma mark TTThumbsTableViewCellDelegate


///
//没看完。大概是这样：如果URL里有图片就显示，没有的话，就显示一张photo。目测是“找不到图片”的那张
- (void)thumbsTableViewCell:(TTThumbsTableViewCell*)cell didSelectPhoto:(id<TTPhoto>)photo {
	[_delegate thumbsViewController:self didSelectPhoto:photo];
	
	BOOL shouldNavigate = YES;
	if ([_delegate respondsToSelector:@selector(thumbsViewController:shouldNavigateToPhoto:)]) {
		shouldNavigate = [_delegate thumbsViewController:self shouldNavigateToPhoto:photo];
	}
	
	if (shouldNavigate) {
		NSString* URL = [self URLForPhoto:photo];
		if (URL) {
			TTOpenURLFromView(URL, self.view);
			
		} else {
			TTPhotoViewController* controller = [self createPhotoViewController];
			controller.centerPhoto = photo;
			[self.navigationController pushViewController:controller animated:YES];
		}
	}
}


///
///
#pragma mark -
#pragma mark Public


///
// 设置图像源。
- (void)setPhotoSource:(id<TTPhotoSource>)photoSource {
	if (photoSource != _photoSource) {
		[_photoSource release];
		_photoSource = [photoSource retain];
		
		self.title = _photoSource.title;
		self.dataSource = [self createDataSource];
	}
}


///
- (TTPhotoViewController*)createPhotoViewController {
	return [[[TTPhotoViewController alloc] init] autorelease];
}


///
- (id<TTTableViewDataSource>)createDataSource {
	return [[[TTThumbsDataSource alloc] initWithPhotoSource:_photoSource delegate:self] autorelease];
}


@end