优秀Java程序员的编程风格,一文讲解优秀Java程序

今天突发奇想,对编码习惯和编程风格很感兴趣,于是乎,找了一下关于编程风格的资料,希望对爱好编码或者开始学习编码的同学有帮助!

来自《The Elements of Java Style》-《Java编程风格》一书,值得一读的书籍,会让你在细节上节省很多时间,合作之间更加愉快!

来自《The Elements of Java Style》-《Java编程风格》一书,值得一读的书籍,会让你在细节上节省很多时间,合作之间更加愉快!

好处不多说了,但是有几个原则如下:

好处不多说了,但是有几个原则如下:

1.保持原有风格

1.保持原有风格

2.坚持最小惊奇原则

2.坚持最小惊奇原则

3.第一次就做对

3.第一次就做对

4.记录所有非规范行为

4.记录所有非规范行为

格式规范:

1.缩进嵌套的代码:在每个代码块和嵌套中加入缩进,缩进代码,加强可读性。这些地方包括【类定义,内部类定义,方法定义,静态块,for循环语句,if-else语句,try、catch和finally块,匿名内部类,while语句,do-while语句】

1.缩进嵌套的代码:在每个代码块和嵌套中加入缩进,缩进代码,加强可读性。这些地方包括【类定义,内部类定义,方法定义,静态块,for循环语句,if-else语句,try、catch和finally块,匿名内部类,while语句,do-while语句】

2.断开很长的句子:第一,如果包含了逗号,那么在每一个逗号后面都另起一行,把逗号后面的每一个表达式都和逗号前面的表达式的第一个字母对齐。第二,应该在优先级最低的运算符之前断行。

2.断开很长的句子:第一,如果包含了逗号,那么在每一个逗号后面都另起一行,把逗号后面的每一个表达式都和逗号前面的表达式的第一个字母对齐。第二,应该在优先级最低的运算符之前断行。

3.使用空白:关键字和左括号之间,右括号和紧随其后的关键字,除了”.”之外的运算符与其前后的表达式之间用空格隔开。每个逻辑上独立的方法和代码段之间,定义类或者接口的成员之间,每个类和接口之间应该加入空白行。

3.使用空白:关键字和左括号之间,右括号和紧随其后的关键字,除了”.”之外的运算符与其前后的表达式之间用空格隔开。每个逻辑上独立的方法和代码段之间,定义类或者接口的成员之间,每个类和接口之间应该加入空白行。

4.不要直接使用Tab控制符:不同环境对Tab控制符的解释也是不同的。

4.不要直接使用Tab控制符:不同环境对Tab控制符的解释也是不同的。

1.名称应该具有实际意义

命名约定:

2.使用人们熟悉的名称

1.名称应该具有实际意义

3.谨慎使用过长的名字,可以使用简明通用的缩写

2.使用人们熟悉的名称

4.尽量保留元音字母

3.谨慎使用过长的名字,可以使用简明通用的缩写

5.缩写词的第一个字母大写

4.尽量保留元音字母

6.不要使用大小写来区分的名字

5.缩写词的第一个字母大写

1.用你所在组织的域名的倒序小写形式作为包的根限定词

6.不要使用大小写来区分的名字

2.使用单独的小写词作为每个包的根名

包命名:

3.仅当新旧版本二进制兼容的时候,其包可以使用相同的名字,否则,请使用新名字

1.用你所在组织的域名的倒序小写形式作为包的根限定词

1.类和接口名中的每个单词的第一个字母大写

2.使用单独的小写词作为每个包的根名

1.用名词命名类

3.仅当新旧版本二进制兼容的时候,其包可以使用相同的名字,否则,请使用新名字

2.具有成组相关属性,静态服务或者常量的类名字使用复数形式

类型命名:

1.用名词或者形容词命名接口

1.类和接口名中的每个单词的第一个字母大写

1.方法名中的第一个单词小写,其后每个单词的第一个字母大写

类命名:

2.用动词命名方法

1.用名词命名类

3.遵循JavaBean中命名属性访问函数方法:set,get,is

2.具有成组相关属性,静态服务或者常量的类名字使用复数形式

1.变量命中的第一个单词小写,其后的每个单词的第一个字母大写

接口命名:

2.用名词命名变量

1.用名词或者形容词命名接口

3.集合引用名要用复数形式

方法命名:

4.为不重要的临时变量简历并使用一套标准名字

1.方法名中的第一个单词小写,其后每个单词的第一个字母大写

1.使用this字段变量可以区分开局部变量

2.用动词命名方法

