【老九学堂】【Java】初级编码规范

良好的编码规范和习惯会让你的代码锦上添花，同时也会大大的增加团队协作开发的效率，避免很多细节的问题，从而大大的提高你的代码的可阅读性，同时也是一个优秀开发者的必备技能之一，所以接下来，我们就一起来了解并掌握一些常见的编码规范吧。

一、命名规范：

类名的首字母必须大写。
所有成员变量、方法命名时，必须遵守骆驼命名法。
【PS：骆驼式命名法就是当变量名或函式名是由一个或多个单词连结在一起，而构成的唯一识别字时，第一个单词以小写字母开始；第二个单词的首字母大写或每一个单词的首字母都采用大写字母，例如：myFirstName、myLastName，这样的变量名看上去就像骆驼峰一样此起彼伏，故得名——骆驼命名法，也叫驼峰命名】

范例：

openAccount();save();
getFirstName();isAtEnd();

一般运算符两边都必须有空格+、-、*、/、%、=、<、>、!=、<=、>= 两边空格，如：

String name = “zn”;
2 – 1; 2 + 1; 2 * 1; 2 / 1; 2 % 1; 2 > 1;
2 > 1; 2 != 1; 2 <= 1; 2 >= 1;

一元运算可以除外，比如：i++; i–; ++i; --i;
书写{ }采用如下格式：

public interface Interface {public void showMessage() {}
}

抽象类以Abstract开头；

public class AbstractCollection

接口的实现使用Impl结尾；

public class IteratorImpl implements Iterator

静态不可变的变量全部使用大写，并且单词之间用_进行分隔：如

public static final int MAX_VALUE = 5;

包名由小写字母和少量数字组成，包名统一用代表模块贴切含义的英文单词或缩写；
例如老九学堂的项目是这样命名的：
包名一级为com;
包名二级为xuetang9;
包名三级为班级编号，prot001;
包名四级为小组名，如crazy;
包名五级按功能模块划分等，如oofood；
所以包名为：com.xuetang9.prot001.crazy.oofood

二、注释要求

注释是帮助程序读者的一种手段在编码的过程中必须随时加注释，不能过后补齐。通过注释描述当时的思路，以及悬而未决的问题；提高程序的可读性，规范性，维护性。提供使用说明、及配置信息。
1.每行注释不超过40个中文字；
2.每个类、接口的开头必须多行的详细的功能说明，使用中文注释，包括作者、版本、创建时间等等；
3.每個方法前面都必須使用Javadoc的中文注释，必须说明该方法的作用与目的；
4.每个成员变量必须有单行中文注释，必须说明该成员变量的作用与目的。

类注释

/*** 作者：窖头
* 功能：现存量业务逻辑
* 日期：2017-06-01
*/

方法注释

方法头注释必须包括：方法执行了什么功能，为什么要这样处理；方法处理过程中对对象的那些属性可能进行更改；方法执行前后，对象的状态。

1.比较、循环等控制结构必须加注释；
2.在代码的功能并非一目了然的情况下，应当说明为什么要这样做；
3.局部变量必须加注释；
4.复杂难写的代码必须加注释；
5.如果一系列代码的前后执行顺序有要求，必须注释说明方法开头需要的注释内容：作者、功能、参数说明、返回值、例外、日期、修改日期，修改人，修改原因。举例：

/*** 作者：窖头
* 功能：查询现存量
* 参数： voCond：查询条件VO     voAstCond：附加条件VO
* 返回：ResultVO：查询结果
* 例外：DatabaseException
* 日期：2017-06-01
* 修改日期，修改人，修改原因，注释标志：
* 2017-06-16,李四，提高效率，lisi_start/lisi_end
* 2017-07-16,王五，提高效率，wangwu_start/wangwu_end
*/

变量注释

要求注释所有的变量（域）。如下所示：

/** 标题 */
private String title = null;
/** 订单VO */
private PurchaseBillVO purchaseBillVO = null;
如果该注释不用来生成javadoc文件：也可以采用以下形式：
//标题
private String title = null;
//订单VO
private PurchaseBillVO purchaseBillVO = null;

安装遇到问题，可加老九君个人QQ：614940318，请备注来自CSDN
老九学堂免费C、C++、Java课程地址： https://study.163.com/courses-search?keyword=老九学堂

【老九学堂】【Java】初级编码规范相关推荐

华为java安全编码规范_Java安全编码之SQL注入
随着互联网的发展,Java语言在金融服务业.电子商务.大数据技术等方面的应用极其广泛.Java安全编码规范早已成为SDL中不可或缺的一部分.本文以Java项目广泛采用的两个框架Hibernate和My ...
Java语言编码规范（1）
Java语言编码规范原文出处http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html 2 文件名(File Names) 这部分列出了常 ...
java安全编码规范考试
java安全编码规范考试整理不易,收点币!! 安全编码规范考试.md 下面对zip文件的安全解压缩描述,错误的是 A.zip文件解压时,可以使用entry.getSize()对解 ...
Java入门编码规范之小白崛起
IT小生浅谈阿里编码规范.spring boot后端注意事项及前端编码规范. JAVA编码规范摘要无规矩不成方圆无规范不能协作 Java代码规范能够给业界带来一个标准,促使整体行业代码规范水平得到 ...
Java语言编码规范
目录1 介绍 1.1 为什么要有编码规范 1.2 版权声明 2 文件名 2.1 文件后缀 2.2 常用文件名 3 文件组织 3.1 Java源文件 3.1.1 开头注释 3.1.2 包和引入语句 3. ...
java SSH编码规范
Java部分所有的程序开发手册都包含了各种规则.一些习惯自由程序人员可能对这些规则很不适应,但是在多个开发人员共同写作的情况下,这些规则是必需的.这不仅仅是为了开发效率来考虑,而且也是为了后期维护考 ...
Java语言编码规范(Java Code Conventions)
1 介绍(Introduction) 1.1 为什么要有编码规范(Why Have Code Conventions) 编码规范对于程序员而言尤为重要,有以下几个原因: - 一个软件的生命周期中,80 ...
中科方德java开发编码规范_插件推荐：如何将Java编码规范落地实际开发中
一个软件需要花费80%的生命周期成本去维护. 几乎没有任何软件的整个生命周期仅由其原作者来维护. 编码规范改善软件的可读性,让工程师更快更彻底地理解新的代码. 如果你将源代码转变为一个产品,那么您需要 ...
JAVA安全编码规范
2019独角兽企业重金招聘Python工程师标准>>> 空串或空对象判断空字符串的判断一般都用StringUtils.isEmpty()方法,判断集合是否为空用Collection ...
Java开发编码规范
注:部分规范参考阿里巴巴代码规范,checkstyle等目录注:部分规范参考阿里巴巴代码规范,checkstyle等 1.命名风格 2.代码格式 3.代码注释 4.代码设计规范 5.异常的捕获 6 ...

【老九学堂】【Java】初级编码规范

【老九学堂】【Java】初级编码规范相关推荐

最新文章

热门文章