1.在类定义前给出注释,用来描述程序员应如何理解类的数据与方法。
2.类中所有 的实例变量都应为私有的。
3.提供公共的访问方法和设置方法,以读取和修改对象中的数据。还要为程序员操作类的数据扬需要的基本操作提供公共方法。
4.在每个公共方法的头信息前给出注释,完整说明如何使用该方法。
5.辅助方法应为私有的。
6.类定义中的一部分注释是用户接口的组成部分,用于描述如何使用该类。这些注释通常在类定义前描述总体属性或者在特定方法前解释如何使用该方法。
用“/* */”做用户接口注释,而用“//”做实现注释。