码迷,mamicode.com
首页 > 其他好文 > 详细

代码整洁之道读后感(三)

时间:2014-08-15 19:26:19      阅读:217      评论:0      收藏:0      [点我收藏+]

标签:java   使用   strong   代码   ad   ef   on   信息   

注释

  1. 注释不能美化糟糕的代码
  2. 用代码来阐述你的思路
  3. 好的注释是什么?
    1. 法律信息
    2. 提供信息的注释
    3. 对意图的解释
    4. 警示:例如 // Don‘t run unless you have some time  to kill
    5. TODO注释
    6. 公共API的JavaDoc
  4. 坏的注释是什么?
    1. 多余的注释
    2. 误导性的注释
    3. 循轨式注释:所谓每个函数都要有JavaDoc活每个变量都要有注释的规矩简直是愚蠢。这类注释只会让代码混乱不堪。
    4. 日志式注释
    5. 废话式注释: Default Constructor
    6. 信息过多:别再注释里什么都写,把细节描述都写出来。。。my God。

错误处理

  1. 尽量使用不可控异常
  2. 给出异常发生的环境说明
  3. 别返回Null值
  4. 别传递NUll值

代码整洁之道读后感(三),布布扣,bubuko.com

代码整洁之道读后感(三)

标签:java   使用   strong   代码   ad   ef   on   信息   

原文地址:http://www.cnblogs.com/beiyeren/p/3915428.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!