快速搜索集成教程

1. 下载 JTidy 并找到下载包中的 Tidy.jar。
2. 在“文件”窗口中，创建如下所示的文件夹结构，将 Tidy.jar 放置在 release/modules/ext 文件夹中：

   

3. 在 project.xml 文件的结束部分，该文件位于 nbproject 文件夹，添加下面的粗体标记：

               ...
               ...
               ...
               <class-path-extension>
                   <runtime-relative-path>ext/Tidy.jar</runtime-relative-path>
                   <binary-origin>release/modules/ext/Tidy.jar</binary-origin>
               </class-path-extension>
           </data>
       </configuration>
    </project>

4. 在 project.properties 文件中，添加以下内容：

   cp.extra=release/modules/ext/Tidy.jar

1. 右键单击项目，选择“属性”，在“库”面板中设置以下 个依赖关系。

   

2. 打开生成的类。
3. 修改该类，如下所示：

   public class NBZoneSearchProvider implements SearchProvider {
   
       /**
        * Method is called by infrastructure when search operation is requested.* Implementors should evaluate given request and fill response object with
        * apropriate results
        *
        * @param request Search request object that contains search string
        * @param response Search response object that stores search results 
        * Note that it's important to react to return value of 
        * SearchResponse.addResult(...) method and stop computation if 
        * false value is returned.
        */
       @Override 
       public void evaluate(SearchRequest request, SearchResponse response) {
           try {
   
               //The URL that we are providing a search for:
               URL url = new URL("http://netbeans.dzone.com");
               //Stuff needed by Tidy:
               Tidy tidy = new Tidy();
               tidy.setXHTML(true);
               tidy.setTidyMark(false);
               tidy.setShowWarnings(false);
               tidy.setQuiet(true);
   
               //Get the org.w3c.dom.Document from Tidy,
               //or use a different parser of your choice:
               Document doc = tidy.parseDOM(url.openStream(), null);
   
               //Get all "a" elements:
               NodeList list = doc.getElementsByTagName("a");
   
               //Get the number of elements:
               int length = list.getLength();
   
               //Loop through all the "a" elements:
               for (int i = 0; i < length; i++) {
   
                   String href = null;
                   if (null != list.item(i).getAttributes().getNamedItem("href")) {
                       //Get the "href" attribute from the current "a" element:
                       href = list.item(i).getAttributes().getNamedItem("href").getNodeValue();
                   }
   
                   //Get the "title" attribute from the current "a" element:
                   if (null != list.item(i).getAttributes().getNamedItem("title")) {
                       String title = list.item(i).getAttributes().getNamedItem("title").getNodeValue();
   
                       //If the title matches the requested text:
                       if (title.toLowerCase().indexOf(request.getText().toLowerCase()) != -1) {
   
                           //Add the runnable and the title to the response
                           //and return if nothing is added:
                           if (!response.addResult(new OpenFoundArticle(href), title)) {
                               return;
                           }
   
                       }
   
                   }
   
               }
   
           } catch (IOException ex) {
               Exceptions.printStackTrace(ex);
           }
       }
   
       private static class OpenFoundArticle implements Runnable {
   
           private String article;
   
           public OpenFoundArticle(String article) {
               this.article = article;
           }
   
           public void run() {
               try {
                   URL url = new URL("http://netbeans.dzone.com" + article);
                   StatusDisplayer.getDefault().setStatusText(url.toString());
                   URLDisplayer.getDefault().showURL(url);
               } catch (MalformedURLException ex) {
                   Logger.getLogger(NBZoneSearchProvider.class.getName()).log(Level.SEVERE, null, ex);
               }
           }
           
       } 
       
    }

4. 确保声明了以下导入数据：

   import java.io.IOException;
   import java.net.MalformedURLException;
   import java.net.URL;
   import java.util.logging.Level;
   import java.util.logging.Logger;
   import org.netbeans.spi.quicksearch.SearchProvider;
   import org.netbeans.spi.quicksearch.SearchRequest;
   import org.netbeans.spi.quicksearch.SearchResponse;
   import org.openide.awt.HtmlBrowser.URLDisplayer;
   import org.openide.awt.StatusDisplayer;
   import org.openide.util.Exceptions;
   import org.w3c.dom.Document;
   import org.w3c.dom.NodeList;
   import org.w3c.tidy.Tidy;

1. 在“项目”窗口中，右键单击项目并选择“运行”。

   此时将启动一个新的 IDE 实例，并安装快速搜索集成模块。

2. 在快速搜索功能中键入一个字符串，如果字符串匹配 NetBeans Zone 中的某个标题，则 NetBeans Zone 中的该项目将包括在结果中：

   

   如果您键入在 layer.xml 中定义的命令前缀，并紧跟一个空格，则只搜索相关的类别：

   

3. 单击某个项目，如果您在 IDE 中设置了浏览器，则会打开该浏览器并显示所选的文章。

在 NetBeans 平台上启用快速搜索功能

虽然 NetBeans IDE 随带了对快速搜索功能的支持，但 NetBeans 平台却并非如此。缺省情况下，快速搜索功能是隐藏的。根据下面的步骤启用该功能。

在 NetBeans 平台上启用缺省 Web 搜索提供器

缺省 Web 搜索提供器实现可以用在 NetBeans 源代码中。该提供器在 Google 中搜索与搜索字符串匹配的文本。在 IDE 中，它的作用是在 netbeans.org 和相关站点中搜索与 IDE 相关的在线文档。

注意：遗憾的是，IDE 中禁用了 Web 搜索提供器，因为在多次使用之后，Google 会抱怨自动搜索违背了其使用条款，并拒绝继续提供服务。

如果您接受上述限制，您可以标记此 Web 搜索提供器并在您的 NetBeans 平台应用程序中用它。

1. 在“项目”窗口中，右键单击“NetBeans Zone 搜索”项目，然后选择“创建 NBM”。

   此时将创建 NBM 文件，您可以在“文件”窗口 (Ctrl-2) 中查看它：

   

2. 例如，通过 NetBeans 插件门户向其他人提供该文件。接收者应使用插件管理器（“工具”>“插件”）来安装它。