Java命名规范:注重细节

转载 2012年03月29日 10:02:35
Java命名规范:注重细节

 

任何一门语言都是用来交流的,都有自己的一套书写规范,Java 也不例外。
注重这些细节有几个好处:
1. 好的命名规范可以使得写出来的程序更容易被别人理解,更好维护。当然也易于自己理解,以便日后扩展。
   同时,也使程序更规范和专业。  在这个人性化横行的今天,我们的Java命名规范也应该注重体验。

2. 了解命名规范,可以更好的学习和记忆 Java 类库中的类和函数等。

3. 在命名规范里有很多都涉及到英文的,可以促进英文学习。
  比如: numberMax, MaxNumber和maxNumber都是有区别的。  maxNumber可能是属性名; MaxNumber一般是类名; numberMax更倾向于方法。这里也有一个英文的搭配问题。
比如:FileRead, FileReader,  这个显然后者作为类名好些。
readFile,fileRead,   这个显然前者作为方法更合适。


下面的几个原则是编写 Java 程序必须遵守的
如果没有非常好的理由,永远不要违背他。

1.包
由小写字母和少量数字组成
Java 自己的包以 java. 和 javax 开头,比如:java.awt
别的组织开发的包以 组织的 Internet 域名部分开头,比如:com.sun, com.borland
一些例子:
com.aliasi.hmm;  com.aliasi.classify;  com.aliasi.cluster;
com:组织;  aliasi:具体的组织名或者个人;  classify,cluter:包名(主题)
org.apache.lucene;  org.apache.lucene.analysis.standard;
org.apache.nutch.ndfs; org.apache.nutch.fs; org.apache.nutch.db; org.apache.nutch.parse;


2.类,接口
由一个或几个单词组成,每个单词的第一个字母大写,比如:StringBuffer
类:一般用名词和名词词组命名;  IndexOptimizer.java;     WebDbReader.java
接口:与类相同,可以使用形容词词缀,比如 Runnable, Comparable

3.方法
除第一个字母小写外,和类,接口的命名规则一样。比如:getPersonInfo()
对于取属性值和设置属性值的方法:
不管是否是 Bean,都要遵循 JavaBean 命名规范:getXXX(), setXXX()
转换对象类型返回不同类型的方法:
命名成 toType,比如:toString(), toArray()
返回视图的方法:
命名成 asType() 形式,asList()
返回与调用此方法的对象(Wrapper Class)同值的原始类型的方法:
命名成 typeValue() 形式,比如 intValue(), floatValue()

parseCharacterEncoding(String);

4.域(属性)
普通域:
除第一个字母小写外,和类,接口的命名规则一样。比如:personInfo
常数域:
由一个或多个被下划线分开的单词组成,比如:VALUES, NEGATIVE_INTINITY
常数域是唯一允许使用下划线的情况。

5.局部变量
命名与域相同,可以使用简写,比如:i, j, temp, maxNumber

『细节』是什么

图片来自网络,作者不详只要是职场人士,谈及『细节』二字估计很容易让人联想到『细节决定成败』这句话。由于这句话无人不知、无人不晓,以至于容易将『细节』误以为是口号。就我在工作中的感受,发现确实大多数人是...
  • hzliyun
  • hzliyun
  • 2015年09月05日 10:51
  • 5274

JAVA书写规范、命名规范

书写规范 花括号不要单独一行,和它前面的代码同一行。而且,花括号与前面的代码之间用一个空格隔开。 public void method() { // Good } public...
  • alex_bean
  • alex_bean
  • 2016年06月15日 14:37
  • 1011

java编程规范之java命名规范

想要成为一个优秀的程序员,首先要培养良好的编程习惯,为了提高代码的可读性,必须有好的命名规范。 这篇文章是小编结合网上的很多资料整理出来的,若有不当或错误的地方,欢迎大家指正 在文章开始前,为方便阅读...
  • u012116457
  • u012116457
  • 2014年03月30日 14:03
  • 7665

Java包(package)的命名规范,java中package命名规则

Java的包名都有小写单词组成,类名首字母大写;包的路径符合所开发的 系统模块的 定义,比如生产对生产,物资对物资,基础类对基础类。以便看了包名就明白是哪个模块,从而直接到对应包里找相应的实现。 ...
  • kongjiea
  • kongjiea
  • 2015年04月29日 14:02
  • 76234

Java 项目的命名规范

做开发的都知道,一个好的项目规范可以提高开发效率以及后期的维护。自己手上有个项目,里面规范很乱,自己在对它进行二次开发的时候很蛋疼,它没有相应的文档,公司给我的就只有一个项目源码,其中的关系还要自己去...
  • u012486437
  • u012486437
  • 2016年07月24日 13:23
  • 3711

阿里巴巴Java开发命名规范

1. 【强制】 代码中的命名均不能以下划线或美元符号开始,也不能以下划线或美元符号结束。反例: _name / __name / $Object / name_ / name$ / Object$ 2...
  • Mary881225
  • Mary881225
  • 2017年04月14日 16:44
  • 2394

Java中的类、方法、属性的命名规则

在面向对象编程中,对于类,对象,方法,变量等方面的命名是非常有技巧的。比如,大小写的区分,使用不同字母开头等等。但究其本,追其源,在为一个资源其名称的时候,应该本着描述性以及唯一性这两大特征来命名,才...
  • u010867294
  • u010867294
  • 2015年07月08日 11:06
  • 12563

单元测试规范

单元测试规范
  • iprettydeveloper
  • iprettydeveloper
  • 2017年02月15日 11:13
  • 1119

java工程中文件命名(PO/POJO/VO/BO/DAO/DTO)

作为测试研发进阶的初级菜鸟,最近看公司研发写的工程代码,有些规则的命名,然不知道具体意义。以下内容来自网络。   PO(persistant object)持久对象 在o/r映射的时候出现的概念...
  • windanchaos
  • windanchaos
  • 2017年01月12日 13:45
  • 1874

C++、Java与C#的命名规范总结

在编写代码的过程中所采用的命名方式经常变动,没有形成固定的风格。因此,根据从网上收集到的一些资料以及自身的一些经验,对C++、Java以及C#的命名规范进行了总结,方便以后查询。命名规范的原则: ...
  • javaniuniu
  • javaniuniu
  • 2017年07月08日 13:25
  • 215
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Java命名规范:注重细节
举报原因:
原因补充:

(最多只允许输入30个字)