做 SDK 時經常會遇到這樣的狀況:假設 SDKUser.h 是對外公開的標頭檔,其中 SDKUser 的 uid 屬性不希望暴露給使用者,但 SDK 內部的某些私有類別又需要讀取它。
換句話說,uid 需要「對 SDK 外不可見、對 SDK 內可見」。這個需求用 Category 就能漂亮地解決。
第一步:對外公開的標頭檔
SDKUser.h:
@interface SDKUser : NSObject @property (nonatomic, copy, readonly) NSString *username; @end
在對外標頭檔中,若不希望外部修改這個屬性,就宣告為 readonly;同時在實作檔中把它重新宣告為 readwrite,讓 SDK 內部可以寫入。
第二步:實作檔中的類別延伸
SDKUser.m:
#import "SDKUser.h" @interface SDKUser () // 對外屬性(內部可讀寫) @property (nonatomic, copy, readwrite) NSString *username; // 僅內部屬性 @property (nonatomic, copy, readwrite) NSString *uid; @end @implementation SDKUser @end
username 在 SDK 內部需要支援讀寫,所以宣告為 readwrite;而 uid 完全不打算對外公開,因此放進 .m 的類別延伸裡。問題是:寫在 .m 中的屬性僅支援「類別內部」存取,SDK 內的其他私有類別就拿不到 uid 了。
第三步:用 Category 打通內部可見性
這時可以對 SDKUser 做一個 Category,把 SDK 內部需要共享的私有屬性與方法集中放進去:
// SDKUser+SDKInner.h #import "SDKUser.h" @interface SDKUser (SDKInner) // 基本屬性 @property (nonatomic, copy) NSString *uid; @property (nonatomic, copy, readonly) NSString *username; @end // -------------------------------- // SDKUser+SDKInner.m #import "SDKUser+SDKInner.h" @implementation SDKUser (SDKInner) @end
如此一來,SDK 內的私有類別就能存取 SDKUser 的 uid,而這個屬性完全不會出現在對外標頭檔中,也就不會洩露給接入方。
這個小技巧的價值在於:它把「可見性」從單純的存取控制層級,變成一件可以用檔案組織來精確表達的設計決策——公開的放進 public header,內部共享的放進 Category,純私有的留在 .m 的類別延伸裡,三層涇渭分明。