NetBeans Google ツールバーモジュールのチュートリアル

サンプルのインストール

次の手順でサンプルをインストールします:

1. サンプルファイル を展開 (unzip) します。

2. IDE の「ファイル」>「プロジェクトを開く」を選択し、解凍したファイルがあるフォルダまで移動します。モジュールプロジェクトを開きます。プロジェクトを開くと次のようになります:

   

3. プロジェクトノードを右クリックし「ターゲットプラットフォームでのインストール/再読み込み」を選びます。ターゲットプラットフォームが開きモジュールがインストールされます。

4. 使い方は モジュールの使用 セクションで説明していますのでモジュールが正しくインストールできているかどうか確認してください。

最終的な結果がどのようになるかわかったので、スクラッチからモジュールを作り作成の過程でそれぞれの部分を勉強してみましょう。

モジュールプロジェクトの作成

1. 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択してください。「カテゴリ」で「NetBeans プラグインモジュール」を選択します。「プロジェクト」では「モジュールプロジェクト」を選択し「次へ」ボタンをクリックします。
2. 「名前と場所」パネルでは「プロジェクト名」に「GoogleToolbar」と入力します。「プロジェクトの場所」は適当なディレクトリを指定します。例えば c:\mymodules などです。「スタンドアロンモジュール」のラジオボタンはそのままにし「主プロジェクトとして設定」チェックボックスを選択します。「次へ」をクリックします。

3. 「基本モジュール構成」パネルでは「コード名ベース」で yourorghere を myorg に置き換え、org.myorg.googletoolbar にします。「地域対応のバンドル」と「XML レイヤー」はそのままにし org/myorg/googletoolbar にこれらのファイルが保存されるようにします。「完了」ボタンをクリックします。

IDE は GoogleToolbar プロジェクトを作成します。プロジェクトは必要なすべてのソースやメタデータ、たとえばプロジェクトの構築スクリプトなどを含んでいます。プロジェクトは IDE 上で開かれます。「プロジェクト」ウィンドウ(Ctrl-1) で理論的な構成を表示できます。また「ファイル」ウィンドウ(Ctrl-2)ではファイル構造を表示できます。例えば「プロジェクト」ウィンドウではこのようになります:

これらのファイルの基本的な説明は NetBeans IDE 5.0 プラグインモジュールクイックスタートガイド を参照してください。

アクションの作成

1. プロジェクトノードで右クリックして「新規」>「ファイル/フォルダ」を選択します。「カテゴリ」で「NetBeans モジュール開発」を選択します。「ファイルの種類」で「アクション」を選択します。「次へ」をクリックします。
2. 「アクションの種類」パネルではデフォルトの設定をそのまま使います。IDE は CallableSystemAction のサブクラスのアクションクラスを作成します。このようになります:

   

   「次へ」をクリックします。

3. 「GUI の登録」パネルでは「カテゴリ」のドロップダウンリストから「編集」カテゴリを選択します。この「カテゴリ」ドロップダウンリストはキーボードショートカットエディタのどこにアクションを表示するかを指定します。次に「大域メニュー項目」は選択を解除し、「大域ツールバーボタン」を選択します。「ツールバー」ドロップダウンリストでは「編集」を選択し、「位置」ドロップダウンリストでは「検索...ここに置く」を選択します:

   

   「次へ」をクリックします。

4. 「名前と場所」パネルでは「クラス名」に「GoogleAction」と入力し「表示名」には「Google Action」と入力します。16x16 ピクセルの寸法のアイコンを参照します。実際にはアイコンは使用しません。かわりに次のセクションで説明する JPanel フォームを表示します。しかしアクションウィザードではアイコンを指定しなければなりません。実際に使うことはないのでどの寸法のアイコンでもかまいません。「完了」ボタンをクリックします。パッケージに GoogleAction.java が追加されます。

JPanel フォームの作成

