文章关键字 ‘Roman Strobl’

netBeans的自动注释不见了?

2008年01月6号,星期天

最近又在写一些自己的小东西——哦, 对了, 就是这个GTD——于是又开始用尘封很久的netBeans.

说尘封一点都不夸张. 你看, 我连以前那个很好用的”自动注释工具”都找不到了. 以前在5.x的时候, 经常用来完善注释, 很方便的一个工具. 但是在新的6.0里面翻了半天都找不到这个东东了. 你可能会觉得我很无聊, 自己写给自己用的东西干嘛还搞那么严格, 连注释都要写的那么好. 没办法, 俺就是有点代码洁癖外加非典型完美主义者.

Google了一下”netBeans auto comment 6.0″, 找到了netBeans.org里的一个blog, 是一位叫做Roman Strobl的开发者的blog. Roman在他的这篇blog里详细说明了”自动注释工具”在netBeans6.0上消失的原因——是的, 消失了. 根据Roman的说法, 这只是因为需要重写的代码太多, 而6.0的发布时间又很紧的缘故. 并且, 在blog中, Roman针对自动注释工具的缺失给出了替代(Workaround)方法: 打开JavaDoc自动提示功能(可以看Roman那篇blog里的那个图). 我试了一下, 在打开JavaDoc提示之后, 在注释写错的地方(比如注释里少了个参数)会有一个黄色的小灯泡出现在那一行的最左边, 就好象其他java错误(比如缺少引用)的提示一样. 而如果一个类或者方法根本没有加注释的话, 把光标移到这个类或方法的声明行, 同样在左边会出现一个黄色小灯泡, 点击它并选择”Create missing JavaDoc for xxx”就可以自动帮你添加上包括所有参数的一个空注释. 这点我觉得设计的很好. 如果你是个懒人, 就算开了JavaDoc提示, 也不会弄得满屏幕小灯泡. 而如果你是个代码洁癖狂的话, 自己一个一个点也没有增加多少工作量. 当然, 如果你是个代码洁癖狂+懒鬼的话, 请务必记住这个功能相当于按小灯泡的快捷键: Alt+Enter.

BTW, 最近开始玩一个新玩具——饭否. 本来说要把饭否插件加到自己blog的侧栏的, 但是最近72松的widgets设置貌似出了很大的bug, 处于几乎用不了状态, 所以过一段等他们修好再说吧.