本篇整理自 Apple 的 Start Developing iOS Apps Today 系列,主題是「方法」——如何宣告、如何帶參數、如何實作,以及公開與私有的界線。
方法定義了一個物件「能做什麼」。它是一段你寫在類別裡、用來完成某項工作的程式碼,可以存取類別中儲存的資料,並依據這些資料執行操作。
舉例來說,若要讓待辦事項(XYZToDoItem)具備「標記為完成」的能力,就在類別的介面中宣告一個 markAsCompleted 方法,稍後在實作檔中補上具體行為。
@interface XYZToDoItem : NSObject @property NSString *itemName; @property BOOL completed; @property (readonly) NSDate *creationDate; - (void)markAsCompleted; @end
方法名稱前面的減號表示這是實例方法,必須透過該類別的某個物件來呼叫。類別方法則以加號表示,可以直接對類別本身呼叫——最常見的例子就是 Foundation 中的各種便利建構子。類別方法也常用來存取與類別相關的共享資訊。
括號中的 void 表示這個方法沒有回傳值;而括號本身在這種情況下是空的,代表它不接收任何參數。
要傳資訊給方法,就替它宣告參數。把上面的方法改寫成接受一個布林值,就能決定該項目要被標記為完成或復原:
- (void)markAsCompleted:(BOOL)isComplete;
現在這個方法接受一個 BOOL 型別的參數 isComplete。
Objective-C 有個容易讓人愣住的特性:參數名稱是方法名稱的一部分。冒號之前是方法名,所以更新後的方法叫 markAsCompleted:。若有多個參數,方法名會被參數名稱打斷並交錯排列:
- (void)markAsCompleted:(BOOL)isComplete onDate:(NSDate *)date;
這個方法的完整名稱是 markAsCompleted:onDate:。在實作中存取 isComplete 與 date,對應的就是呼叫時傳入的兩個值。這套命名慣例讓 Objective-C 的呼叫端讀起來近乎英文句子,例如 [item markAsCompleted:YES onDate:today]。
實作用大括號包住相關程式碼。方法名稱、參數與回傳型別都必須與介面宣告完全一致。
@implementation XYZToDoItem
- (void)markAsCompleted:(BOOL)isComplete {
self.completed = isComplete;
}
@end
與屬性一樣,方法可以是公開或私有。公開方法在介面檔中宣告,其他物件看得到也呼叫得到;對應的實作在實作檔中,對外部不可見。私有方法只有實作、沒有宣告,等於只在類別內部可用——這是增加內部行為又不對外暴露的強力機制。
假設你希望待辦事項被標記為完成時,同時更新完成時間;被標記為未完成時,完成時間設為 nil。這件事是自足的,很適合寫成獨立方法。但同時你必須確保其他物件不能呼叫它,否則任何物件都能在任意時刻塞入任意的完成時間。因此這個方法應該是私有的。
更新 XYZToDoItem 的實作,讓 markAsCompleted: 內部呼叫私有的 setCompletionDate。注意介面檔完全不動,因為不希望外部看到它:
@implementation XYZToDoItem
- (void)markAsCompleted:(BOOL)isComplete {
self.completed = isComplete;
[self setCompletionDate];
}
- (void)setCompletionDate {
if (self.completed) {
self.completionDate = [NSDate date];
} else {
self.completionDate = nil;
}
}
@end
到這裡,XYZToDoItem 已經具備了待辦項目的基本表示能力:它能儲存名稱、建立日期與完成狀態,也能透過方法改變自己的狀態。這正是後續章節實作待辦清單功能所需的基礎。
而這套「公開介面 + 私有實作」的分工,會在你往後每一次替類別加入新屬性與新方法時反覆出現——想清楚哪些該對外開放、哪些該收在內部,是設計類別時最值得先想的一件事。