酒神姬动一夜白发:Code Review工具Jupiter的使用 - Simple is better - ...

来源:百度文库 编辑:九乡新闻网 时间:2024/04/28 00:20:13

给公司写的介绍性文档,其实就是Peer Code Reviews Made Easy with Eclipse Plug-In这篇文章的一点摘要……

首先把jupiter安装到eclipse中……

Jupiter里,代码评审(code review)分为4个流程

  1. Configuration(配置):review发起者设置“Review ID”,指定要评审的代码,参与代码评审的人员,要讨论的问题等等。
  2. Individual review(个人评审):每个人独自审查代码,把可能出现问题的代码加入checklist
  3. Team review(团队评审):大家在一起讨论之前检查出的问题代码,并决定如何处理
  4. Rework:开发人员根据之前评审的结果,对代码进行修复

下面对4个步骤进行简介:

1.Configuration

由评审发起者(代码作者、team leader或者PM)进行配置。

打开项目属性->Review选项页。点击“New...”,设置相应的ReviewId和description

接着添加本次要评审的代码和文件

添加参与代码评审的人员

接下来设置各种缺陷类型、严重性之类的。然后就是指定存放评审数据的目录。这个目录是相对于项目根目录的。如下图的设置,数据就会存放在“项目根目录/review”里

设置完成后,Jupiter将在项目根目录下生成“.jupiter”文件,把此文件存入CVS。现在评审发起者可以通知大家进行代码评审了。可以通过发邮件的方式进行通知,通知的内容最好有以下部分:

  • 项目名称、Review ID、参与评审人员名单。
  • 被评审代码的描述信息,如功能,需求等等
  • 新增加和删除的文件
  • 受影响但没有在Configuration中指定的组件

通知完毕后,各成员即可正式进行代码评审。

2.Individual review

从CVS取出最新的代码和.jupiter文件,在eclipse里->窗口(Window)->打开透视图(Open Perspective)->Review。然后选择Individual Phase

选择项目名称,Review ID和Reviewer ID(评审者ID),然后就可以开始查看代码了。

在代码评审过程中,发现有问题的代码,即可在上面点击右键菜单->Add Review Issue...把问题添加到Jupiter中,指定问题类型、严重性和描述信息,点击保存。

完成个人的代码评审后,把Jupiter评审数据目录下的文件传入CVS,就可以一起进行讨论了。

3.Team review

大家在一起,使用一台电脑或者投影仪,选择Team Phase

现在Individual Phase里检查出的所有的问题都会显示在ReviewTable里,点击Go To就能链接到问题所在代码,然后大家讨论这段代码是否有问题,如何解决等等,把结果写到ReviewEditor里,保存。

所有的问题讨论出结果后,把Jupiter评审数据文件传入CVS,散会,各自回到自己位置,进行下一个步骤

4.Rework

从CVS取出最新的Jupiter评审数据文件,选择Rework Phase

选择自己的ID后,上一步骤中分配给自己的问题就会显示到ReviewTable里,一个一个地把问题修复吧,修复后把状态置为Resolved。完毕后把Jupiter数据传CVS。

各自的rework完成后,各位评审者取出最新的Jupiter数据,关闭ReviewTable的过滤器,就能查看到本次评审中发现的各种问题,对各种问题进行验证,感到满意后可以把状态置为Closed,或者验证未通过,就置为Re-Opened。

如此,便完成了一次代码评审……

参考资料:

  • Jupiter User's Guide http://csdl.ics.hawaii.edu/Tools/Jupiter/Core/doc/UsersGuide.html
  • Effective Code Reviews Without the Pain http://www.developer.com/java/other/article.php/3579756
  • Peer Code Reviews Made Easy with Eclipse Plug-In http://www.devx.com/enterprise/Article/31658/0/page/1