UITableView

UITableView就像Android中的ListView。

iOS程式結構，也是典型的MVC模式：

type	desc
Model	資料，資料模型
View	檢視
Controller	控制檢視和資料，負責資料流向，頁面如何跳轉，處理程式邏輯

UITableView是一個檢視，所以他還需要資料來源和控制器，同時還需要一個代理物件來響應UITableView的各種事件。

UITableViewController類可以滿足這三個角色：view controller, data source, delegate.

UITableViewController是UIViewController的一個子類，所以他也有一個view屬性，這個屬性總是指向UITableView例項。

定義自己的UITableViewController

我們來寫自己的table view controller，繼承UITableViewController類。

#import <UIKit/UIKit.h>

@interface BKItemsViewController : UITableViewController

@end

UITableViewController的指定初始化方法是 initWithStyle:，該方法接受一個常量來指定table view style，其值可以是：UITableViewStylePlain 和 UITableViewStyleGrouped

我們可以設定自己的指定初始化方法：

• 指定初始化方法需要呼叫父類的指定初始化方法
• 重寫父類的指定初始化方法，方法中呼叫我們的指定初始化方法

#import "BKItemsViewController.h"

@implementation BKItemsViewController

// 在自己的指定初始化方法中呼叫父類的指定初始化方法
- (instancetype)init{
    self = [super initWithStyle:UITableViewStylePlain];
    return self;
}

// 重寫父類的指定初始化方法：呼叫自己的指定初始化方法
- (instancetype)initWithStyle:(UITableViewStyle)style{
    return [self init];
}

@end

Data Source

建立一個單例類來為table view提供資料來源

#import <Foundation/Foundation.h>

@class BKItem;

@interface BKItemStore : NSObject

@property (nonatomic, readonly) NSArray *allItems;

// 靜態方法，此方法用來建立單例類物件
+ (instancetype)sharedStore;

- (BKItem *)createItem;

@end

• 在標頭檔案中，宣告sharedStore靜態方法，用來建立單例類的實體
• 靜態方法以+號開始
• @class編譯器指令，告訴編譯器你不需要知道這個類的具體資訊，從而加快編譯速度；當真正要建立這個類的例項或是要呼叫其方法時，就必須匯入其標頭檔案了

#import "BKItemStore.h"
#import "BKItem.h"

@interface BKItemStore ()

@property (nonatomic) NSMutableArray *privateItems;

@end

@implementation BKItemStore

// 類方法，獲得單例類的例項
+ (instancetype)sharedStore{
    // 靜態變數：當方法執行完後，不會被銷燬
    static BKItemStore *sharedStore = nil;
    
    if(!sharedStore){
        sharedStore = [[self alloc] initPrivate];
    }
    return sharedStore;
}

- (instancetype)init{
    @throw [NSException exceptionWithName:@"Singleton" reason:@"Use +[BKItemStore sharedStore]" userInfo:nil];
    return nil;
}

// 指定初始化方法
- (instancetype)initPrivate{
    self = [super init];
    if(self){
        _privateItems = [[NSMutableArray alloc] init];
    }
    return self;
}

- (BKItem *)createItem{
    BKItem *item = [BKItem randomItem];
    [self.privateItems addObject:item];
    return item;
}

// The compiler only auto-synthesizes an instance variable if you let it synthesize at least one accessor.
// 由於allItems是readonly，而此處我們又重寫了其get方法，所以編譯器不會幫我們建立例項變數
- (NSArray *)allItems{
    return self.privateItems;
}

@end

• 在class extension中宣告類的私有例項變數
• 在方法中宣告的static variable，當方法執行結束後，不會被銷燬
• 在單例類的init方法，直接丟擲異常，如果有人呼叫此方法，告知他呼叫sharedStore方法
• 物件內部維護一個mutable data structure，但是其他物件只能訪問他的immutable version
• 我們知道編譯器會自動為我們宣告的@property，建立instance variable以及set get方法，但是如果我們重寫了set get方法，那麼編譯器就不會幫我們生成instance variable了

實現UITableViewDataSource protocol的方法

tableView:numberOfRowsInSection:返回table view需要顯示多少行。
tableView:cellForRowAtIndexPath:建立table view cell，並設定cell的content。

#import "BKItemsViewController.h"
#import "BKItem.h"
#import "BKItemStore.h"

@implementation BKItemsViewController

// 在自己的指定初始化方法中呼叫父類的指定初始化方法
- (instancetype)init{
    self = [super initWithStyle:UITableViewStylePlain];
    
    if(self){
        for (int i=0; i<5; i++) {
            [[BKItemStore sharedStore] createItem];
        }
    }
       
    return self;
}

// 重寫父類的指定初始化方法：呼叫自己的指定初始化方法
- (instancetype)initWithStyle:(UITableViewStyle)style{
    return [self init];
}

- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section{
    // 返回table view需要顯示多少行
    return [[[BKItemStore sharedStore] allItems] count];
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{
    // 建立table view cell
    UITableViewCell *cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"UITableViewCell"];
    // 找到對應行的item
    NSArray *items = [[BKItemStore sharedStore] allItems];
    // NSIndexPath有兩個屬性：section,row
    BKItem *item = items[indexPath.row];
    cell.textLabel.text = [item description];
    return cell;
}

@end

UITableViewCell

如下圖，table view cell有一個subview -- contentView

contentView有三個subview：兩個UILabel(textLabel, detailTextLabel)，一個UIImageView（imageView）

UITableViewCellStyle控制contentView的三個subview如何顯示

Reusing UITableViewCells

為了避免建立大量table view cell，iOS用table view cell pool來回收並重用cell，避免佔用大量記憶體，當cell不在螢幕上顯示了，會被放到cell pool中，當滑動table view，table view datasource會檢查cell pool是否有未使用cell，如果有就為其設定新的資料返回給table view。

有時候一個table view會有不同型別的cell，所以產生不同類弄的cell在同一個cell pool中，此時，如果你需要某種特定型別的cell，可以指定reuseIdentifier，每個cell都有一個reuseIdentifier屬性，按照約定reuseIdentifier是cell的類名。

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath{
    // 建立table view cell
    //UITableViewCell *cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:@"UITableViewCell"];
    
    // Get a new or recycled cell
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:@"UITableViewCell" forIndexPath:indexPath];
    
    // 找到對應行的item
    NSArray *items = [[BKItemStore sharedStore] allItems];
    BKItem *item = items[indexPath.row];
    cell.textLabel.text = [item description];
    return cell;
}

要告訴table view對應的reuseIdentifier是哪個cell類:

- (void)viewDidLoad{
    [super viewDidLoad];
    [self.tableView registerClass:[UITableViewCell class] forCellReuseIdentifier:@"UITableViewCell"];
}

---

本文是對《iOS Programming The Big Nerd Ranch Guide 4th Edition》第八章的總結。