摘要:最近在看一本有关编程规范的书,书中精炼阐述了使用语言时应该遵循的一些原则。所以拥有良好一致的编程规范对于一个团队至关重要。二坚持最小惊奇原则在编码过程中尽量避免可能让软件用户感到意外的做法。
最近在看一本有关Java编程规范的书,书中精炼阐述了使用java语言时应该遵循的一些原则。接下来的一段时间我将在这里总结我的学习内容,也希望这一系列文章能够对有需要的人有所帮助。
不考虑任何编码规范的代码往往存在很多Bug,严重情况下还会制约软件开发的进度。良好的编程规范不仅能使团队里的每个人都能轻松的阅读并理解其他人的代码、减少Bug的产生,而且让后期的维护工作更加行之有效,从而使代码更具准确性、健壮性、可维护性与可扩展性。所以拥有良好一致的编程规范对于一个团队至关重要。
一、一般原则在修改原有的软件时,应该保持原有代码的编写风格。
我们不应该在原有的代码中引入新的风格,在同一段代码中使用不同的编程风格会让我们的代码难以理解。同时我们也不应该重写旧的软件去迎合新的风格,这样很可能会使原来的程序产生严重的功能缺陷。
在编码过程中尽量避免可能让软件用户感到意外的做法。
用户在使用软件中产生的任何交互行为必须都是可预见的,除非在说明文档中明确记录下所有的非常规行为并且说明这样做的理由。为了达到这一目的,在Java软件的开发过程中应该遵循以下几点:
简单性:构建简单的类和方法。
清晰性:明确每个变量、类、接口、方法、对象的用途。
完整性:提供用户所期望的完整的程序功能,并且为此编写完整的说明文档。
一致性:相似的实体,其外观和行为也要大致相同;反之亦然。
健壮性:对错误和异常做出预测,并且在说明文档中提供相应的解决办法。
将以上的这些规则应用到我们编写的任何代码中,而不只是产品本身的代码。
通常情况下,那些原型代码最终都会被写入成品软件中。由于我们一开始就已经遵循了编码规范,所以我们不需要为特定的产品修改代码规范。那些阅读我们代码的人也会从中受益匪浅。
没有什么标准是完美且能够放之四海而皆准的,有时候你会发现自己不得不偏离已经建立好的标准体系。
标准并不是适用于任何地方,在打破一条规则之前,我们需要确保我们已经对这条准则有了深入的理解而且清楚打破规则后的后果。此外,我们应该在文档中记录下这样做的理由。
以上就是一般原则的内容,没有涉及具体的代码,但是我们在进行下面的学习或者编码之前应该对以上的内容有所理解。
文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。
转载请注明本文地址:https://www.ucloud.cn/yun/69886.html
摘要:此处指定的虚拟机与平台兼容,并支持语言规范中指定的编程语言。第章说明了虚拟机的指令集,按字母顺序显示操作码助记符。 介绍 一点历史 Java®编程语言是一种通用的、并发的、面向对象的语言,它的语法类似于C和C++,但它省略了许多使C和C++复杂、混乱和不安全的特性。最初开发Java平台是为了解决为联网的消费者设备构建软件的问题,它旨在支持多种主机架构,并允许安全交付软件组件,为了满足这...
摘要:大家好,我是乐字节的小乐,这次要给大家带来的是变量与数据类型。本文是第一集编程规范,关键字与标识符。后面我们要写一个程序的过程。需求分析实现代码体现注释的作用解释说明程序,提高了代码的阅读性。可以帮助我们调试程序。 大家好,我是乐字节的小乐,这次要给大家带来的是Java变量与数据类型。本文是第一集:Java编程规范,关键字与标识符。showImg(https://segmentfaul...
摘要:在上一篇的编程风格学习二中我们学习了一些在编码过程中的格式规范,遵循这些规范毋庸置疑是我们的书写高质量代码的前提与基础。二语言编程规范常量命名常量的每个单词均大写,单词之间使用下划线连接。方法表示动作,采用动词命名。 在上一篇的java编程风格学习(二)中我们学习了一些在Java编码过程中的格式规范,遵循这些规范毋庸置疑是我们的书写高质量代码的前提与基础。今天我们更进一步,一起来学习J...
摘要:二格式规范在上一篇的编程规范一中我们讲述了在编码中的一般原则,虽然这些原则并不涉及具体的代码规范,但是这些原则却是我们在开发过程中所应该遵循的规范与思想。不要把多个语句放在同一行里以免超过最大可接受宽度。 二、格式规范 在上一篇的java编程规范(一)中我们讲述了在Java编码中的一般原则,虽然这些原则并不涉及具体的代码规范,但是这些原则却是我们在Java开发过程中所应该遵循的规范与思...
摘要:对变量对象或者函数等进行命名时,选择能清晰表达其用途的名字。其实,测试方法名应该明确指出测试的内容与条件。和这种命名方式是时代的前朝遗物。使用自己的异常类型笔者又一次错误地认为这一开发习惯是业内的共识。 作为 Java 开发人员,我们会遵循一系列的编码风格和开发习惯。习惯使然是一方面,另一方面,我们也从不停下脚步质疑这些习惯。一段时间以后,笔者养成了一些不同于常人的编码风格和开发习惯。...
阅读 2803·2021-11-19 11:35
阅读 2581·2021-11-02 14:40
阅读 1396·2021-09-04 16:48
阅读 3008·2019-08-30 15:55
阅读 1752·2019-08-30 13:11
阅读 1955·2019-08-29 11:12
阅读 1088·2019-08-27 10:52
阅读 3157·2019-08-26 18:36