ブレークポイント

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

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

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

非中断ブレークポイントは、プログラムを一時停止せずに何らかの式をログに記録する必要がある場合 (たとえば、メソッドが何回呼び出されたかを知る必要がある場合)、またはヒット時に 依存するブレークポイントを有効にする トリガーブレークポイントを作成する必要がある場合に役立ちます。

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

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

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

ポリシーをデフォルトのポリシーとして使用する場合は、 デフォルトにする ボタンをクリックします。

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

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

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

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

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

• 追跡されたインスタンスを式に含めたり、そのブールフィールドをチェックしたりするための ラベル： trackedObject_DebugLabel.isComplete()

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

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

• "Breakpoint hit" メッセージ(M): Breakpoint reached at ocean.Whale.main(Whale.java:5) のようなログメッセージ。

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

• 評価して記録(E): "Initializing" や users.size() などの任意の式の結果。

  式はアクセス修飾子を無視し、ブレークポイントが設定されている行のコンテキストで評価されます。

  式の結果は、return ステートメントから取得されます。 return ステートメントがない場合、結果はコードの最後の行から取得されます。その行は必ずしも式である必要はなく、リテラルでも構いません。 これにより、カスタムメッセージの生成やプログラム実行中の値のトラックが可能です。

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

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

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

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

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

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

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

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

• インスタンスフィルター: 特定のオブジェクトインスタンスでメソッドが呼び出された場合にのみプログラムを一時停止します。 このタイプのフィルターは、非静的コンテキストでのみ有効です。

• クラスフィルター: 特定のクラスでのみプログラムを一時停止します。 例外の場合、このフィルターはスローサイトクラスと一致します。

• 呼び出し元フィルター: 現在のメソッドの呼び出し元に応じてプログラムを一時停止します。 現在のメソッドが特定のメソッドから呼び出された（または呼び出されなかった）場合にのみ、ブレークポイントで停止する必要がある場合に選択します。 フィルターは直接の呼び出し元にのみ適用され、コールスタックの残りの部分はブレークポイントに影響を与えません。

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

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

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

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

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

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

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

フィルターの例:

ブレークポイントが特定の回数ヒットした後にのみ機能することを指定します。 これは、長時間実行されるループでアプリケーションを一時停止したり、頻繁に発生するイベントを選択的にログに記録したりするシナリオをデバッグする場合に役立ちます。

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

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

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

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