diff --git a/tools/Forward/TraceDebugger_Forward.html b/tools/Forward/TraceDebugger_Forward.html new file mode 100644 index 0000000..114b353 --- /dev/null +++ b/tools/Forward/TraceDebugger_Forward.html @@ -0,0 +1,134 @@ + + +
+
+ このデバッガでは, プログラムの実行時情報が記録されたファイルであるトレースファイルを読み込み, その読み込んだトレースを元にデバッグ実行を行うことができます.
+ 通常のデバッガと比較した際のこのデバッガの特徴を下記に示します.
+
+
+ メニューバーの Window → Perspective → Open Perspective → Other... → トレースデバッガ(順方向) でトレースデバッガのパースペクティブを開いてください.
+
+ 実際に「トレースデバッガ(順方向)」のパースペクティブを開くと下図のような状態になります.
+ このパースペクティブは4つのビューで構成されており, 左上が呼び出しスタックビュー, 右上が変数ビュー, 左下がエディタ, 右下がブレークポイントビューになっています.
+
+ このデバッガは, プログラムを実際に実行した際の情報を収集したトレースファイルを読み込むことで, トレース上でデバッグ実行を再現できるものです.
+ まずは, トレースファイルを読み込みます.
+ 右下にあるブレークポイントビューのフォルダアイコンをクリックすると, ファイル選択のダイアログが開くので, トレースファイルを選択すると読み込むことができます.
+
+ トレースファイルを読み込んだら, 次はこのデバッガ上でデバッグ実行するために必要なブレークポイントを設定します.
+ まずは, デバッグ実行を一時停止したい行に対して, 普通のデバッガを利用する際と同様の手順で Eclipse 標準のブレークポイントを入れていきます.
+ それらのブレークポイントを入れ終わったら, 右下にあるブレークポイントビューの「ブレークポイントをEclipseから取り入れる」アイコンをクリックします.
+ すると, ブレークポイントビュー上に, このデバッガ専用のブレークポイントが生成されます.
+ ただし, 実際に読み込んだトレースファイルに記録されていない行については, このブレークポイントは生成されません.
+
+ ブレークポイントを生成したら, 右下のブレークポイントビューの「デバッグ」アイコンをクリックすると, 実際にデバッグ実行が開始されます.
+ 最初は, 有効なブレークポイントが入っている行のうち, 時系列上で最初に実行された行にまで実行が進み, そこで実行が一時停止します.
+ この画像の場合では, D クラスの passB(B) メソッドの6行目が該当しているため, そこまで実行が進んだ状態で一時停止しています.
+
+ デバッグ実行中の状態で, 右下のブレークポイントビューの「終了」アイコンをクリックすると, デバッグ実行が停止します.
+
+ デバッグ実行中の状態で, 右下のブレークポイントビューの「再開」アイコンをクリックすると, 有効なブレークポイントが入っている行のうち,
+ 現在の実行時点よりも後の実行で最も近い行にまで実行が進み, そこで実行が再び一時停止します.
+ もし, 該当する行がなかった場合は, そのままデバッグ実行が終了します.
+ この画像の場合では, E クラスの setC(C) メソッドの7行目が該当しているため, そこまで実行が進んだ状態で一時停止します.
+
+ 左上の呼び出しスタックビューには, 現在一時停止している行をトップとしたメソッド呼び出しのスタックが表示されています.
+ 表示されているメソッドシグ二チャをクリックすることで, 呼び出し元のメソッドや呼び出し先のメソッドを見ることができます.
+
+ このデバッガでは, トレースファイルに記録されたステートメント単位の実行時情報を元に, 実行を少しずつ進めていくことができます.
+ ここで, このステートメント単位は行単位よりも細かい粒度になっていることに注意してください.
+ 右下のブレークポイントビューの「ステップオーバー」アイコンをクリックすると, 実行を行単位で進めます.
+ なお, 呼び出し先のメソッドがあったとしても, その呼び出し先のメソッドに入ることはありません.
+ この画像の場合では, ステップオーバーによって, D クラスの passB(B) メソッドの6行目から7行目へと実行が進んでいます.
+
+ 右下のブレークポイントビューの「ステップイン」アイコンをクリックすると, 実行をステートメント単位で進め,
+ 呼び出し先のメソッドがある場合はその呼び出し先のメソッドに入ります.
+ この画像の場合では, ステップインによって, 呼び出し先である B クラスの getC() メソッドへ入っています.
+
+ 右下のブレークポイントビューの「ステップリターン」アイコンをクリックすると, 呼び出し元のメソッドに復帰するまで実行を進めたうえで,
+ その呼び出し元のメソッド内で次のステートメントにまで進めます.
+ この画像の場合では, ステップリターンによって, 呼び出し元のメソッドである D クラスの passB(B) メソッドに復帰し,
+ 呼び出し元では B.getC() の次のメソッド呼び出しステートメントである E.setC(C) の直前にまで実行が進んでいます.
+
+ 右下のブレークポイントビューの「ステップネクスト」アイコンをクリックすると, 実行をステートメント単位で進めます.
+ 「ステップイン」とは違い, こちらは呼び出し先のメソッドがあったとしても, その呼び出し先のメソッドには入ることはありません.
+ 「ステップオーバー」では行単位で実行が進んでしまいますが, 「ステップネクスト」ではより細かいステートメント単位で同一メソッド実行内を進むことができます.
+ この画像の場合では, 現在のメソッド呼び出しステートメントである B.getC() の呼び出し先には入らずに,
+ そのまま次のメソッド呼び出しステートメントである E.setC(C) の直前にまで実行が進んでいます.
+
+ 右上の変数ビューでは, 現在見ているメソッド実行内から見える各オブジェクトのクラス名とIDが確認できます.
+ また, あるオブジェクトがフィールドとして別のオブジェクトを参照している場合は, そのオブジェクトの部分を開くことで,
+ フィールドと参照先のオブジェクトの関係を確認することもできます.
+ なお, ローカル変数が参照しているオブジェクトの情報については, 仮引数を除いてトレースファイルに記録されていないため表示されないことに注意してください.
+
+ また, 右上の変数ビューでは, 通常のデバッガとは異なり, 以下の特殊なケースの場合にも関連するオブジェクトが表示され, そのクラス名とIDが確認できます.
+