命名縮寫只用于通用專業(yè)術(shù)語,如URL,不可自創(chuàng)命名縮寫,如Ctr、Msg。命名寧可長一些,也不要難于理解。
動(dòng)作發(fā)生之前用Will,發(fā)生之后用Did,詢問是否發(fā)生用Should。
每個(gè)處理都是有一定過程的,這個(gè)處理往往會(huì)產(chǎn)生一些通知和回調(diào),好的命名必須要明確當(dāng)前過程中的步驟。命名這些通知和回調(diào)時(shí)最好提供發(fā)生前后兩個(gè)版本,如果發(fā)生前要回調(diào)確認(rèn),請(qǐng)用Should命名該回調(diào),并返回一個(gè)BOOL值。
各種全局作用范圍的函數(shù),常量,類,枚舉,結(jié)構(gòu)等命名必須加命名前綴。
Objective-C中沒有C++那樣的名字空間概念,也沒有java包名的概念,隨著工程代碼的增加,難免會(huì)出現(xiàn)名字沖突,因此全局作用范圍的名字必須唯一。比較經(jīng)典的做法就是加命名前綴。大多數(shù)人認(rèn)為命名前綴只是在類的前面加幾個(gè)大寫字母,其實(shí)不僅僅如此。
類型(類、枚舉、結(jié)構(gòu))命名前要加相關(guān)模塊前綴。
UIViewNSStringCGRect常量命名要加相關(guān)類型名前綴。
UIapplicationDidFinishLaunchingNotificationCGRectZero函數(shù)命名要加相關(guān)類型名前綴。
CGRectMakeCGPointMake枚舉類型命名要加相關(guān)類名前綴,并且枚舉值命名要加枚舉類型前綴。
typedef NS_ENUM(NSInteger, UIViewAnimationTransition) { UIViewAnimationTransitionNone, UIViewAnimationTransitionFlipFromLeft, UIViewAnimationTransitionFlipFromRight, UIViewAnimationTransitionCurlUp, UIViewAnimationTransitionCurlDown,};方法命名時(shí),每個(gè)參數(shù)前要加參數(shù)的名稱提示。
- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil- (void)performSegueWithIdentifier:(NSString *)identifier sender:(id)sender給一個(gè)帶修飾的對(duì)象命名時(shí)要采用修飾+類型的方式,而不是先指定其類型。
很多人喜歡把對(duì)象的類型放在對(duì)象的命名前面,從而來標(biāo)識(shí)一個(gè)對(duì)象是什么類型,這很不符合Objective-C語言的特點(diǎn),容易引起歧義,比如一個(gè)UILabel對(duì)象:
titleLabel //表示標(biāo)題的label,是UIlabel對(duì)象labelTitle //label的標(biāo)題?似乎是一個(gè)NSString?confirmButton //確認(rèn)按鈕buttonConfirm //不自然的命名,看上去像是按鈕點(diǎn)擊動(dòng)作。大部分方法可以分成下面兩類,而這兩類往往被亂用。它們是:
“要什么”表示取得某個(gè)對(duì)象,要以名詞作為方法的開頭;“做什么”表示執(zhí)行某種操作,要以動(dòng)詞作為方法開頭。看看下面這個(gè)命名方式:
- (XXItem *)itemNamed:(NSString *)name //Good. 意思清晰- (XXItem *)findItemWithName:(NSString *)name //更像是一種操作,而不是返回一個(gè)對(duì)象。findItemWithName這個(gè)命名表示一種操作,而無需返回對(duì)象,比如它可以用于設(shè)置類的內(nèi)部成員,比如:
- (void)findItemWithName:(NSString *)name{ ... self.foundItem = xxx; ...}“要什么”往往被胡亂命名為get開頭的方法。首先get是一個(gè)動(dòng)詞,所以它還是“做什么”或者說“做的是要什么”。那么get方法不要用于返回對(duì)象,但它可用于參數(shù)中返回。
- (XXItem *)getItemAtIndex:(NSUInteger)index //Bad!! 不規(guī)范的命名- (XXItem *)itemAtIndex:(NSUInteger)index //Good, 命名清晰- (void)getItem:(XXItem **)outItem atIndex:(NSUInteger)index //比較符合規(guī)范,但第二種更好。回調(diào)時(shí)被調(diào)用者要知道其調(diào)用者
可以在回調(diào)方法中第一個(gè)參數(shù)中加上調(diào)用者:
- (BOOL)application:(UIApplication *)application willFinishLaunchingWithOptions:(NSDictionary *)launchOptions- (void)buttonTapped:(UIButton*)sender全局常量不可使用宏定義
我們經(jīng)常看到一些用宏定義的通知,關(guān)鍵字等。其實(shí)這么做是非常危險(xiǎn)的,因?yàn)楹旰芸赡鼙恢囟x,而且引用不同的文件可能會(huì)導(dǎo)致宏的不同,所以盡量使用const來定義常量。
新聞熱點(diǎn)
疑難解答
圖片精選
網(wǎng)友關(guān)注