`
liwenshui322
  • 浏览: 519063 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

代码整洁之道读书笔记一

 
阅读更多

 

      同事推荐《代码整洁之道》这本书很不错,这几天仔细地阅读了一翻,感受颇深。在这里聊以记录,跟大家分享一下。

 

 

     第一章 整洁代码

     什么是整洁的代码,以下是各种经验丰富程序员的见解。

     1. 我喜欢优雅和高效的代码。代码逻辑应该直接了当,叫缺陷难以隐藏;尽量减少依赖关系,使之便于维护;依据某种分层战略完善错误处理代码;性能调至最优,省得引诱别人做没规矩的优化,搞出一堆混乱来。整洁的代码只做好一件事。 --C++语言发明者

 

      2. 整洁的代码简单直接,简洁的代码如同优美的散文。整洁的代码从不隐藏设计者的意图,充满了干净利落的抽象和直接了当的控制语句。--《面向对象分析与设计》作者

 

      3. 简洁的代码总是看起来像是某位特别在意它的人写的。几乎没有改进的余地。代码作者什么都想到了,如果你企图改进它,总是会回到原点。--《修改代码艺术》作者

 

      4. 如果每一个例程都让你感到深合已意,那就是简洁的代码。如果代码让编程语言看起来像是专门为解决那个问题而存在,就可以称之为漂亮的代码。--《极限编程》创始人之一

 

 

      第二章 有意义的命名

      1. 要名副其实,比如:int d; // 消逝的时间,以日计。 改为 int elapsedTimeInDays;

 

      2. 做有意义的区分,比如你有一个Product类,还有一个ProductInfo类。这两个类看不出有什么区别,应该避免。

 

      3. 类名应该是名词或者名词短语,比如Customer,WikiPage。避免使用Processor,Manager这样的类名。

 

      4. 方法名应该是动词或者动词短语,比如save,deletePage。

 

      5. 每个概念对应一个词,并且一以贯之。例如使用fetch,retrieve和get来给多个类的同种方法命名是不对的。我们要调用某一个类的获取方法的时候,不知道该调fetch方法,retrieve方法还是get方法。

 

      第三章 函数

      如何写好函数

     1. 函数的第一规则是要短小,第二规则是还要更短小。

建议if,else,while语句其中的代码只有一行,函数的缩进层次不应该多于一层或两层。

 

     2. 函数应该做一件事。做好这件事。只做这件事。如果函数只是做了该函数名下同一抽象层次上的步骤,则函数还是只做了一件事。编写函数是把大一些的概念拆分为另一抽象层次上的一系列步骤。

 

     3. 每个函数一个抽象层级,也就是逐个函数细化程序逻辑时,每一个函数做的多个事情的细化程度应该在一个层次上。

 

     4. 函数参数不要超过3个

 

     5. 输出参数不要使用,比如public void appendTitle(StringBuffer report);内部改变了report。

 

     6. 分隔指令与询问分开,比如:public boolean set(String attribute,String value) 该函数设置某个指定属性的值,如果成功返回true,如果不存在该属性返回false。其实应该改成

     if(attributeExists(attribute)) {

         setAttribute(attribute,value);

          .......

      }

 

      7. 抽离try/catch块

 

 public void delete(Page page) {
        try {
            
        } catch (Exception e) {
            logError(e);
        }
    }
    
    private void deletePageAndAllReferences(Page page) throws Excepiton {
        deletePage(page);
        registry.deleteReference(page.name);
        configKeys.deleteKey(page.name.makeKey());
    }
    
    private void logError(Exception e) {
        logger.log(e.getMessage());
    }

 

 

     8. 不要重复自己

 

     第六章 对象和数据结构

      1. 得墨忒耳律:模块不应了解它所操作对象的内部情形。这意味着对象不应通过存取器暴露其内部结构(比如get/set方法)比如:

 

String outPutDir = ctxt.getAbsolutePath();
String outFile = outputDir + "/" + className.replace('.','/') + ".class";
FileOutputStream fout = new FileOutputStream(outFile);
BufferedOutputStream bos = new BufferedOutputStream(fout);

      我们发现ctxt通过get方法暴露了绝对路径属性,我们进一步发现暴露该属性是为了创建指定名称的临时文件。那么我们为何不让ctxt来创建临时文件呢,将它的绝度路径属性隐藏起来,改成:

 

BufferedOutputStream bos = cxtx.createFileStream(classFileName);

      ctxt需要创建一个createFileStream方法。

 

 

  • 大小: 23.7 KB
1
0
分享到:
评论

相关推荐

Global site tag (gtag.js) - Google Analytics