Java javapractices (1) - Avoid basic style errors

Common Practices

很多新手都会犯同样的风格错误，这样的风格错误不会使程序运行有问题，但是会使你的代码不好维护。从本质上来说，新手代码都不太具有可读性。

下面是一些常见的基本风格错误:

• 类名太长
• 类方法名太长
• 很少或没有文档(javadoc)
• 名称上无法区分局部变量(local variables),参数(arguments), 成员变量(fields)
• 许多空的catch块，把异常隐藏起来
• 不恰当的多处使用return语句
• 用异常来定义正常程序逻辑
• 过度使用instanceof
• 使用浮点数
• 喜欢arrays多过collections
• 不按访问权限(private,package-private, protected, public)来对成员分组

许多空的catch块，把异常隐藏起来是不好的习惯，一般情况下，如果有异常，可以把它丢给调用方caller, 或在catch块里捕获它，

当我们捕获它时，一般

• 通知用户(推荐)
• 打log,记下异常相关信息
• 发送一封邮件给相关人administator描述这个问题

过度使用instanceof
"Anytime you find yourself writing code of the form "if the object is of type T1, then do something, but if it's of type T2, then do something else," slap yourself.
用override的方式吧。目前常见的一个例外就是在equals方法来会用到instanceof

在科学或工作领域之外，避免使用float,double，这两者有精度问题，可以使用BigDecimal来取代

不按访问权限(private,package-private, protected, public)来对成员分组:
常见的有两种风格:
1. Private-first分格

• Oracle的风格
• Java程序员中比较流行
• emphasizes implementation details over exported API.

2. public-first style(largest-scope-first)

• 如果是注重是要说明对外暴露的方法，这种分格比较合适
• c++程序员风格