1.构造函数或者”set”方法给字段分配参数赋值,参数名应该和字段名相同

3.遵循JavaBean中命名属性访问函数方法:set,get,is

1.常量的每个单词均大写,单词之间使用下划线连接

变量命名:

1.为使用和维护你的代码的人编写文档

1.变量命中的第一个单词小写,其后的每个单词的第一个字母大写

2.注释和代码要同步

2.用名词命名变量

3.使用积极的语气,省略无用的词语

3.集合引用名要用复数形式

1.用文档注释来描述编程接口

4.为不重要的临时变量简历并使用一套标准名字

2.用标准注释格式隐藏代码而不必删除它们

字段命名:

3.用单行注释解释实现细节

1.使用this字段变量可以区分开局部变量

1.在编写代码前描述编程接口

参数命名:

2.为公用,受保护,包,私有成员建立文档

1.构造函数或者”set”方法给字段分配参数赋值,参数名应该和字段名相同

3.为每个包编写总结和概述

常量命名:

4.为包的每个应用程序或组编写概述

1.常量的每个单词均大写,单词之间使用下划线连接

1.对所有文档注释使用统一的格式和组织结构

文档约定:

2.关键字,标识符和常量应放到<code>…</code>标签中

1.为使用和维护你的代码的人编写文档

3.将代码放入<pre>…</pre>标签中

2.注释和代码要同步

4.在标识符第一次出现的时候用{@link}标签

3.使用积极的语气,省略无用的词语

5.为Javadoc标签简历并使用一套固定的顺序

注释类型:

6.使用第三人称叙述的形式

1.用文档注释来描述编程接口

7.编写独立的概述

2.用标准注释格式隐藏代码而不必删除它们

8.省略概述中动作和服务的主语

3.用单行注释解释实现细节

9.省略事物概述中的对象和动词

文档注释:

10.使用this而不是the来指代当前类中的实例

1.在编写代码前描述编程接口

11.方法名或者构造函数名不需圆括号,除非你想突出一个特殊的签名

2.为公用,受保护,包,私有成员建立文档

1.每个类、接口、字段和方法都编写概述

3.为每个包编写总结和概述

2.完整描述每个方法的签名

4.为包的每个应用程序或组编写概述

3.包含示例

注释风格:

4.为前置、后置、不变条件编写文档

1.对所有文档注释使用统一的格式和组织结构

5.为已知的缺陷和不足编写文档

2.关键字,标识符和常量应放到<code>…</code>标签中

6.为同步语法编写文档

3.将代码放入<pre>…</pre>标签中

1.仅添加有助于理解你的代码的内部注释

4.在标识符第一次出现的时候用{@link}标签

2.描写代码为什么这样做,而不是在做什么

5.为Javadoc标签简历并使用一套固定的顺序

3.避免使用行尾注释

6.使用第三人称叙述的形式

4.用行尾注释解释局部变量声明

7.编写独立的概述

5.建立并使用一套关键词来标识尚未解决的问题

8.省略概述中动作和服务的主语

6.在嵌套程度高的控制结构中标记出嵌套结束位置

9.省略事物概述中的对象和动词

7.如果两个case标记之间没有break语句,就在中间加入“fall-through”注释

10.使用this而不是the来指代当前类中的实例

8.标记空语句

11.方法名或者构造函数名不需圆括号,除非你想突出一个特殊的签名

1.将表示基础数据类型的类声明为final类型

注释内容:

2.通过本地类型和其他具体类型建立具体类型

1.每个类、接口、字段和方法都编写概述

3.定义小的类和小的方法

2.完整描述每个方法的签名

4.定义子类,以便任何使用超类的地方都可以使用子类

3.包含示例

5.使所有字段私有

4.为前置、后置、不变条件编写文档

6.使用多态来替代instanceof

5.为已知的缺陷和不足编写文档

1.以java.lang.Object包装通用类,提供静态类型检查

6.为同步语法编写文档

2.以类的形式封装枚举类型

内部注释:

3.尽量使用泛型

1.仅添加有助于理解你的代码的内部注释

1.用等价的方法替换重复的、复杂的表达式

2.描写代码为什么这样做,而不是在做什么

2.使用块语句代替控制流结构的表达式

3.避免使用行尾注释

3.使用括号明确操作顺序

4.用行尾注释解释局部变量声明

4.在switch语句中的最后一个case体使用break语句

5.建立并使用一套关键词来标识尚未解决的问题

5.使用equals(),而不是==来检测对象的对等关系

6.在嵌套程度高的控制结构中标记出嵌套结束位置

1.构造状态有效的对象

