NetBeans Google Toolbar 模块教程

安装示例

采用以下步骤来安装示例：

1. 解压缩附加的文件。
2. 在 IDE 中，选择 File > Open Project，然后浏览到包含已解压缩文件的文件夹。打开模块项目。其形式如下：

   

3. 右键单击项目节点并在 Target Platform 中选择 Install/Reload。将打开目标平台并安装该模块。
4. 通过使用该模块来验证其是否已正确安装，如使用模块部分所述。

知道了最终结果后，将从头开始创建模块，并且在创建的同时了解每个部分。

创建模块项目

1. 选择 File > New Project (Ctrl-Shift-N)。在 Categories 下，选择 NetBeans Plug-in Modules。在 Projects 下，选择 Module Project 并单击 Next。
2. 在 Name and Location 面板中，在 Project Name 中键入 GoogleToolbar。将 Project Location 更改为您计算机上的任何目录，如 c:\mymodules。选择 Standalone Module 单选按钮和 Set as Main Project 复选框。单击 Next。
3. 在 Basic Module Configuration 面板中，用 myorg 替换 Code Name Base 中的 yourorghere，从而整个 Code Name Base 为 org.myorg.googletoolbar。留出本地化包和 XML 层的位置，以便它们存储在名为 org/myorg/googletoolbar 的包中。单击 Finish。

IDE 创建 Show XML Structure 项目。该项目包含所有资源和项目元数据，如该项目的 Ant 构建脚本。该项目在 IDE 中打开。您可以在 Projects 窗口 (Ctrl-1) 中查看其逻辑结构，在 Files 窗口 (Ctrl-2) 中查看其文件结构。例如，现在 Projects 窗口应该如下所示：

有关以上每个文件的基本信息，请参阅 NetBeans 插件模块的快速入门指南。

创建 Action

1. 右键单击项目节点并选择 New > File/Folder。在 Categories 下，选择 NetBeans Module Development。在 Projects 下选择 Action。单击 Next。
2. 在 Action Type 面板中，保留默认的设置，这将允许 IDE 创建一个作为 CallableSystemAction 子类的操作，如下所示：

   

   单击 Next。

3. 在 GUI Registration 面板中，选择 Category 下拉列表中的“Edit”类别。Category 下拉列表控制操作在 IDE 的 Keyboard Shortcuts 编辑器中显示的位置。接下来，取消选择 Global Menu Item 并选择 Global Toolbar Button。在 Toolbar 下拉列表中，选择 Edit 并且在 Position 下拉列表中，选择 Find...-HERE，如下所示：

   

   单击 Next。

4. 在 Name and Location 面板中，键入 GoogleAction 作为 Class Name，并键入 Google Action 作为 Display Name。浏览到尺寸为 16x16 像素的图标。实际上，您不会使用该图标，您将显示在下一部分中创建的 JPanel Form。但是 Action 向导要求您指定一个图标。由于您不会使用这个图标，因此，该图标可以是任何尺寸。单击 Finish。GoogleAction.java 被添加到包中。

创建 JPanel Form

1. 右键单击项目节点并选择 New > File/Folder。在 Categories 下，选择 Java GUI Forms。在 Projects 下选择 JPanel Form。单击 Next。
2. 在 Name and Location 面板中，键入 GooglePanel 作为 Class Name，并从下拉列表中选择该包。单击 Finish。GooglePanel.java 被添加到该包中，并且在 Source Editor 中以 Design 视图打开。
3. 选择 JPanel 并将光标放置在右下角，如下所示：

   

4. 拖动光标以调整 JPanel 的大小，使它的宽度和长度类似工具栏的宽度和长度，如下所示：

   

5. 将 JTextField 项和 JLabel 项拖动到面板中，并重新调整 JPanel 和其他两个项目的尺寸，使它们贴在一起，如下所示：

   

   然后删除 JTextField 中的默认文本。接下来，单击 JLabel 并将其文本更改为 Google:

6. 选择 JTextField，在 Property Inspector 中单击 Events，然后单击 keyTyped 事件，创建 jTextField1KeyTyped 方法，如下所示：

   

7. 在 Source 视图中，按以下形式填写 jTextFieldKeyTyped 方法：

       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"));//NOI18N
               } catch (Exception eee){
                   return;//nothing much to do
               }
           }
       }

   右键单击 Source Editor，然后选择 Reformat Code (Ctrl-Shift-F)。注意到一行代码标有红色下划线。这是因为尚未导入它的包。下一步将声明这些包。

8. 右键单击 Source Editor，选择 Fix Imports (Alt-Shift-F)，选择 java.net.url，然后单击 OK。红色下划线仍然没有解决。右键单击该项目，选择 Properties，单击 Libraries，单击 Add，开始键入 URLDisplayer 并观察返回的模块变窄，直到只剩下 Core 和 UI Utilities API 位于左侧，如下所示

   

   选择 UI Utilities API 然后单击 OK。然后单击 OK 确认您的选择，并退出 Project Properties 对话框。再次右键单击 Source Editor，并选择 Fix Imports (Alt-Shift-F)。现在红色的下划线消失了，并且导入了包。

9. 最后，由于 this 是将显示工具栏的组件，因此您需要重写 action 类中的 getToolbarPresenter() 方法：

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

   在 action 类的顶部声明以下内容：

       GooglePanel retValue = new GooglePanel();

安装模块

• 在 Projects 窗口，右键单击 GoogleToolbar 项目并在 Target Platform 中选择 Install/Reload。

  模块即在目标平台中构建和安装。目标平台打开，您可以试用新的模块。默认目标平台是由开发 IDE 的当前实例使用的安装。

使用模块

1. 成功安装之后，该模块在 Edit 工具栏中添加了一个新按钮。但是该工具栏按钮不显示图标。相反，它显示已添加到 JPanel 的 JLabel 和 JTextField：

   

2. 在文本字段中键入一个搜索字符串：

   

3. 按 Enter。IDE 的默认浏览器启动。Google URL 和您的搜索字符串被发送到浏览器并进行搜索。搜索返回时，您可以在浏览器中看到返回的结果。

创建可共享的模块二进制文件

1. 在 Projects 窗口中，右键单击 GoogleToolbar 项目，并选择 Create NBM。

   将创建 NBM 文件并且可以在 Files 窗口中查看它 (Ctrl-2)：

   

2. 通过电子邮件使其他人也可以使用。

下一步

有关创建和开发模块的更多信息，请参见以下资源：

• 模块开发者资源
• NetBeans API 列表（当前开发版本）
• 新的 API 支持建议

版本控制

版本	日期	更改
1	2005 年 10 月 6 日	初始版本