`
TonySun3544
  • 浏览: 161610 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

JAVA代码规范那些事

阅读更多

 

Java开发中所要遵守的编码规范大体上有如下7点。命名规范、注释规范、缩进排版规范、文件名规范、声明规范、语句规范以及编程规范。


1.命名规范

(1)所有的标示符都只能用ASCⅡ字母(A-Z或a-z)、数字(0-9)和下划线“_”。

(2)一个唯一包名的前缀总是全部小写的字母。例如:www.tonysun.cc

(3)类名是一个名词,采用大小写混合的方式,每个单词的首字母大写。例如:Tony。

(4)接口的大小写规则与类名相似:例如:Tony。

(5)方法名是一个动词或动词词组,采用大小写混合的方式,第一个单词的首字母小写,其后单词的首字母大写。例如:setNeekeName(String neekeName)。

(6)变量名第一个字母小写,任何中间单词的首字母大写。变量名应简短且可以顾名思义,易于记忆。例如:neekeName、neekeAddress。避免单个字符的变量名,除非是一次性的临时变量。

(7)常量的声明应该全部大写,每个单词之间用“_”连接。例如:final String WWW_TONY_CN = "www.tonysun.cc";

 

2.注释规范

(1)注释尽可能使用“//”;对于所有的javadoc的注释则使用“/**  */”;而临时对代码块进行注释尽量使用“/*  */”。

(2)所有的源文件都应该在开头有一个注释,其中列出文件名、日期和类的功能概述。

(3)每个方法必须添加文档注释(类的main()方法除外)。

(4)每个属性必须添加注释。

(5)代码中至少包含15%的注释。

(6)注释使用中文。

 

3.缩进排版规范

(1)避免一行的长度超过60个字符。

(2)使用Eclipse的源代码的格式化功能完成代码的缩进排版(Ctrl+Shift+F)。

4.文件名规范

(1)一个Java源文件只能存储一个Java类。

(2)文件名与Java类名相同。

(3)一个类文件的代码行不超过200行。

 

5.声明规范

(1)一行声明一个变量。

(2)不要将不同类型变量的声明放在同一行。

(3)只在代码块的开始处声明变量。

(4)所有的变量必须在声明时初始化。

(5)避免声明的局部变量覆盖上一级声明的变量。

(6)方法与方法之间以空行分隔。

 

6.语句规范

(1)每行至少包含一条简单语句。

(2)在return语句中,返回值不使用小括号“()”括起来。

(3)if语句总是用“{”和“}”括起来。

(4)在for语句的初始化或更新子句中,避免因使用三个以上变量,而导致复杂度提高。

(5)当switch的一个case顺着往下执行时(因为没有break语句),通常应在break语句的位置添加注释。

 

7.编程规范

(1)提供对实例以及类变量的public或private访问控制,尽可能不适用默认值或protected访问控制。

(2)避免用一个对象访问一个类的静态变量或方法。应该用类名代替。

(3)避免在一个语句中给多个变量赋相同的值。

(4)用switch()语句实现多路分支。

(5)如果使用JDBC,则考虑使用java.sql.PreparedStatement,而不是java.sql.Statement。

(6)用于设置对象状态的方法前缀必须是set;用于检索一个布尔类型对象状态的方法前缀必须是is,而用于检索其他方法前缀必须是get。

(7)程序中应尽可能少使用数字(或字符),尽可能定义静态变量来说明该数字(或字符)的含义。程序中需要赋值或比较时,使用前面定义的静态变量。在循环控制中例外。


 

分享到:
评论

相关推荐

    Java代码规范.pdf

    Java代码规范文档中涉及的知识点涵盖了Java编程实践中的命名风格和代码组织方式,旨在为Java开发人员提供一份行业内部开发的准则,确保代码的可读性、一致性和维护性。以下是从提供的文档内容中提炼出的相关知识点:...

    java代码规范示例

    "java代码规范示例" Java 代码规范示例中,涵盖了 Java 项目中包、类、方法、注释等多个方面的规范。 首先,从文件头的注释部分可以看到,这个 Java 文件是一个 FTP 帮助类,负责实现 FTP 的上传和下载功能。这个...

    JAVA代码规范.docx

    JAVA代码规范.docxJAVA代码规范.docxJAVA代码规范.docxJAVA代码规范.docx

    阿里巴巴Java代码规范PDF.zip

    《阿里巴巴Java代码规范》是Java开发者们遵循的一套专业编程指南,旨在提高代码质量、可读性和维护性。这份规范由阿里巴巴集团内部的专家团队制定,经过多年的实践和完善,已经成为业界广泛参考的标准之一。以下是对...

    JAVA代码规范及快捷键优化.docx

    JAVA代码规范及快捷键优化 在软件开发过程中,代码规范和快捷键优化是非常重要的两个方面。以下是关于JAVA代码规范和快捷键优化的知识点总结: 一、JAVA代码规范 1. 空格规范:在编写JAVA代码时,需要遵守统一的...

    Java代码规范2020.docx

    Java 代码规范指南 Java 代码规范是 Java 开发中极其重要的一部分,对于编写高质量、易维护的代码至关重要。在本指南中,我们将详细介绍 Java 代码规范的各个方面,包括命名规范、注释规范、代码格式、开发建议和...

    JAVA代码规范 JAVA规范 代码规范

    Java代码规范是编程实践中至关重要的一个方面,它旨在确保代码的质量、可读性和维护性。以下是一些核心的Java代码规范要点: 1. **命名规范**: - 类名使用大驼峰命名法,所有单词首字母大写,例如`ClassName`。 ...

    代码规范.rar 阿里巴巴java代码规范

    **阿里巴巴Java代码规范** 在软件开发领域,代码规范起着至关重要的作用,它不仅可以提高代码的可读性和可维护性,还能确保团队之间的代码风格一致性,从而提升开发效率。阿里巴巴作为国内知名的互联网企业,有着...

    通过java代码规范来优化程序

    通过java代码规范来优化程序

    java代码规范——很经典的一本书

    Java代码规范是编程界的一本重要著作,它旨在提高代码质量、增强可读性和可维护性,从而使得软件开发团队能够更加高效地协作。这本书详细阐述了如何编写整洁、一致且易于理解的Java代码,是Java开发者提升编码技能的...

    Java代码规范文档

    Java代码规范是为了保证代码的可读性、可维护性和团队协作的一致性。这份规范文档是基于SUN的标准Java代码规范,并结合了Google编码规范以及个人所在公司的具体需求。以下是一些关键点的详细说明: 1. **标识符命名...

    文档java代码规范

    Java代码规范是编程实践中至关重要的一个方面,它不仅关乎代码的可读性和可维护性,还直接影响团队协作的效率和软件质量。以下是对标题和描述中提到的Java代码规范的详细说明: ### 命名规范 命名规范是Java代码...

    检查代码规范插件 检查代码规范插件

    Checkstyle是最为流行的Java代码规范检查工具之一,它可以自定义一套规则集来检查代码。开发者可以根据开源社区提供的默认配置,或者根据团队内部的编码规范定制自己的规则。Checkstyle通过在构建过程或IDE中运行,...

    Java代码规范-Android版

    Java代码规范针对Android开发的规定相当细致,涉及到代码排版、注释、标识符命名以及代码的可读性等方面,旨在确保代码的整洁性、一致性和可维护性。以下是根据给定文件信息,详细解读的Java代码规范知识点。 首先...

    阿里推的一个java代码规范插件

    阿里推的这个Java代码规范插件,名为P3C(Alibaba Java Coding Guidelines Plug-in),是基于Eclipse和IntelliJ IDEA开发的,旨在帮助开发者遵循阿里巴巴内部制定的一套严谨的Java编程规范。该规范旨在提升代码质量...

    JAVA代码规范详细版.doc

    Java代码规范是编程实践中至关重要的指导原则,旨在提高代码的可读性、可维护性和团队协作效率。SUN公司的Java代码规范是业界广泛接受的基础,而文档中的公司代码规范在此基础上进行了适应性的调整。 首先,关于...

    java案例代码规范

    Java代码规范是编程实践中非常重要的一个方面,它不仅有助于提高代码的可读性和可维护性,还能提升团队协作效率。以下是一些关于Java代码规范的关键点: 1. **版权信息**:每个Java文件的开头都应该包含版权信息,...

    java代码规范

    Java代码规范是编程实践中至关重要的一个方面,它不仅有助于提高代码的可读性和可维护性,还能提升团队协作效率。以下是对"java代码规范"这一主题的详细解释: 1. **命名规范**: - 类名:使用驼峰式命名,首字母...

Global site tag (gtag.js) - Google Analytics