單例模式是最常被使用的軟體設計模式之一。它的核心結構中只包含一個稱為「單例」的特殊類別,能保證系統中該類別只有一個實例,且這個實例易於被外界存取。這樣一來,就能方便地控制實例數量並節省系統資源。當你確定某個類別的物件在整個 App 生命週期內只該存在一份時——例如網路管理器、資料庫連線、使用者狀態、設定中心——單例就是最合適的方案。
不論用哪種寫法,骨架都是這三步:
1. 建立一個類別方法用來回傳物件實例,命名慣例以 shared、default 或 current 開頭。
2. 建立一個全域(靜態)變數用來保存該實例的參照。
3. 在類別方法中判斷實例是否存在,不存在則建立。
第一種:非執行緒安全寫法
// 非執行緒安全寫法
static UserHelper *helper = nil;
+ (UserHelper *)sharedUserHelper {
if (helper == nil) {
helper = [[UserHelper alloc] init];
}
return helper;
}
這是最直覺的寫法,但存在明顯缺陷:若兩個執行緒同時通過 if 判斷,就會各自建立一次實例,單例的獨一性被破壞。單執行緒環境下可用,多執行緒場景則不可。
第二種:用 @synchronized 加鎖
// 執行緒安全寫法
static UserHelper *helper = nil;
+ (UserHelper *)sharedUserHelper {
@synchronized(self) {
if (helper == nil) {
helper = [[UserHelper alloc] init];
}
}
return helper;
}
加上同步區塊後獨一性得到保障,代價是每次存取都要搶鎖,在高頻呼叫的場景下會產生不必要的效能損耗。
第三種:重寫 initialize
+ (void)initialize {
if ([self class] == [UserHelper class]) {
helper = [[UserHelper alloc] init];
}
}
這個寫法較為冷門,但值得理解其原理。initialize 會在類別第一次收到訊息之前由 runtime 自動呼叫一次,因此天生具備執行緒安全性。而 if ([self class] == [UserHelper class]) 這個判斷不可省略——若類別被子類化,子類別也會各自觸發一次 initialize,少了這行就會建立出多個實例。
第四種:dispatch_once(Apple 推薦,實務首選)
// 執行緒安全寫法(Apple 推薦)
static UserHelper *helper = nil;
+ (UserHelper *)sharedUserHelper {
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
helper = [[UserHelper alloc] init];
});
return helper;
}
GCD 的 dispatch_once 由系統保證區塊在整個程式執行期間只會被執行一次,且具備完整的執行緒安全與記憶體屏障語意。它同時兼顧了正確性與效能(後續呼叫幾乎零開銷),程式碼也最簡潔,是當代 iOS 開發的標準答案。
下面是一個把單例用在真實場景的範例:UserHelper 負責管理登入狀態,並把帳密持久化到本機檔案。
標頭檔:
#import <Foundation/Foundation.h> @interface UserHelper : NSObject // 1. 類別方法,回傳物件實例 + (UserHelper *)sharedUserHelper; @property (nonatomic, copy) NSString *userName; @property (nonatomic, copy) NSString *password; + (BOOL)isLogin; + (void)loginWithUserName:(NSString *)userName password:(NSString *)password; + (void)logout; @end
實作檔:
#import "UserHelper.h"
// 2. 建立一個全域變數保存實例
#define Path @"/Users/dahuan/Desktop/data"
static UserHelper *helper = nil;
@implementation UserHelper
+ (UserHelper *)sharedUserHelper {
// 3. 判斷物件是否存在,不存在則建立
// 以 gcd 確保執行緒安全
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
helper = [[UserHelper alloc] init];
});
return helper;
}
- (instancetype)init {
if (self = [super init]) {
// 首次建立時,嘗試從本機檔案還原上次登入的帳密
NSString *data = [NSString stringWithContentsOfFile:Path
encoding:NSUTF8StringEncoding
error:nil];
if (data) {
NSArray *array = [data componentsSeparatedByString:@"-"];
_userName = array[0];
_password = array[1];
}
}
return self;
}
+ (BOOL)isLogin {
UserHelper *helper = [UserHelper sharedUserHelper];
if (helper.userName && helper.password) {
return YES;
}
return NO;
}
+ (void)loginWithUserName:(NSString *)userName password:(NSString *)password {
UserHelper *helper = [UserHelper sharedUserHelper];
helper.userName = userName;
helper.password = password;
// 持久化到本機
NSArray *array = @[userName, password];
NSString *data = [array componentsJoinedByString:@"-"];
[data writeToFile:Path atomically:YES encoding:NSUTF8StringEncoding error:nil];
}
+ (void)logout {
NSFileManager *fm = [NSFileManager defaultManager];
if ([fm fileExistsAtPath:Path]) {
[fm removeItemAtPath:Path error:nil];
}
}
@end
呼叫端:
int main(int argc, const char *argv[]) {
@autoreleasepool {
if ([UserHelper isLogin]) {
UserHelper *helper = [UserHelper sharedUserHelper];
NSLog(@"username = %@ password = %@", helper.userName, helper.password);
} else {
char name[20];
char pwd[20];
NSLog(@"請輸入用戶名");
scanf("%s", name);
NSLog(@"請輸入密碼");
scanf("%s", pwd);
NSString *userName = [[NSString alloc] initWithUTF8String:name];
NSString *password = [[NSString alloc] initWithUTF8String:pwd];
if (userName && password) {
[UserHelper loginWithUserName:userName password:password];
UserHelper *helper = [UserHelper sharedUserHelper];
NSLog(@"username = %@ password = %@", helper.userName, helper.password);
}
}
}
return 0;
}
由於 sharedUserHelper 保證回傳同一個物件,任何一處修改了 userName,其他所有取得該單例的地方都會看到相同的值——這正是單例做「全域狀態共享」的價值所在。
單例好用,但濫用會帶來隱性成本:它本質上是被藏起來的全域變數,會讓單元測試變得困難(測試之間狀態互相污染),也容易讓依賴關係變得隱晦。實務上有幾個原則值得參考:
其一,只為「概念上確實唯一」的東西建立單例,例如 App 設定、網路工作階段、資料庫連線;不要為了存取方便就把工具類全部單例化。
其二,若需要可替換性(例如測試時注入假實作),可保留單例作為預設入口,同時允許外部注入自訂實例。
其三,Swift 中相同概念直接寫成 static let shared = UserHelper() 即可,編譯器保證初始化只發生一次且執行緒安全,比 dispatch_once 更簡潔。