关闭 x
IT技术网
    技 采 号
    ITJS.cn - 技术改变世界
    • 实用工具
    • 菜鸟教程
    IT采购网 中国存储网 科技号 CIO智库

    IT技术网

    IT采购网
    • 首页
    • 行业资讯
    • 系统运维
      • 操作系统
        • Windows
        • Linux
        • Mac OS
      • 数据库
        • MySQL
        • Oracle
        • SQL Server
      • 网站建设
    • 人工智能
    • 半导体芯片
    • 笔记本电脑
    • 智能手机
    • 智能汽车
    • 编程语言
    IT技术网 - ITJS.CN
    首页 » JAVA »优秀Java程序员的编程风格

    优秀Java程序员的编程风格

    2014-11-29 00:00:00 出处:余晟的博客
    分享

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

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

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

    1.保持原有风格

    2.坚持最小惊奇原则

    3.第一次就做对

    4.记录所有非规范行为

    格式规范:

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

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

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

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

    命名约定:

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

    2.使用人们熟悉的名称

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

    4.尽量保留元音字母

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

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

    包命名:

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

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

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

    类型命名:

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

    类命名:

    1.用名词命名类

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

    接口命名:

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

    方法命名:

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

    2.用动词命名方法

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

    变量命名:

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

    2.用名词命名变量

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

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

    字段命名:

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

    参数命名:

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

    常量命名:

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

    文档约定:

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

    2.注释和代码要同步

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

    注释类型:

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

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

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

    文档注释:

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

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

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

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

    注释风格:

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

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

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

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

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

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

    7.编写独立的概述

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

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

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

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

    注释内容:

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

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

    3.包含示例

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

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

    6.为同步语法编写文档

    内部注释:

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

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

    3.避免使用行尾注释

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

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

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

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

    8.标记空语句

    编程约定:

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

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

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

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

    5.使所有字段私有

    6.使用多态来替代instanceof

    类型安全:

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

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

    3.尽量使用泛型

    语句和表达式:

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

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

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

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

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

    构造:

    1.构造状态有效的对象

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

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

    异常处理:

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

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

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

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

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

    6.用finally语句块释放资源

    断言:

    1.按照约定编程

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

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

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

    并发:

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

    同步:

    1.避免同步

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

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

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

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

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

    效率:

    1.使用懒惰初始化

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

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

    4.把优化工作留在日后

    打包约定:

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

    2.共同封闭原则

    3.重用/发布等价原则

    4.无环依赖原则

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

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

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

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

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

    上一篇返回首页 下一篇

    声明: 此文观点不代表本站立场;转载务必保留本文链接;版权疑问请联系我们。

    别人在看

    Destoon 模板存放规则及语法参考

    Destoon系统常量与变量

    Destoon系统目录文件结构说明

    Destoon 系统安装指南

    Destoon会员公司主页模板风格添加方法

    Destoon 二次开发入门

    Microsoft 将于 2026 年 10 月终止对 Windows 11 SE 的支持

    Windows 11 存储感知如何设置?了解Windows 11 存储感知开启的好处

    Windows 11 24H2 更新灾难:系统升级了,SSD固态盘不见了...

    小米路由器买哪款?Miwifi热门路由器型号对比分析

    IT头条

    Synology 对 Office 套件进行重大 AI 更新,增强私有云的生产力和安全性

    01:43

    StorONE 的高效平台将 Storage Guardian 数据中心占用空间减少 80%

    11:03

    年赚千亿的印度能源巨头Nayara 云服务瘫痪,被微软卡了一下脖子

    12:54

    国产6nm GPU新突破!砺算科技官宣:自研TrueGPU架构7月26日发布

    01:57

    公安部:我国在售汽车搭载的“智驾”系统都不具备“自动驾驶”功能

    02:03

    技术热点

    最全面的前端开发指南

    Windows7任务栏桌面下角的一些正在运行的图标不见了

    sql server快速删除记录方法

    SQL Server 7移动数据的6种方法

    SQL Server 2008的新压缩特性

    每个Java程序员必须知道的5个JVM命令行标志

      友情链接:
    • IT采购网
    • 科技号
    • 中国存储网
    • 存储网
    • 半导体联盟
    • 医疗软件网
    • 软件中国
    • ITbrand
    • 采购中国
    • CIO智库
    • 考研题库
    • 法务网
    • AI工具网
    • 电子芯片网
    • 安全库
    • 隐私保护
    • 版权申明
    • 联系我们
    IT技术网 版权所有 © 2020-2025,京ICP备14047533号-20,Power by OK设计网

    在上方输入关键词后,回车键 开始搜索。Esc键 取消该搜索窗口。