Geertjan Wielenga 在NetBeans IDE 7.1中发布的自定义声明性提示首先介绍了NetBeans的“检查和转换”(又名“ 检查和重构 ”)对话框,该对话框可从“重构”菜单中获得(该菜单又可通过下拉菜单获得)菜单栏中的“重构”菜单,或者通过在NetBeans编辑器中单击鼠标右键。 以下屏幕快照显示了它的外观。
“检查和转换”对话框的“检查”字段允许NetBeans用户定制应检查的项目或文件。 “检查和转换”对话框的“使用”部分允许NetBeans用户指定要检查的提示。 在这种情况下,我正在使用自定义提示进行检查,并且可以通过单击“管理”按钮并选择“自定义”复选框来看到它。 请注意,如果初次使用“自定义”不是一个选项,则可能需要单击左下角的“新建”按钮。
当我单击“管理”并选中“自定义”框时,它会展开,并且可以看到新创建的“检查”提示。 如果单击此名称,则可以重命名,并且在这种情况下也可以重命名。 重命名的检查(“ CurrentDateDoesNotNeedSystemCurrentMillis”)显示在下一个屏幕快照中。
要创建提示并提供框中显示的描述,我可以单击“编辑脚本”按钮。 这样做会导致在下一个屏幕快照中显示小的编辑器窗口。
如果需要更多空间来编辑自定义检查/提示,则“在编辑器中打开”按钮将导致在NetBeans文本编辑器中打开文本,在该文本编辑器中可以编辑普通的Java代码和XML代码。
有了自定义检查/提示后,就该在一些Java代码上进行尝试了。 以下代码清单使用了对System.currentTimeMillis()的多余调用,并将其结果传递给java.util.Date单长参数构造函数 。 这是不必要的,因为Date的无参数构造函数将根据当前时间(现在的时间)自动实例化Date
的实例。
RedundantSystemCurrentTimeMillis.java
package dustin.examples;import static java.lang.System.out;
import java.util.Date;/*** Simple class to demonstrate NetBeans custom hint.* * @author Dustin*/
public class RedundantSystemCurrentTimeMillis
{public static void main(final String[] arguments){final Date date = new Date(System.currentTimeMillis());out.println(date);}
}
上面的代码可以正常工作,但是可能更简洁。 当我告诉NetBeans在“检查和转换”对话框中将我的新检查与该项目相关联时,NetBeans可以为我标记此标记并建议修复。 接下来的三个屏幕快照展示了NetBeans将用黄色灯泡图标和黄色下划线标记警告,在单击灯泡时将推荐该修复程序,并在选择该灯泡时实施建议的修复程序。
如上所示,一个简单的自定义提示允许NetBeans根据我的请求标识,标记和修复不必要的System.curentTimeMillis()
。 我之前已经写过NetBeans的提示非常方便,因为它们实际上对Java开发人员做了三件事:自动为开发人员标记需要改进的代码区域,经常在需要时自动解决问题,以及交流编写Java的更好方法。 对于这种情况的最后一个好处,此自定义提示的存在有助于向其他Java开发人员传达有关Date
类的更多知识,以及在需要当前日期/时间时实例化它的更好方法。
使用NetBeans的自定义提示最困难的方面是查找有关如何使用它们的文档 。 当前可用的最佳资源似乎是NetBeans 7.1发行说明 ,几篇Wielenga帖子( NetBeans IDE 7.1中的自定义声明性提示 , Oh No Vector ! 、 Oh No @Override!/ Oh No Utilities.loadImage! )和Jan Lahoda的jackpot30规则语言 (涵盖自定义检查/提示使用的规则语言语法 ,并显示在上面的简单示例中)。 NetBeans IDE Java编辑器教程中的“通过检查和转换进行重构”还包括有关管理自定义提示的部分 。 希望能够解决Bug 210023的问题。
我的示例自定义NetBeans提示专门用于Date
类。 一个有趣且有点相关的StackOverflow线程询问是否可以创建NetBeans自定义提示来建议使用Joda Time而不是Date
或Calendar 。 有关该线程的响应,请参阅《 NetBeans Java提示模块教程》 。 查看该教程会提醒我,本文中概述的方法以及NetBeans 7.1中提供的方法肯定已改进并且更易于使用。
顺便说一句,在NetBeans 7.1中很容易编写类似于所引用的StackOverflow线程中所要求的提示。 此示例中没有转换,因为将Date
类更改为Joda Time类可能需要比简单转换所能处理的代码更改更多。 因此,此提示仅建议更改为Joda Time。 下一个屏幕快照显示了简单的提示以及它们在NetBeans编辑器中的显示方式。
每个版本的NetBeans似乎都会为NetBeans支持的大量有用提示添加更多有用的提示。 但是,对于NetBeans开发人员来说,不可能添加每个团队或项目可能想要的所有提示。 此外,不希望有每一个可能的暗示,即每个社区成员可能都会提出来的所有提示。 因此,在NetBeans中指定自定义提示的能力以及将这些提示选择性地应用到项目和文件的能力都是非常需要的功能。
参考:在Inspired by Actual Events博客上,由我们的JCG合作伙伴 Dustin Marx 创建了NetBeans 7.1自定义提示 。
翻译自: https://www.javacodegeeks.com/2012/05/netbeans-71-create-custom-hint.html