NetBeans 插件快速入门

创建操作

1. 右键单击项目节点，然后选择“新建”>“操作”（如果未显示“操作”，请选择“其他”，然后在“新建文件”向导的“类别”下选择“模块开发”，此时应显示“操作”）。单击“下一步”。
2. 在“操作类型”面板中保留缺省设置（IDE 可以通过此设置创建作为 ActionListener 子类的操作），如下所示：
   
   
   
   单击“下一步”。
3. 在“GUI 注册”面板中，从“类别”下拉列表中选择“文件”。“类别”下拉列表用于控制操作在 IDE 的快捷键编辑器中的显示位置。接下来，取消选中“全局菜单项”，然后选中“全局工具栏按钮”。在“工具栏”下拉列表中选择“文件”，然后在“位置”下拉列表中选择“下拉列表中的任何位置”，如下所示：
   
   
   
   单击“下一步”。

4. 在“名称和位置”面板的“类名”中键入 GoogleAction，在“显示名称”中键入 Google Action。找到一个尺寸为 16x16 像素的图标。实际上，您不会用到这个图标，真正显示的图标将是下面一节中创建的 JPanel 窗体。只是，“新建操作”向导要求指定一个图标。因此，该图标可以是任意尺寸，因为您根本不会用到它。单击“完成”。

   注意：GoogleAction.java 将被添加到“项目”窗口的 org.myorg.googletoolbar 包中。

创建 JPanel

在本节中，将创建一个 JPanel 作为工具栏，它将显示在应用程序主工具栏中。

1. 右键单击项目节点，然后选择“新建”>“其他”。在“类别”下，选择“Swing GUI 窗体”。在“项目”下选择“JPanel 窗体”。单击“下一步”。
2. 在“名称和位置”面板的“类名”中键入 GooglePanel，然后从下拉列表中选择包。单击“完成”。GooglePanel.java 将被添加到该包中，并在源代码编辑器的“设计”视图中将其打开。
3. 将光标放在 JPanel 的右下角，然后选择 JPanel 并拖动光标来调整大小，以使其宽度和长度与工具栏类似，如下所示：
   
   
4. 将一个 JTextField 项和一个 JLabel 项从组件面板 (Ctrl+Shift+8) 直接拖到 JPanel 中，然后调整 JPanel 及另外两个项的大小，以使它们排放适宜。最后，单击 JLabel 并将其文本更改为 Google:，然后删除 JTextField 中的缺省文本。现在，您的 JPanel 应该与下面显示的图像类似：
   
   
5. 确保属性检查器（“窗口”>“导航”>“检查器”）处于打开状态，然后右键单击 JTextField 并选择“事件”> "Key" > "keyTyped"。这将在 GooglePanel.java 源代码中生成一个 jTextField1KeyTyped() 方法，并将其显示在源代码编辑器中，如下所示：
   
   
6. 在源代码编辑器的 GooglePanel.java“源”视图中，填写 jTextField1KeyTyped() 方法，如下所示（插入的文本以粗体显示）：

       
   private void jTextField1KeyTyped(java.awt.event.KeyEvent evt) {
       int i = evt.getKeyChar();
       if (i==10){//The ENTER KEY
           // we display the google url.
           try{
               URLDisplayer.getDefault().showURL
                       (new URL("http://www.google.com/search?hl=en&q="+jTextField1.getText()+"&btnG=Google+Search"));
           } catch (Exception eee){
               return;//nothing much to do
           }
       }
   }

如果需要，请在源代码编辑器中单击鼠标右键，然后选择“格式化”(Alt+Shift+F)。

解决错误

请注意，某个代码行带有红色下划线，这表示存在错误。其原因是尚未导入所需的包。将光标置于紧邻 URLDisplayer 所在行（带有红色下划线）左侧的栏中显示的灯泡图标上。将显示一条工具提示，说明出现此错误的原因：

为了解决此错误，需要让您的项目可访问 HtmlBrowser.URLDisplayer 类（包含在 org.openide.awt 包中）。为此，请执行以下步骤：

1. 右键单击“项目”窗口中的项目节点，然后选择“属性”。在显示的“项目属性”对话框中，选择“类别”标题下的“库”。然后，在“模块依赖关系”下，单击“添加”按钮。将显示“添加模块依赖关系”对话框。
2. 在“添加模块依赖关系”对话框顶部显示的“过滤器”文本框中，开始键入 URLDisplayer，请注意返回的模块的选择范围会逐渐缩小，直到列表中仅留有“UI 实用程序 API”：
   
   
   
   单击“确定”，然后再次单击“确定”退出“项目属性”对话框。
