Java コードのデバッグ

Notes® クライアント JVM (Java™ 仮想マシン) の管理下で稼働している Java コードをデバッグすることができます。

始める前に

Notes クライアントは、以下の 3 つのコンテキストでの Java デバッグをサポートしています。 各コンテキストには、独自の JVM があります。 各コンテキストで、一度にデバッグできるユーザーは 1 人だけです。

スクリプトライブラリの Java コードは、呼び出し元コードのコンテキストで実行されます。

このタスクについて

以下の手順を実行します。

手順

  1. Notes ディレクトリ内の notes.ini ファイルに JavaEnableDebug=1 を追加します。
  2. [ツール] > [Java デバッグプリファレンス] を選択します。 [Java デバッグプリファレンス] ダイアログが開きます。
    1. フォアグラウンドデバッグを有効にするには、 [クライアント エージェント/アプレット] を選択して、Notes とデバッガコンピュータに接続するためのポート番号を指定します。
    2. バックグラウンドデバッグを有効にするには、 [ローカルでスケジュールしたエージェント] にチェックマークを付け、Notes とデバッガコンピュータに接続するためのポート番号を指定します。
    3. Web プリビューデバッグを有効にするには、[HTTP プリビュー] にチェックマークを付け、 Notes とデバッガコンピュータに接続するためのポート番号を指定します。
  3. Notes を再起動します。
  4. デバッグ用の要素をセットアップします。
    1. Domino Designer で要素を開きます。
    2. [プロパティ] タブで [セキュリティ] を選択し、[デバッグ情報を含めて Java コードをコンパイルする] を選択します。
    3. メインクラス (例えば JavaAgent.java) を開きます。
    4. 先頭に sleep コマンドを追加します。 期間は、実行時にデバッガに接続できるだけの長さにする必要があります。
    5. sleep コマンドに続く行にブレークポイントを設定します。
    6. 要素を保存します。
  5. デバッグ構成を作成します。
    1. メインクラスを開きます。
    2. [実行] > [デバッグ構成] をクリックします。
    3. [デバッグ構成] ダイアログで、[リモート Java アプリケーション] を選択して新規構成を作成します。
    4. 構成に名前を付けます。
    5. デバッグする要素が含まれているプロジェクトを指定します。
    6. ホストを localhost または 127.0.0.0 に設定します。
    7. ポートを Notes クライアントで設定されている値に設定します。
    8. [適用][閉じる] の順にクリックします。
  6. 要素をデバッグします。
    1. Notes クライアントで要素を開始します。 例えば、[アクション] メニューからエージェントを開始します。
    2. Domino Designer で、メインクラスを開きます。 ブレークポイントが設定されていることを確認します。
    3. [実行] > [デバッグ構成] をクリックします。
    4. デバッグする要素と一致するデバッグ構成を選択して、[デバッグ] をクリックします。
    要素がブレークポイントで停止し、デバッグできるようになります。 要素の開始後に、その要素のスリープ中に残りのステップを適用する必要があります。
  7. 2 番目の要素をデバッグするには、[デバッグ構成] の [参照] ボタンを使用して要素を選択し、[適用]をクリックします。