7.如果两个case标记之间没有break语句,就在中间加入“fall-through”注释

2.不要从构造函数中调用非final方法

8.标记空语句

3.用嵌套的构造函数消除冗余代码

编程约定:

1.使用不受检查、运行时的异常来报告可能在程序逻辑中出错的严重未查明错误

1.将表示基础数据类型的类声明为final类型

2.使用检查异常来报告可能发生,而在正常的程序运行时极少发生的错误

2.通过本地类型和其他具体类型建立具体类型

3.用返回代码报告可预知的状态改变

3.定义小的类和小的方法

4.仅转化异常来添加信息

4.定义子类,以便任何使用超类的地方都可以使用子类

5.不要私自处置运行时或者错误异常

5.使所有字段私有

6.用finally语句块释放资源

6.使用多态来替代instanceof

1.按照约定编程

类型安全:

2.用无用代码消除机制实现断言

1.以java.lang.Object包装通用类,提供静态类型检查

3.用断言捕捉代码中的逻辑错误

2.以类的形式封装枚举类型

4.用断言检测方法的前置条件和后置条件

3.尽量使用泛型

1.仅在适当的地方使用线程

语句和表达式:

1.避免同步

1.用等价的方法替换重复的、复杂的表达式

2.用同步的包装器,提供同步接口

2.使用块语句代替控制流结构的表达式

3.如果方法包含几个不需要同步的重要操作,那么不要同步整个方法

3.使用括号明确操作顺序

4.读写实例变量的时候避免不必要的同步

4.在switch语句中的最后一个case体使用break语句

5.使用notify()而不是notifyAll()

5.使用equals(),而不是==来检测对象的对等关系

6.为同步初始化使用双重检查模式

构造:

1.使用懒惰初始化

1.构造状态有效的对象

2.避免创建不必要的对象

2.不要从构造函数中调用非final方法

3.重新初始化并重新使用对象,尽量不要新建对象

3.用嵌套的构造函数消除冗余代码

4.把优化工作留在日后

异常处理:

1.将经常使用、更改、同时发布或者互相依存的类型,放在同一个包里

1.使用不受检查、运行时的异常来报告可能在程序逻辑中出错的严重未查明错误

2.共同封闭原则

2.使用检查异常来报告可能发生,而在正常的程序运行时极少发生的错误

3.重用/发布等价原则

3.用返回代码报告可预知的状态改变

4.无环依赖原则

4.仅转化异常来添加信息

5.将不稳定的类和接口隔离在单独的包中

5.不要私自处置运行时或者错误异常

6.易于修改的包不要依赖于难以修改的包

6.用finally语句块释放资源

7.最大化抽象最大化稳定性

断言:

8.将高层设计和架构作为稳定的抽象,组织为稳定的包

1.按照约定编程

以上仅是一些规则简单的罗列,推荐阅读此书。

2.用无用代码消除机制实现断言

Java高架构师、分布式架构、高可扩展、高性能、高并发、性能优化、Spring boot、Redis、ActiveMQ、Nginx、Mycat、Netty、Jvm大型分布式项目实战学习架构师视频免费获取架构群:854180697 加群链接

3.用断言捕捉代码中的逻辑错误

4.用断言检测方法的前置条件和后置条件

并发:

1.仅在适当的地方使用线程

同步:

1.避免同步

2.用同步的包装器,提供同步接口

3.如果方法包含几个不需要同步的重要操作,那么不要同步整个方法

4.读写实例变量的时候避免不必要的同步

5.使用notify()而不是notifyAll()

6.为同步初始化使用双重检查模式

效率:

1.使用懒惰初始化

2.避免创建不必要的对象

3.重新初始化并重新使用对象,尽量不要新建对象

4.把优化工作留在日后

打包约定:

1.将经常使用、更改、同时发布或者互相依存的类型,放在同一个包里

2.共同封闭原则

3.重用/发布等价原则

4.无环依赖原则

5.将不稳定的类和接口隔离在单独的包中

6.易于修改的包不要依赖于难以修改的包

7.最大化抽象最大化稳定性

8.将高层设计和架构作为稳定的抽象,组织为稳定的包

为了让学习变得轻松、高效,今天给大家免费分享一套Java教学资源。帮助大家在成为Java架构师的道路上披荆斩棘。需要资料的欢迎加入学习交流群:9285,05736

本文由365bet体育在线官网发布于网络编程,转载请注明出处:优秀Java程序员的编程风格,一文讲解优秀Java程序

TAG标签:
Ctrl+D 将本页面保存为书签,全面了解最新资讯,方便快捷。