作者簡介 原創(chuàng)微信公眾號郭霖 WeChat ID: guolin_blog
大家早上好,新的一周開始啦!
本篇來自TinyX的投稿,講解了Android中的命名規(guī)范,供大家參考。畢竟好的命名能起到注釋的作用!
TinyX的博客地址:
http://blog.tinyx.cc
正文
標(biāo)識符命名法最要有四種:
1. Camel(駱駝)命名法:除首單詞外,其余所有單詞的第一個字母大寫,如:fooBar;
2. Pascal命名法:所有單詞的第一個字母大寫,如:FooBar;
3. 下劃線命名法:單詞與單詞間用下劃線做間隔,如:foo_bar;
4. 匈牙利命名法:廣泛應(yīng)用于微軟編程環(huán)境中,在以Pascal命名法的變量,首字母小寫說明該變量的類型。 變量的取名方式為:scope_?prefix_qualifier 范圍前綴,類型前綴,限定詞,如:g_foo_bar("g_"表示全局變量);
安卓App層開發(fā)主要是Java語言,所以基本使用除了第四種外的命名方式;
縮寫在命名是必須的,遵循下面規(guī)則:
1.較短的單詞可通過去掉“元音”形成縮寫,如icon->ic;
2.較長的單詞可取單詞的頭幾個字母形成縮寫,如:average->avg;
3.此外還有一些約定成俗的英文單詞縮寫,如?Internationalization->I18N;
4.程序中不要用縮寫,除非該縮寫是約定俗成的。
命名規(guī)范:
包(packages):采用反域名命名規(guī)則,全部使用小寫字母。一級包名為地頂級域名如com,二級包名為xx(可以是公司或則個人的隨便),三級包名根據(jù)應(yīng)用進(jìn)行命名,四級包名為模塊名或?qū)蛹壝? 如 com.tinyx.myapp.activities;
類(classes):用Pascal命名法,盡量避免縮寫,如:MyActivity;縮寫是眾所周知的,如HTML,URL;類名稱中包含單詞縮寫,則單詞縮寫的每個字母均應(yīng)大寫,如:PublicHTML,CommonURL。
接口(interface):與類一樣用Pascal命名法,多以 able 或 ible 結(jié)尾,多用作表示行為,如Runnable,Accessible;
方法(methods):動詞或動名詞,采用Camel命名法,如:onCreate(),run();下面是一些建議:
初始化相關(guān)方法,使用init為前綴標(biāo)識,如:初始化布局initView();
boolean型使用is或check為前綴標(biāo)識,?如:checkValue()、isValidate();
返回某個值的方法,使用get為前綴標(biāo)識,如:getName();
數(shù)據(jù)進(jìn)行處理相關(guān),盡量使用process為前綴標(biāo)識,如:processUpdate();
保存數(shù)據(jù)相關(guān),使用save為前綴標(biāo)識,如:saveData();
對數(shù)據(jù)重置的,使用reset前綴標(biāo)識,如:resetData();
清除數(shù)據(jù)相關(guān),使用clear前綴標(biāo)識,如:clearData();
移除某些項目,使用remove前綴標(biāo)識,如:removeItem();
繪制數(shù)據(jù)或效果相關(guān)的,使用draw前綴標(biāo)識,如:drawCircle();
變量(variables):采用Pascal命名法,建議采用有意義的命名如:firstName,lastName;
模型類變量默認(rèn)以上規(guī)則:
非模型類全局參數(shù)建議加上小寫m開頭:
常量(constants):全部大寫,采用下劃線命名法.如下:
資源文件命名(resources):采用下劃線命名法,全部小寫,針對不同資源,建議用下面的命名方法;
drawable資源,加前綴命名:前綴_功能_模塊_說明.xml/png
layout 資源文件,前綴命名:類型_模塊_功能_說明.xml,舉一些常用的例子如下:
動畫anim資源文件(anim只有一種資源,所以不必加前綴區(qū)分):模塊_功能_動畫_方向.xml
menu菜單資源文件(menu只有一種資源,所以不必加前綴區(qū)分),模塊_功能_說明.xml
values資源,這個主要分下面幾種資源:
1.ids資源,主要存放是界面控件的id值,用下劃線小寫命名法,前綴方式:前綴_模塊_功能_說明,常用界面控件命名如下:
2.strings/arrays/dimens資源,用下劃線小寫命名法,不加任何前后綴,格式,模塊_功能_說明
3.attrs/colors/ids的屬性和名稱使用 Camel命名法; styles的屬性使用 Camel命名法,名稱使用 Pascal命名法;如下面:
完。。。。。。。。。。。。。。。。。。。。。
文章原創(chuàng)作者GuoLin 書籍推薦
郭林大神原創(chuàng)android 書籍:《第一行代碼 android》
