高速検索の統合のチュートリアル

1. JTidy をダウンロードし、その中にある Tidy.jar を探します。
2. 「ファイル」ウィンドウで、Tidy.jar を release/modules/ext フォルダに格納し、次に示すようなフォルダ構造を作成します。

   

3. nbproject フォルダにある project.xml ファイルの最後のほう、すなわちファイルの最後の直前に、次のボールドタグを追加します。

               ...
               ...
               ...
               <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 検索プロバイダの有効化

NetBeans ソースでは、デフォルトの Web 検索プロバイダの実装が可能です。このプロバイダは、検索文字列が一致するテキストを Google で検索します。IDE では、netbeans.org と、IDE に関連するオンラインドキュメント用の関連サイトを検索するために使用されています。

注: 残念ながら、Web 検索プロバイダを何度も使用していたので、Google がこの自動検索が利用規約に反しているとし、機能を継続することを拒否しました。そのため、IDE で Web 検索プロバイダは無効になっています。

前述の制限に同意する場合は、この Web 検索プロバイダをブランディングし、NetBeans プラットフォームアプリケーションで使用できます。

1. 「プロジェクト」ウィンドウで、NetBeans Zone Search プロジェクトを右クリックし、「NBM を作成」を選択します。

   NBM ファイルが作成されます。これは「ファイル」ウィンドウ (Ctrl-2) で確認できます。

   

2. たとえば、NetBeans プラグインポータルを通じて、ほかの人がそのファイルを使用できるようにします。受信者は「プラグインマネージャー」(「ツール」>「プラグイン」) を使用して、それをインストールします。