ブレークポイント

プロジェクトから削除せずに一時的にブレークポイントを無効にするには、チェックボックスをオフにします。無効なブレークポイントは、ステップ実行中にスキップされます。

IntelliJ IDEAを構成して、ブレークポイントを完全に削除するのではなく、クリック時に有効/無効にすることができます。これを行うには、設定/環境設定 | ビルド、実行、デプロイ | デバッガーに移動し、ブレークポイントの除去オプションをエディターにドラッグまたはマウスの中ボタンをクリックに設定します。

ブレークポイントに達したときにプログラムの実行を一時停止するかどうかを指定します。

非中断ブレークポイントは、プログラムを一時停止せずに式を記録する必要がある場合（たとえば、メソッドが呼び出された回数を知る必要がある場合）、またはヒット時に依存ブレークポイントを有効にするマスターブレークポイントを作成する必要がある場合に便利です。

プログラムの実行を一時停止するブレークポイントには、次のポリシーを使用できます。

• すべて : スレッドのいずれかがブレークポイントに達すると、すべてのスレッドが中断されます。

• スレッド : ブレークポイントにヒットしたスレッドのみが中断されます。

このオプションは、ブレークポイントがヒットするたびにチェックされる条件を指定するために使用されます。条件が trueと評価された場合、選択されたアクションが実行されます。それ以外の場合、ブレークポイントは無視されます。

式の結果は、returnステートメントから取得されます。returnステートメントがない場合、結果はコードの最後の行から取得されます。

条件の本文では、次を使用できます。

• 宣言、ループ、匿名クラスなどを含む複数のステートメント

• this （非静的コンテキスト内）、たとえば、現在の例外を参照するため: !(this instanceof IOException)

• ラベルを使用して、式に追跡インスタンスを含めるか、ブールフィールドをチェックする: trackedObject_DebugLabel.isComplete()

式を評価するときは、プログラムの動作や結果に影響を与える可能性があるため、可能性のある副作用に注意してください。

ブレークポイントに到達すると、次のログがコンソールに記録されます。

• 「ブレークポイントヒット」メッセージ : Breakpoint reached at ocean.Whale.main(Whale.java:5)のようなログメッセージ

• スタック・トレース : 現在のフレームのスタックトレース。これは、プログラムの実行を中断することなく、このポイントに至ったパスを確認する場合に役立ちます。

• 評価して記録 : "Initializing" や users.size()などの任意の式の結果。式はアクセス修飾子を無視し、ブレークポイントが設定されている行のコンテキストで評価されます。

  式の結果は、returnステートメントから取得されます。returnステートメントがない場合、結果は式でなくてもよいコードの最後の行から取得されます。リテラルも機能します。これを使用して、カスタムメッセージを生成したり、プログラムの実行中にいくつかの値を追跡したりできます。

  式を評価するときは、プログラムの動作や結果に影響を与える可能性があるため、可能性のある副作用に注意してください。

ブレークポイントを1回ヒットした後、プロジェクトから削除するかどうかを指定します。

次のブレークポイントに到達するまで無効にするボックスでブレークポイントを選択すると、現在のブレークポイントのトリガーとして機能します。これにより、指定したブレークポイントがヒットするまで、現在のブレークポイントが無効になります。

これが発生した後に再び無効にするか、有効のままにするかを選択することもできます。

このオプションは、特定の条件下または特定のアクションの後でのみプログラムを中断する必要がある場合に役立ちます。この場合、通常、トリガーブレークポイントはプログラムの実行を停止するために必要ではなく、non-suspendingになります。

IntelliJ IDEAデバッガーを使用すると、クラス、インスタンス、および呼び出し元メソッドをフィルターで除外し、必要な場合にのみプログラムを中断することにより、ブレークポイント操作を微調整できます。

次のタイプのフィルターを使用できます。

• キャッチ・クラス・フィルター : 指定されたクラスの1つで例外がキャッチされる場合にのみ、プログラムを中断できます。例外ブレークポイントでのみ使用できます。

• インスタンス・フィルター : ブレークポイント操作を特定のオブジェクトインスタンスに制限します。このタイプのフィルターは、非静的コンテキストでのみ有効です。

• クラス・フィルター : ブレークポイント操作を特定のクラスに制限します。

• 発信者フィルタ : 現在のメソッドの呼び出し元に応じて、ブレークポイント操作を制限します。特定のメソッドから現在のメソッドが呼び出される（または呼び出されない）場合にのみ、ブレークポイントで停止する必要がある場合に選択します。

フィルタを設定するには、テキストフィールドの近くにあるボタンをクリックしてダイアログを使用するか、テキスト形式で定義します。テキスト形式の場合、次の構文を使用します。

• クラスとメソッドは、完全修飾名を使用して指定されます。クラス名でフィルターが指定されている場合、フィルターはクラス自体と、継承を介してそのメンバーを使用するすべてのサブクラスを指します。

• * ワイルドカードでパターンを使用して、クラスまたはメソッドのグループを定義できます。パターンで指定されたフィルターは、完全修飾名がこのパターンに一致するクラス/メソッドを指します。

• オブジェクトインスタンスは、インスタンスIDを使用して指定されます。オブジェクトがスコープ内にある場合、またはメモリータブを使用している場合、変数タブでオブジェクトIDを見つけることができます。

• クラス名、呼び出し元メソッド、パターン、およびインスタンスIDはスペースで区切られます。

• クラスまたは呼び出し元メソッドを除外するには、名前の前に - を入力します。

• 呼び出し元フィルターでは、パラメーターと戻り値の型の記述子を使用します（例： mypackage.MyObject.addString(Ljava/lang/String;)V）。記述子の詳細については、公式のOracleドキュメント(英語)を参照してください。

フィルターの例：

特定の回数ヒットした後にのみブレークポイントが機能するかどうかを指定します。これは、複数回呼び出されるループまたはメソッドのデバッグに役立ちます。

カウントが完了すると、カウントがリセットされ、新たに開始されます。これは、通過数が 10に設定されている場合、ブレークポイントがヒットする10回ごとに機能することを意味します。

通過数と条件の両方が設定されている場合、IntelliJ IDEAは最初に条件を満たし、次に通過数をチェックします。

このオプションを有効にすると、IntelliJ IDEAは、遅い「true」メソッドブレークポイントを使用する代わりに、メソッドの最初と最後のステートメントに行ブレークポイントの組み合わせを設定します。エミュレートされたメソッドブレークポイントはデバッグパフォーマンスを向上させるため、デフォルトで使用されます。

リモートコードをデバッグしている場合、または行番号情報のないネイティブメソッドまたはクラスにブレークポイントを設定する必要がある場合にのみ、このオプションを無効にすることをお勧めします。