所有命名规则遵循以下规则
(a)名称只能由字母、数字、下划线、$符号等组成,,但不能以数字开头。
(b)名称不能使用JAVA中的关键字,比如 char、 double、if、for、class。
(c)严禁使用拼音与英文的混合方式命名,更不允许使用中文的方式命名;
命名尽量使用英文,除了通用的拼音(Beijing)可视为英文,其他的拼音都不是英文;
命名除了常见的英文缩写,尽量避免使用缩写;
命名需要简洁,见名知意,通俗易懂;
元素名称 | 简介 | 命名规范 | 示例 |
包 (Pac-kage) | 使用包是为了确保类名的唯一性,Java允许使用包把类组织到一个集合中,借助包可以方便地组织自己的代码,并将自己的代码和别人提供的代码库分开管理 | 采用完整的英文描述符,应该都由小写字母组成。对于全局包,将Internet域名反转并接上包名; 具体包结构的组成规则如下: 【个人】 indi:多人完成,版权属于发起者 包名:indi.发起者名.项目名.模块名*.*.\* pers :独自完成,公开,版权主要属于个人。 包名:pers.个人名.项目名.模块名*.*.* priv : 独自完成,非公开,版权属于个人。 包名:priv.个人名.项目名.模块名*.*.* 【团队】 team:团队项目指由团队发起,并由该团队开发的项目,版权属于该团队所有。 包名:team.团队名.项目名.模块名*.*.* 【公司】 com:由公司发起,版权由项目发起的公司所有。 包名:com.公司名.项目名.模块名*.*.* | com.srt.moa.action |
类 (class) | 类是构造对象的模板或蓝图。可以将类想象成制作小甜饼的模具,将对象想象成小甜饼,用类构造对象的过程称为创建类的实例 | 推荐使用大驼峰命名形式,类名一般使用(动)名词或(动)名词组合来表示,并且各个名词的首字母大写,其他字母小写。 | 类描述举例 Activity类以Activity为后缀启动页面:LaunchActivity Fragment类以Fragment为后缀论坛推荐列表:TribuneRecommendFragment Adapter类以Adapter为后缀论坛适配器:TribuneAdapter ViewHolder类以ViewHolder为后缀广告类型:AdViewHolder Bean类以Bean为后缀新闻实体类:NewsBean Model类以Model为后缀论坛推荐Model:TribuneRecommendModel 工具类以Util为后缀网络工具类:NetWorkUtil Service类以Service为后缀音频服务:AudioService BroadcastReceiver 类以Receiver为后缀音频广播:AudioReceiver ContentProvider类以Provider为后缀联系人的内容提供者:ContactsProvider Dialog类以Dialog为后缀加载:LoadingDialog 监听器类以Listener为后缀网络监听:NetWorkListener 自定义基础类以Base为前缀例如:BaseActivity,BaseFragment 抽象类以 Abstract或者Abs为前缀例如:AbsBean 管理类以Manager为后缀联系人管理类:ContactsManager 解析类以Parser为后缀新闻Json解析类: NewsJsonParser |
接口 (Interface) | 在Java程序设计语言中,接口不是类,而是对希望符合这个接口的类的一组需求,是抽象方法的集合,接口通常以interface来声明。一个类通过继承接口的方式,从而来继承接口的抽象方法 | 接口名与类名类似,一般使用(动)名词或(动)名词组合来表示,并且各个名词的首字母大写,其他字母小写。可以以大写的I开头,表示这是一个接口,以able或ible截尾 | IContactablePrompter |
方法 (Method) | 1、方法就是对一段功能逻辑的封装,用来实现重复使用。定义在类中。如果不调用当然就不执行。如果需要并且定义了返回值的类型,必 须由return带回一个明确了类型的值。 2、抽取一段代码放进{}中,起个名字,就是方法。比如常用的“main”就是主方法,是一个程序的入口,是jvm来调用的,一个类中只能有一个主方 法。 3、方法定义在类中。方法和方法之间是平级关系,不能嵌套。所以编写时候要注意编写的位置。 | 采用小驼峰的形式,方法一般用一个动宾短语组成,以动词+名词的方式组成,表示一个动作。方法的首字母小写(通常是动词的首字母),而其他单词的首字母大写 | public void balanceAccount(intdeposit){ ... } |
异常 (Exception) | 错误捕捉机制,用于分析查看异常情况 | 通常采用字母e表示 | Exception e |
变量名 | Java用于存储值,每一个变量都有一个类型(type) | 变量的名称一般使用一个(动)名词或其组合来表示,并且首字母小写,其他单词的字母大写 | private int age=0; private String studentName=""; |
静态常量字段 (Static Final) | 常量是值不变的变量 | 全部采用大写字母,单词之间用下划线分隔 | static final int MAX_SIZE=10; |
数组 | 数组是一种数据结构,用来存储同一类型值的集合,是一个序列; | 数组应该总是用如下方式来命名的: byte[] buffer; 而不是如下方式: byte buffer[]; | byte[] buffer; |