首页 > 编程知识 正文

java标识符命名规则(java的命名规范有哪些)

时间:2023-05-03 20:57:13 阅读:67755 作者:2453

规格的目的是统一项目的代码样式,使程序易于阅读。

包命名(全部由小写字母、域名定义) )。

Java包的所有名称都由小写的单词组成。 但是,由于Java面向对象编程的特性,每个Java程序员都可以创建自己的Java包。 为了确保每个Java软件包的命名唯一性,最新的Java编程规范要求程序员在自己定义的软件包名称前加上唯一的前缀。 因为internet上的域名不重复,所以程序员通常将自己internet上的域名称为自己软件包的唯一前缀。

例如,net.frontfree.javagroup

命名类(将单词首字母大写)

根据规则,Java类名通常以大写字母开头,如果类名由多个单词组成,则每个单词的首字母必须大写。 例如,测试页面; 如果类名包含缩写,则单词的所有字符都必须大写,如XMLExample。 此外,类旨在表示对象,因此命名类时必须尽量选择名词。

例如,图形

方法的命名(首字母小写、首字母大写) ) ) ) )。

的方法名称中的第一个单词必须以小写字母开头,下一个单词必须以大写字母开头。

例如,drawImage

常数命名(全部大写,始终带下划线) ) ) ) )。

常数的名称必须使用大写字母,以指示常数的完整含义。 如果定名由多个单词组成,则必须用下划线分割单词。

例如,MAX_VALUE

参数命名

参数的命名规则和方法的命名规则相同。 另外,为了在阅读程序时避免混乱,请在尽量保证参数名称为一个词的基础上,尽量明确参数的命名。

Javadoc注释

除了Java可以采用常见的注释方法外,Java语言规范还定义了用于在代码中记录API的特殊注释,即Javadoc注释。 Javadoc注释是以/**开头并以*/结尾的多行注释。 注释可以包含几个HTML标记和特殊关键字。 使用Javadoc注释的好处是,可以将创建的注释自动转换为在线文档,从而省去创建单个程序文档的麻烦。

例如:

//*

* This is an example of

* Javadoc

* @author darchon

* @版本0.1,10/11/2002

*/

在每个程序的第一部分,Javadoc注释通常提供程序的总体说明和版权信息。 然后,可以在主程序中将Javadoc注释添加到每个类、接口、方法和字段中。 每个注释的第一部分首先用一句话概括类、接口、方法和字段完成的功能。 这句话单独占一行,强调其摘要的作用。 这个词后可以接更详细的说明段落。说明性段落后也可以接以Javadoc注释标记开头的特殊段落,如上面示例中的@auther和@version。 这些段落在生成的文档中以特定的方式显示。

命名变量和常数

命名变量

主要命名规则有以下三条。

Camel表示法:的首字母是小写字母,后面的所有单词都以大写字母开头

Pascal表示法:的首字母大写,所有后续单词都以大写字母开头

匈牙利标记法:在Pascal标记法的变量之前添加小写字母序列以描述该变量的类型

Java一般使用匈牙利标记法。 基本结构为scope_typeVariableName,使用1-3个字符的前缀来表示数据类型。 三个字符的前缀必须是小写字母。 前缀后面是一个或多个表意单词的名称,每个单词的首字母用大写字母表示,其他字符用小写字母表示。 这可以确保变量名称正确换行。 例如,定义记录文档数量的整形变量。 intDocCount。 其中int表示数据类型,后面是英文名称,每个单词的开头是大写字母。 这样,变量的类型和变量中存储的值的含义都可以反映在一个变量名称中,代码语句的可读性更高,更容易理解。 字节、整型、字符、长整型、浮点型、双精度、布尔型、短整型。

数据类型/前缀(

字节b

char c

短sh

int i

长乐l

char c

弦乐队

浮动f

双精度d

hashtable h

[] arr

列表列表

Vector v

StringBuffer sb

布尔型b

Byte bt

地图地图

对象操作系统

对于在多个函数中使用的全局变量,请在前面添加" g_ "。 例如,有一个名为g_strUserInfo的全局字符串变量。

命名变量时,请注意以下事项:

注意选择有意义的名字,把每个单词的首字母大写。

一个函数中前后意思不同的两个数值不用同一变量表示。

p>· i、j、k等只作为小型循环的循环索引变量。

· 避免用Flag来命名状态变量。

· 用Is来命名逻辑变量,如:blnFileIsFound。通过这种给布尔变量肯定形式的命名方式,使得其它开发人员能够更为清楚的理解布尔变量所代表的意义。

· 如果需要的话,在变量最后附加计算限定词,如:curSalesSum。

· 命名不相包含,curSales和curSalesSum。

· static final 变量(常量)的名字应该都大写,并且指出完整含义。

· 如果需要对变量名进行缩写时,一定要注意整个代码中缩写规则的一致性。例如,如果在代码的某些区域中使用intCnt,而在另一些区域中又使用intCount,就会给代码增加不必要的复杂性。建议变量名中尽量不要出现缩写。

· 通过在结尾处放置一个量词,就可创建更加统一的变量,它们更容易理解,也更容易搜索。例如,请使用 strCustomerFirst和strCustomerLast,而不要使用strFirstCustomer和strLastCustomer。常 用的量词后缀有:First(一组变量中的第一个)、Last(一组变量中的最后一个)、Next(一组变量中的下一个变量)、Prev(一组变量中的上 一个)、Cur(一组变量中的当前变量)。

· 为每个变量选择最佳的数据类型,这样即能减少对内存的需求量,加快代码的执行速度,又会降低出错的可能性。用于变量的数据类型可能会影响该变量进行计算所产生的结果。在这种情况下,编译器不会产生运行期错误,它只是迫使该值符合数据类型的要求。这类问题极难查找。

· 尽量缩小变量的作用域。如果变量的作用域大于它应有的范围,变量可继续存在,并且在不再需要该变量后的很长时间内仍然占用资源。它们的主要问题是,任何类 中的任何方法都能对它们进行修改,并且很难跟踪究竟是何处进行修改的。占用资源是作用域涉及的一个重要问题。对变量来说,尽量缩小作用域将会对应用程序的 可靠性产生巨大的影响。

关于常量的命名方法,在JAVA代码中,无论什么时候,均提倡应用常量取代数字、固定字符串。也就是 说,程序中除0,1以外,尽量不应该出现其他数字。常量可以集中在程序开始部分定义或者更宽的作用域内,名字应该都使用大写字母,并且指出该常量完整含 义。如果一个常量名称由多个单词组成,则应该用下划线“_”来分割这些单词如:NUM_DAYS_IN_WEEK、MAX_VALUE。

版权声明:该文观点仅代表作者本人。处理文章:请发送邮件至 三1五14八八95#扣扣.com 举报,一经查实,本站将立刻删除。