Java编程规范:日语版

需积分: 10 1 下载量 75 浏览量 更新于2024-07-28 收藏 171KB PDF 举报
"该资源是一份日语版的Java编程标准文档,由Eiwa System Management公司的Object Club Kenji Hiranabe编著。文档详细规定了Java编程中的各种规范,包括文件命名、类和接口命名、方法命名等方面,旨在提高代码质量和可读性。文档允许自由复制、修改和分发,鼓励在项目中根据需要进行定制,但保留了原始的版权信息。" 在Java编程中,遵循一定的编码标准是至关重要的,因为它可以提高代码的一致性、可读性和可维护性。这份日语Java编程标准文档涵盖了以下几个主要方面: 1. **方针**: 文档的方针可能是确保代码的清晰性、可读性和可维护性,强调了在团队开发中统一编码风格的重要性。 2. **文件构成**: - **文件名**:可能规定了文件命名的规则,如使用有意义的、驼峰式命名,以及特定后缀(如.java)。 - **文件位置**:指定了源代码文件应如何组织在目录结构中,以保持项目的整洁。 - **测试类名**:可能要求测试类名与被测试类名有特定的关联,如加前缀"Test"。 - **测试类的位置**:规定了测试类应放在何处,如与被测试类在同一目录或特定的测试目录下。 3. **命名规则**: - **包名**:通常建议使用逆域名形式,如com.example.myproject。 - **文件名**:应与其中包含的主类名一致,并遵循驼峰式命名。 - **类名**:通常使用首字母大写的驼峰式命名,表示实体或概念。 - **异常类名**:可能要求以"Exception"结尾,表明其是异常类。 - **接口名**:通常使用全大写字母的驼峰式命名,表示契约或行为。 - **实现类名**:与接口名相关联,可能要求加上实现前缀,如"Impl"。 - **抽象类名**:可能以"Abstract"开头,表明其为抽象类。 - **静态常量**:使用全大写字母,单词间用下划线分隔,如MY_CONSTANT。 - **方法名**:使用动词开头,遵循驼峰式命名,描述方法的行为。 - **工厂方法**:用于创建对象,名称可能表明其返回的对象类型。 - **转换方法**:用于将对象转换为其他类型,名称可能包含"to"。 - **获取器和设置器**:getter和setter方法应反映属性的名称,如getAge和setAge。 这些规范不仅适用于对日开发,而且对于任何Java开发者来说都是通用的最佳实践。通过遵循这些标准,开发者可以更容易地理解和协作,从而提高开发效率和软件质量。同时,对于初学者来说,了解并遵守这样的编码标准是学习Java编程的重要步骤。
2011-05-10 上传
目 次 前言 ..............................................................................................................................................................3 1 范围 11 2 规范性引用文件 11 3 术语和定义 11 4 排版规范 12 4.1 规则 12 1.*程序块要采用缩进风格编写,缩进的空格数为4个。 12 2.*分界符(如大括号‘{’和‘}’)应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体的开始、类和接口的定义、以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。 12 3.*较长的语句、表达式或参数(>80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。 13 4.*不允许把多个短语句写在一行中,即一行只写一条语句 13 5.*if, for, do, while, case, switch, default 等语句自占一行,且if, for, do, while等语句的执行语句无论多少都要加括号{}。 13 6.*相对独立的程序块之间、变量说明之后必须加空行。 13 7.*对齐只使用空格键,不使用TAB键。 14 8.*在两个以上的关键字、变量、常量进行对等操作时,它们之间的操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如.),后不应加空格。 14 4.2 建议 15 1.类属性和类方法不要交叉放置,不同存取范围的属性或者方法也尽量不要交叉放置。 15 5 注释规范 16 5.1 规则 16 1.一般情况下,源程序有效注释量必须在30%以上。 16 ......