命名规范
包命名规范
采用反域名命名规则,包名全部小写,连续的单词只是简单地连接起来,不使用下划线,一级包名为com,二级包名为xxx(可以是公司域名或者个人命名),三级包名根据应用进行命名,四级包名为模块名或层级名。如:
com.isa.crm.activity
|
com.isa.crm.adapter
JAVA类命名规范
采用大驼峰式命名法,尽量避免缩写,除非该缩写是众所周知的,比如HTML,URL,如果类名称包含单词缩写,则单词缩写的每个字母均应大写。如:
Product
|
ProductManager
|
ProductListActivity
|
ProductListAdapter
|
JsonHTTPSRequest
接口命名规范
命名规则与类一样采用大驼峰命名法,多以
able
或
ible
结尾。例如:
interface Runable
|
interface Accessible
成员变量命名规范
采用小驼峰命名法。
临时变量命名
使用标准的Java命名方法,不推荐使用Google的m命名法。例如:
private String userName;
而不推荐使用
private String mUserName;
常量命名
常量使用全大写字母加下划线的方式命名。例如:
public static final String TAG = "tag";
控件实例命名
{module_name}
)。例如:
android:id="@+id/btn_pay"
private Button btn_pay;
方法命名规范
动词或动名词,采用小驼峰命名法。例如:
run();
|
onCreate();
|
syncProducts();
Layout)命名规范
{module_name}
为业务模块或是功能模块等模块化的名称或简称。 activity layout:
{module_name}_activity_{名称}
crm_activity_main.xml
|
crm_activity_shopping.xml
fragment layout:
{module_name}_fragment_{名称}
crm_fragment_main.xml
|
crm_fragment_shopping.xml
Dialog layout:
{module_name}_dialog_{名称}
crm_dialog_loading.xml
列表项布局命名:
{module_name}_list_item_{名称}
crm_listitem_customer.xml
包含项布局命名:
include_{名称}
include_head.xml
adapter的子布局:
{module_name}_item_{名称}
qz_item_order.xml
widget layout:
{module_name}_widget_{名称}
crm_widget_shopping_detail.xml
资源id命名规范
{view缩写}_{module_name}_{view的逻辑名称}
,如:
LinearLayout
的布局id –>
ll_crm_content
ImageView
的布局id –>
iv_qz_photo
常见控件View与其缩写对照参考表如下:
![](https://img.laitimes.com/img/_0nNw4CM6IyYiwiM6ICdiwiI0gTMx81dsQWZ4lmZf1GLlpXazVmcvwFciV2dsQXYtJ3bm9CX9s2RkBnVHFmb1clWvB3MaVnRtp1XlBXe0xCMy81dvRWYoNHLwEzX5xCMx8FesU2cfdGLwMzX0xiRGZkRGZ0Xy9GbvNGLpZTY1EmMZVDUSFTU4VFRR9Fd4VGdsYTMfVmepNHLrJXYtJXZ0F2dvwVZnFWbp1zczV2YvJHctM3cv1Ce-cmbw5SO3kjM5YTMzcTO0YmN1UGZyYzXwIDM0YTM1IzLcdDMyIDMy8CXn9Gbi9CXzV2Zh1WavwVbvNmLvR3YxUjLyM3Lc9CX6MHc0RHaiojIsJye.png)
图片资源文件命名规范
图标命名:
{module_name}_ic_{名称}
crm_ic_app.png
背景图片命名:
{module_name}_bg_{名称}
crm_bg_navbar_highlight_normal.9.png
按钮Button命名:
{module_name}_btn_{名称}
crm_btn_login_normal.9.png
按钮checkbox图片命名:
{module_name}_checkbox_{名称}
crm_checkbox_cart_true.png
其他图片命名:
{module_name}_icon_{名称}
qz_icon_blue_circle.png
代码风格
大括号问题
风格一
if (hasMoney())
{
}
else
{
}
风格二
if (hasMoney()) {
} else {
}
空格问题
if else
|
while
|
运算符两端
规范的编写方式:
if (hasMoney()) {
} else {
}
for (int i = 0; i < 10; i++) {
}
不规范的编写方式:
if(hasMoney()){
}else{
}
for(int i=0; i<10;i++){
}
方法参数
当方法参数数量过多时,需进行换行处理.
注释
必须要对所有实例变量、类常量进行注释说明 例如:
// 用户姓名
private
String userName
必须对所有的类、接口进行注释说明 例如:
/**
* Activity基类
*
*/
public class BaseActivity extends Activity
{
}
必须对所有的方法进行注释说明 例如:
/**
* 请求
*
* @param path 路径
* @param generalParams 基本参数
* @param businessParams 业务参数
* @return 请求结果
* @throws ApiException 请求错误则返回该异常
*/
public Map<String, Object> request (String path,
Map<String, Object> generalParams,
Map<String, Object> businessParams) throws ApiException {
return null;
}
更多详细也可以参考:
[Google Java编程风格指南](http://hawstein.com/posts/google-java-style.html)
驼峰式命名法(CamelCase)
- 大驼峰式命名法(
UpperCamelCase
-
):
每个单词的第一个字母都大写 如:
XmlHttpRequest
- 小驼峰式命名法(
-
):
除了第一个单词,每个单词的第一个字母都大写 如: