内容摘自:
http://sunxboy.iteye.com/blog/283580精典的一句话:
不要 Copy-Paste 你的代码。
当你 Copy-Paste 代码的时候,说明代码中存在重复,重复的代码往往导致代码难以维护和阅读。一旦那些保存在剪切板中的代码中存在错误,编写者甚至不知道到哪里修改这些错误。每当你 Copy-Paste 代码的时候,请停下来,考虑将这些代码提取为方法、类或者组件。
当测试、注释、文档都失去作用的时候,不要忘记,我们还有逻辑,还有代码!代码之前了无秘密。优质的代码是说明应用程序的最根本的方式,是程序员沟通的通用语言。
所以,请认真的编写每一行代码!
● 时刻考虑你所编写的每一行代码、代码中的每一个单词都会在将来某个时候被你的伙伴们阅读、测试和维护。这是一个原则,也是一个前提,是每一个程序员所必须具备的基本素质。在一个团队中,编写可以阅读和维护的代码是团队合作的前提条件。
● 必须认真的慎重的为你的变量、函数(方法)、类命名。要起一个科学合理的名字,因为名字是理解代码的重要依据。同时,一旦代码发布,其依赖者、继承者都要永远维持这种命名。想像一下,如果你和你的同事不得不使用类似“ tj ”这样的名字,而又不能改变现状(会影响其他使用者),那该是一件多么痛苦的事情。
● 为你的代码编写注释。注释是代码的重要组成部分,同时也是别人理解你代码的重要依据,无论任务多么繁重,时间多么紧张,都应该象对待代码一样对待你的注释。哦,还有,最重要的是维护你的代码的同时要维护注释,就像下面一条所说的:
● 请确保注释是有效的。无效的,甚至是错误的注释还不如不写注释,这是显而易见的。注释应该言简意赅,不要用注释重复你的代码,也不要用注释阐述代码中显而易见的逻辑。请原谅我的啰嗦——在维护代码的同时不要忘记维护注释。
● 空行、空格也是代码。空行是一个逻辑段起止的标志,它和编程者的思路是一致的。另外,适当的使用空行和空格可以使你的代码更加清晰。
● 不要耍小聪明。只要有可能,请尽量使用平实的思路来规划你的代码。我们都知道,阅读别人的代码往往比自己编写同样功能的代码要困难,因为阅读代码的过程就是读懂对方思想的过程。困难的原因之一是作者的水平比读者要高——这当然是读者所欢迎的;但是,也可能是因为作者使用了晦涩难懂的思路和技巧,这些技巧五花八门无法列举,下面是常见的几种情况:
1) 过度的使用了设计模式。
这是设计模式初学者经常犯的错误,设计模式是面向对象思想的精华,但是对于经验较少的程序员来说,设计模式是抽象的和复杂的,过多的使用设计模式,会使得代码结构复杂难以理解。
2) 拼凑结果。
例如,某个复杂的函数返回的值总是比预期结果少 1 ,有些程序员会采用 +1 的方式使结果正确。这类做法往往使得代码逻辑混乱莫名其妙,更为严重的是,类似的方法很冗余导致程序中隐藏着错误。
3) 过度封装。
经常遇到的一种情况就是对第三方类库的进一步封装,这必须在有经验的设计者的指导下进行,因为类似的需求往往出现在各种架构级别的模块中。对第三方类库的不合理封装会导致使用着对类库的使用产生异议,出现错误的用法等。
4) 拒绝使用成熟的第三方类库。
许多初级设计人员,往往喜欢自己编写框架级别的代码,例如,在 JavaEE 开发中自行设计 MVC 框架。这类做法在多数情况下都是错误的,因为成熟的产品比比皆是,这些产品都有广泛的用户群、详尽的文档、活跃的社区和大量的成熟案例。普通开发人员极少能够自行编写同样水准的代码,而且,即便写出来了谁又能够保证其他开发人员会使用并且喜欢使用呢。
5) 冒然采用新的技术。
程序员是思维活跃敢于尝试创新的人群,他们往往乐于使用新的技术和新的产品。但是,在使用这些产品之前请仔细考虑:“你了解它吗 ? ”。冒然在团队中应用新技术是一种非常不负责任的行为,学习曲线、隐藏 BUG 、适用范围等等会成为应用新技术的障碍,严重的情况下一个类似的决策会导致整个项目的失败。
分享到:
相关推荐
综上所述,《PowerBuilder 9.0 Web开发篇》不仅全面覆盖了PowerBuilder 9.0在Web开发方面的所有关键技术,还包括了大量实例和源代码,这些都是为了帮助读者加深理解,提高实践操作能力。书中内容深入浅出,理论结合...
《黑客攻防技术宝典:Web实战篇(第2版)》是一本专注于Web应用程序安全的实战指南,由Dafydd Stuttard和Marcus Pinto撰写,由石华耀和傅志红翻译。该书深入浅出地探讨了Web应用程序的安全风险和攻防策略,适合网络...
第4~6章则介绍常见漏洞的审计方法,分别对应基础篇、进阶篇以及深入篇,涵盖SQL注入漏洞、XSS漏洞、文件操作漏洞、代码/命令执行漏洞、变量覆盖漏洞以及逻辑处理等漏洞;第7章介绍二次漏洞的挖掘方法;第8章介绍...
本篇将详细讲解如何在ARM架构上配置AppWeb以及相关的源代码分析。 **一、ARM架构配置** 1. **环境准备**:首先,确保你的开发环境支持ARM架构,这通常意味着你需要一个交叉编译工具链,如arm-linux-gnueabi-gcc或...
在“Web基础设计-教务处代码篇”中,我们主要关注的是两个核心技术:ASP(Active Server Pages)和MySQL数据库。ASP是微软推出的一种服务器端脚本环境,主要用于创建动态交互式的网页,而MySQL则是一种广泛使用的...
Java代码审计(入门篇) 本书《Java代码审计(入门篇)》是一本系统、全面、实战的Java代码审计入门图书,旨在帮助Java开发人员快速掌握Java代码安全审计技巧。全书从浅入深地介绍了Java代码审计的流程、Java Web...
本篇文章将探讨30种常用的Web开发代码片段,帮助开发者提高效率和提升用户体验。 1. **打开新窗口并传送参数**: 当需要在新窗口中打开一个页面并传递参数时,可以使用`window.open()`函数。例如,通过`Response....
《黑客攻防技术宝典Web实战篇》是一本详细探索和研究Web应用程序安全缺陷的实践指南,由英国的Dafydd Stuttard和Marcus Pinto撰写,石华焰等翻译。本书旨在为Web应用程序渗透测试员及开发和管理人员提供实用的知识和...
本篇文章将通过一个具体的Web页面示例来解析如何使用JavaScript实现网页背景颜色的动态变换。此功能主要涉及以下知识点: - **HTML基本结构**:理解HTML文档的基本构成元素。 - **JavaScript基本语法**:了解变量...
总之,《实战Delphi6.Kylix2.SOAP.Web Service程序设计篇》是一本对于想要学习如何使用Delphi和Kylix开发Web Service的开发者非常有价值的资源,配合提供的源代码,读者可以在实践中掌握SOAP通信和Web Service开发的...
本篇文章将深入探讨“Web架构代码”所涉及的核心概念,特别是与MySQL数据库相关的部分。 首先,我们要了解Web架构的三大支柱:前端、后端和数据库。前端是用户直接接触的部分,通常由HTML、CSS和JavaScript组成,...
本篇文章将详细介绍如何利用Web Service实现这一转换过程。 首先,我们需要理解Web Service的基本概念。Web Service是一种基于互联网的、平台无关的应用程序接口,它通过标准的XML(如SOAP)进行通信,允许不同系统...
这篇“给宝贝的web道歉信”就是一个很好的例子,它利用HTML(HyperText Markup Language)这一基础网页设计语言,来构建了一个充满诚意的道歉页面。HTML是构建网页结构的基础,通过标签、属性和内容来定义网页元素,...
这个教程"delphi 6/Kylik2 soap/Web Service程序设计篇下册+代码"将深入探讨如何使用这些工具来构建和消费Web Service。 1. **SOAP组件和协议**: Delphi 6的Soap Toolkit提供了对SOAP的支持,包括TSoapServer和...
Java Web整合开发王者归来(共4部分含源代码) 并且源代码比光碟中的新,光盘中的代码有部分不全,有两个项目没有,现已打上补丁。 PDF文件解压缩后324M,源代码压缩文件65.5M 内容简介 参考:...
本篇文章将对一份名为“WEB播放器代码”的文档进行详细解析,这份文档包含了构建一个简单WEB播放器的基本代码片段。 #### 二、代码结构分析 1. **JSP页面声明**: - `*" pageEncoding="utf-8"%>`:这行代码是JSP...
本项目着重讨论如何使用JSP和开源库来创建基于Web的动态图表,提供了丰富的源代码示例。 首先,我们要关注的是JFreeChart,这是一个强大的Java图表库,可以生成多种类型的图表,如饼图、条形图、线图等。在这个...
Java Web整合开发王者归来(共4部分含源代码) 并且源代码比光碟中的新,光盘中的代码有部分不全,有两个项目没有,现已打上补丁。 PDF文件解压缩后324M,源代码压缩文件65.5M 内容简介 参考:...
这个系列包含了十个部分的源代码,为学习者提供了丰富的实践素材,帮助深入理解Web应用的开发技术。下面将详细阐述其中的关键知识点。 1. **C#语言基础**:C#是.NET框架的核心编程语言,用于开发Web应用程序。它...