java中自造类是什么意思,Java编码规范,让你的代码赏心悦目--有意义的命名

名副其实

变量,函数,类的命名应该告诉我们它做什么事。如果需要注释来补充,就不算是名副其实。

int d;//消逝的时间,以日计。名称d什么也没说明,要靠注释说明自身

来看几个更好的例子:

int elapsedTimeInDays;

int daysSinceCreation;

int daysSinceModification;

int fileAgeInDays;

避免误导

避免使用与本意相悖的词。

hp,aix,sco都不该做变量名,因为它们都是UNIX平台的专有名称

别用accountList来代表一组账号,除非它真的是List类型。

如果这个变量的类型容器并非是List,那么使用accountGroup或bunchOfAccounts,或者直接使用accounts都会好一些

提防使用不同之处较小的名称。

XYZControllerForEfficienHandlingOfStrings与

XYZControllerForEfficientStorageOfStrings实在是太相似了

用小写字母"l"和大写字母"O"作为变量名。它们太像零和壹了

做有意义的区分

函数中的参数命名也应该具有意义

d6514378f6fa66fce744a3d7b6f64158.png

a1与a2替换为source和destination会更好一些

废话是另一种没意义的区分

Product类,还有一个ProductInfo类或ProductData类。名称虽然不同,意思却无区别。Info和Data就像a,an和the一样

Variable一词不要出现在变量名中。Table一词不应出现在表中。NameString会比Name好吗?难道它会是一个浮点数?

区分名称要以鉴别不同之处的方式来区分。

使用读得出来的名称

不要使用自造词

使用可搜索的名称

单字母名称和数字常量在搜索的时候很麻烦。因为它们很可能是某些文件名或其他常量的一部分。

单字母名称仅用于段方法中的本地变量;若变量或常量可能在代码中多处使用,则应赋其以便于搜索的名称;

避免使用编码

不要将类型或作用域编进名称里面;不要使用类似"m_"这样的前缀来表明成员变量。应当把类和函数做得足够小,消除对成员前缀的需要;在接口前加"I"意义不大,因为我们展示给用户的基本是接口的实现。在实现后加类似"Impl"这种反而会好一点;

类名

类名和对象名应该是名词或名词短语,不应当是动词;

正确:Customer,WikiPage

错误:Manager,Processor

方法名

方法名应当是动词或动词短语

正确:postPayment,deletePage

属性访问器,修改器和断言应该根据其值命名,并根据JavaBean加上get,set和is前缀

每个概念对应一个词

给每个抽象概念选一个词,并且一以贯之;

使用fetch,retrieve和get来给在多个类中的同种方法命名

使用解决方案领域名称

只有程序员才会读你的代码,尽管使用那些计算机科学术语,算法名之类的吧;如果不能使用程序员熟悉的术语来给手头的工作命名,就采用从所涉问题领域而来的名称;

添加有意义的语境

很少有名称是能自我说明的;

firstName,lastName,street,houseNumber,city,state,zipcode它们放一块,就构成了一个地址

但是如果在某个方法中孤零零一个state变量呢?

可以添加addrFirstName,addrLastName,addrState以此提供语境。更好的方案是创建名为Address的类

不要添加没用的语境

对于Address类的实体来说,accountAddress和customerAddress都很不错,但用在类名上不太好;Address是个好类名,如果需要与MAC地址,端口地址和Web地址相去呗,我会考虑使用PostalAddress,MAC和URI。这样名称更为精确;

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值