3. 在源代码编辑器中单击鼠标右键，然后选择“修复导入”(Alt+Shift+F)。将显示“修复所有导入”对话框，其中列出了针对无法识别的类的建议路径：
   
   
   
   单击“确定”。IDE 将为 GooglePanel.java 创建以下 import 语句：

   import java.net.URL;
   import org.openide.awt.HtmlBrowser.URLDisplayer;               
               

   另请注意，源代码编辑器中的所有错误将会消失。

重写 getToolbarPresenter()

由于刚创建的 JPanel 是用于显示 Google 工具栏的实际组件，因此需要重写操作类中的 getToolbarPresenter() 方法。在 GoogleAction.java 中，执行以下操作：

1. 打开 GoogleAction.java，将会注意到它包含以下内容：

       
   package org.myorg.googletoolbar;
   
   import java.awt.event.ActionEvent;
   import java.awt.event.ActionListener;
   
   public final class GoogleAction implements ActionListener {
   
       public void actionPerformed(ActionEvent e) {
           // TODO implement action body
       }
       
   }

2. 更改签名以使 CallableSystemAction 扩展该类，而不是实现该类的 ActionListener。添加下面显示的 import 语句，在此阶段中不会为每个所需的方法返回任何内容。现在，GoogleAction 类应如下所示：

       
   package org.myorg.googletoolbar;
   
   import org.openide.util.HelpCtx;
   import org.openide.util.actions.CallableSystemAction;
   
   public final class GoogleAction extends CallableSystemAction {
   
       @Override
       public void performAction() {
           
       }
   
       @Override
       public String getName() {
           return "";
       }
   
       @Override
       public HelpCtx getHelpCtx() {
           return null;
       }
       
   }

3. 打开 layer.xml 文件中，将会看到以下内容：

       
   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE filesystem PUBLIC "-//NetBeans//DTD Filesystem 1.2//EN" "http://www.netbeans.org/dtds/filesystem-1_2.dtd">
   <filesystem>
       <folder name="Actions">
           <folder name="File">
               <file name="org-myorg-googletoolbar-GoogleAction.instance">
                   <attr name="SystemFileSystem.localizingBundle" stringvalue="org.myorg.googletoolbar.Bundle"/>
                   <attr name="delegate" newvalue="org.myorg.googletoolbar.GoogleAction"/>
                   <attr name="displayName" bundlevalue="org.myorg.googletoolbar.Bundle#CTL_GoogleAction"/>
                   <attr name="iconBase" stringvalue="org/myorg/googletoolbar/icon.png"/>
                   <attr name="instanceCreate" methodvalue="org.openide.awt.Actions.alwaysEnabled"/>
                   <attr name="noIconInMenu" stringvalue="false"/>
               </file>
           </folder>
       </folder>
       <folder name="Toolbars">
           <folder name="File">
               <file name="org-myorg-googletoolbar-GoogleAction.shadow">
                   <attr name="originalFile" stringvalue="Actions/File/org-myorg-googletoolbar-GoogleAction.instance"/>
                   <attr name="position" intvalue="0"/>
               </file>
           </folder>
       </folder>
   </filesystem>

   上面显示的内容是由“新建操作”向导创建的。请删除 layer.xml 文件中的以下行，因为在本教程的上下文中不需要这些行；这些行定义了 "delegate" 属性、"displayName" 属性、"iconBase" 属性以及 "instanceCreate" 属性。

4. 返回到 GoogleAction 类，在类声明下面声明并设置以下变量：

   GooglePanel retValue = new GooglePanel();
               

5. 再次返回到 GoogleAction 类，并定义 getToolbarPresenter() 方法以返回 retValue 变量：

   @Override
   public java.awt.Component getToolbarPresenter() {
       return retValue;
   }
               

在本节中，已创建了一个用于显示 JTextField 和 JLabel 的 JPanel。在 JTextField 中按 Enter 键时，其内容将发送到 Google 搜索。将打开 HTML 浏览器，并且会看到 Google 搜索结果。该操作类用于在 layer.xml 文件中注册的应用程序工具栏内集成 JPanel。