1. プロジェクトノードで右クリックして「新規」>「ファイル/フォルダ」を選択します。「カテゴリ」で「Java GUI フォーム」を選択します。「プロジェクト」で「JPanel フォーム」を選択します。「次へ」をクリックします。
2. 「名前と場所」パネルでは「クラス名」に「GooglePanel」と入力しドロップダウンリストからパッケージを選択します。「完了」ボタンをクリックします。GooglePanel.java がパッケージに追加されソースエディタに「デザイン」ビューが開きます。

3. JPanel を選択し次のように右下のコーナーにカーソルを移動します。

   

4. カーソルをドラッグして JPanel のサイズをツールバーの高さと幅に合うように変更します:

   

5. JTextField と JLabel をパネルにドラッグします。JPanel と他の２つのアイテムをリサイズして次のように互いに合うようにします:

   

   そして JTextField のデフォルトの文字列を削除します。次に JLabel を選択しテキストを「Google:」に変更します。

6. JTextField を選択し「プロパティー」の「インスペクタ」で「イベント」をクリック、「KeyTyped」イベントをクリックします。次のように jTextField1KeyTyped メソッドが作成されます:

   

7. 「ソース」表示で jTextFieldKeyTyped メソッドを次のように変更してください:

   
       private void jTextField1KeyTyped(java.awt.event.KeyEvent evt) {                                     
           int i = evt.getKeyChar();
           if (i==10){//ENTER キーが押された
               // 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;// 何もしない
               }
           }
       }
   

   ソースエディタで右クリックし「コードを再フォーマット」(Ctrl-Shift-F) を選択します。ここでコードの１行に赤のアンダーラインが付くことがわかります。これはパッケージがまだインポートされていないためです。これは次の方法で解決できます。

8. ソースエディタで右クリックし「インポートを修正」(Alt-Shift-F) を選びます。 java.net.url を選択して「了解」をクリックします。赤いアンダーラインは消えてエラーは解決できました。プロジェクトを右クリックし「プロパティー」を選択します。「ライブラリ」で「追加」ボタンを押し「URLDisplayer」と入力していくと 「コア」 と 「UI ユーティリティー API」 のみが表示されるようになります:

   

   「UI ユーティリティー API」 を選択して「了解」をクリックします。「了解」をクリックしてプロジェクトの「プロパティー」ダイアログを閉じます。再度ソースエディタで右クリックし「コードを再フォーマット」(Ctrl-Shift-F) を選択します。赤いアンダーラインが消えパッケージがインポートされます。

9. 最後に this はツールバーとして表示されるものなのでアクションクラスの getToolbarPresenter() メソッドをオーバーライドする必要があります:

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

   アクションクラスの宣言の最初は次のようになります:

       GooglePanel retValue = new GooglePanel();

モジュールのインストール

• 「プロジェクト」ウィンドウで GoogleToolbar プロジェクトを右クリックし「ターゲットプラットフォームでのインストール/再読み込み」を選びます。

  モジュールが構築されターゲットプラットフォームにインストールされます。ターゲットプラットフォームが起動し新規モジュールを試すことができます。デフォルトのターゲットプラットフォームとは IDE の現在のインスタンスで使用しているインストールです。

モジュールの使用

1. インストールが正しく行われると、「編集」ツールバーに新しいボタンを追加します。しかしツールバーボタンはアイコンを表示しません。かわりに JPanel に追加した JLabel と JTextField が表示されます:

   

2. テキストフィールドに検索文字列を入力します:

   

3. Enter キーを押します。IDE のデフォルトブラウザが起動します。Google URL と検索文字列はブラウザに送信され検索が始まります。検索結果が返されると結果をブラウザで見ることができます。

共有可能なモジュールバイナリの作成

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

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

   

2. メールなどで送付することにより他の人に配布、共有できます。

次のステップ

モジュールの開発と作成の詳細は次のリソースを参照してください:

• モジュール開発者リソース
• NetBeans API リスト (現行の開発バージョン)
• 新規 API サポートの提案

バージョン

詳細な更新履歴は 原文の英文 をご覧下さい。このファイルはリビジョン 1.23 を翻訳しています。