Newer
Older
TraceDebuggerExperiment / courseB / JHotDraw_Forward / problem1 / JHotDraw1_Forward.html
r-isitani on 9 Sep 2020 15 KB 実験シナリオを仮作成
<!DOCTYPE HTML>
<html lang = "ja">
    <head>
        <title>課題A1 (JHotDraw)</title>
        <meta charset = "UTF-8">
        <link rel = "stylesheet" type = "text/css" href = "../../../prettify.css">
    </head>
    <body>
        <h1>課題A1</h1>
        <p>
            課題A1では, JHotDrawの図形の移動機能について見ていきます.<br>
            JHotDrawはオープンソースの図形描画ツールで, Javaで書かれております.<br>
            ワークスペース内のjhotdraw7が、JHotDrawを構成するプロジェクトです。
        </p>

        <hr>
        <h2>実行手順</h2>
        <p>
            <ol>
                <li class = "explanation">
                    デスクトップのEclipseを起動し, 指定されたワークスペースを開いてください.
                    <div class = "image"><img src = "./images_problem1_pre/JHotDraw_1_pre_01.png" class = "threeQuartersSize"></div>
                </li>
                <li class = "explanation">
                    ワークスペース中にあるjhotdraw7プロジェクトを選択し, メニューバーの Search → Java で DefaultDragTracker というタイプの宣言を検索してください.
                    <div class = "image"><img src = "./images_problem1_pre/JHotDraw_1_pre_02.png" class = "threeQuartersSize"></div>
                    <div class = "image"><img src = "./images_problem1_pre/JHotDraw_1_pre_03.png" class = "quarterSize"></div>
                </li>
                <li class = "explanation">
                    DefaultDragTrackerクラスのソースファイルを開いて159行目 (DefaultDragTracker#mouseDragged(MouseEvent)) にブレークポイントを入れてください.
                    <div class = "image"><img src = "./images_problem1_pre/JHotDraw_1_pre_04.png" class = "threeQuartersSize"></div>
                </li>
                <li class = "explanation">
                    メニューバーの Window → Perspective → Open Perspective → Other... → トレースデバッガ(順方向) でトレースデバッガのパースペクティブを開いてください.
                    <div class = "image"><img src = "./images_problem1_pre/JHotDraw_1_pre_05.png" class = "threeQuartersSize"></div>
                    <div class = "image"><img src = "./images_problem1_pre/JHotDraw_1_pre_06.png" class = "halfSize"></div>
                </li>
                <li class = "explanation">
                    開いたトレースデバッガのパースペクティブ右上のブレークポイントビュー上にあるフォルダアイコン(左から1番目)を<br>
                    クリックしてトレースファイル(jHotDrawBenchMarkWithMoreStandardClasses.trace)を開いてください.
                    <div class = "image"><img src = "./images_problem1_pre/JHotDraw_1_pre_07.png" class = "threeQuartersSize"></div>
                    <div class = "image"><img src = "./images_problem1_pre/JHotDraw_1_pre_08.png" class = "halfSize"></div>
                </li>
                <li class = "explanation">
                    トレースファイルの読み込みが終わるまで待ってから, ブレークポイントビュー上にある「ブレークポイントをEclipseから取り入れる」アイコン(左から2番目)を<br>
                    クリックしてトレースデバッガ用のブレークポイントを作成してください.
                    <div class = "image"><img src = "./images_problem1_pre/JHotDraw_1_pre_09.png" class = "threeQuartersSize"></div>
                </li>
                <li class = "explanation">
                    ブレークポイントビュー上にあるデバッグアイコン(左から3番目)をクリックしてください.<br>
                    トレースデバッガによるデバッグ実行が起動し, ブレークポイントを入れた位置の行が選択された状態で一時停止します.
                    <div class = "image"><img src = "./images_problem1_pre/JHotDraw_1_pre_10.png" class = "threeQuartersSize"></div>
                </li>
            </ol>
        </p>

        <hr>
        <h2>課題A1</h2>
        <p>
            <!--
            Fig クラスはグラフィックエディタ上の図形を表すGEFの内部のクラスです.<br>
            また, FigClass クラスはクラス図上に配置された「クラス」を表す JHotDraw のクラスで, Fig クラスの子孫クラスにあたります.<br>
            -->
            ブレークポイントを置いた行は、図形を移動するたびに実行されます.
        </p>

        <p>
            <p class = "explanation">
                先ほどの実行手順にしたがって進めていくと, 下図のように DefaultDragTracker クラスの<br>
                mouseDragged(MouseEvent) メソッド内の159行目で一時停止している状態になっているはずです.<br>
                この状態になっていれば, ここから時間計測を開始してください.<br>
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_01.png" class = "threeQuartersSize"></div>
            </p>
            <p class = "explanation">
                DefaultDragTracker クラスの mouseDragged(MouseEvent) メソッドの159行では,<br>
                ローカル変数 f で参照されているインスタンスに対してメソッドが呼び出されていることが確認できます.<br>
                ここで, 変数ビュー上の「呼び出し前」を開いてレシーバのIDを見ると, これは RectangleFigure クラスのインスタンス (id = 1952912699) であることがわかります.<br>
                また, ソースコードを見ると, このローカル変数 f の値は, 157行目の拡張for文でフィールド transformedFigures が取得してきたものだと確認できます.
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_02.png" class = "threeQuartersSize"></div>
            </p>
            <p class = "explanation">
                次は, フィールド transformedFigures に RectangleFigure クラスのインスタンス (id = 1952912699) を実際に追加しているのはどこなのかを見ていきます.<br>
                ソースコード中の157行目の transformedFigures にカーソルを入れ, そのフィールドに対してオブジェクトを追加している全ての行にブレークポイントを入れてください.<br>
                今回は DefaultDragTracker クラスの118行目のみです。
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_03.png" class = "threeQuartersSize"></div>
            </p>
            <p class = "explanation">
                ここで, いったんデバッグ実行を終了してから, ブレークポイントビュー上にある「ブレークポイントを取り入れる」ボタンを押してください.<br>
                そのあと, 再びデバッグ実行すると今度は118行目に止まります.<br>
                ステップインを2回押してから変数ビュー上の「呼び出し前」を開いて引数のオブジェクトのIDを確認してください.<br>
                すると, 先ほど確認した RectangleFigure クラスのインスタンス (id = 1952912699) がここで追加されていることがわかります.<br>
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_05.png" class = "threeQuartersSize"></div>
            </p>
            <p class = "explanation">
                ここで, 最初にブレークポイントを入れた地点である159行目に実行が進むかどうかを確認します.<br>
                再開ボタンを1回押すと, すぐには159行目に移らず, 同じ118行目に再び止まります.<br>
                先ほどと同様に変数ビューを開いて引数のオブジェクトのIDを確認してください.<br>
                すると, ここでも同じ RectangleFigure クラスのインスタンス (id = 1952912699) が追加されていることがわかります.<br>
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_06.png" class = "threeQuartersSize"></div>
            </p>
            <p class = "explanation">
                再び再開ボタンを押すと, 今度は159行目に止まります.<br>
                ここで, 変数ビューの「呼び出し前」を開いてレシーバのIDを見ると, 先ほどの RectangleFigure クラスのインスタンス (id = 1952912699) と同一であることが確認できます.<br>
                したがって, ここでは直前に止まっていた2回目の118行目で追加した RectangleFigure を取得していることがわかります.<br>
                それを確認したら, ここでいったんデバッグ実行を終了してください.
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_07.png" class = "threeQuartersSize"></div>
            </p>
            <p class = "explanation">
                ソースコードを見ると, 116行目の拡張for文で DrawingView クラスの getSelectedFigures() を呼び出し, <br>
                その戻り値のコレクションから取得してきた RectangleFigure クラスのインスタンスを, 118行目で selectedFigures に追加していることがわかります.<br>
                そこで, 次はこの view がどこから来たのかと, getSelectedFigures() メソッドの戻り値がどうなっているのかを見ていきます.<br>
                98行目と116行目にブレークポイントを入れ, ブレークポイントビュー上にある「ブレークポイントを取り入れる」ボタンを押してください.<br>
                そのあと, 再びデバッグ実行すると, まずは98行目で止まることをを確認してください.
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_08.png" class = "threeQuartersSize"></div>
            </p>
            <p class = "explanation">
                先ほどの実行によって, 現在は98行目に止まっているはずです.<br>
                この状態で再開ボタンを押していくと, 現在の実行時点が 116行目 → 118行目 → 98行目 → 116行目 → 118行目と移り変わることを確認してください.<br>
                この操作によって, 98行目と116行目と118行目はそれぞれ2回ずつ実行されていることが確認でき, したがって, 2回目に止まった方が直前に実行されたものだとわかります.<br>
                ここでいったんデバッグ実行を終了して下さい.
            </p>
            <p class = "explanation">
                そのままの状態で再びデバッグ実行し, 再開ボタンを3回押して2回目の98行目に止まって下さい.<br>
                ここで, ステップインを1回押して getView() メソッドの中に入ってください.
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_09.png" class = "threeQuartersSize"></div>
            </p>
            <p class = "explanation">
                AbstractTool クラスの getView() メソッドに入りました.<br>
                ここで, 変数ビュー上の this を開くと, DefaultDragTracker クラスのインスタンス(id = 758826749) が<br>
                フィールド editor として DefaultDrawingEditor クラスのインスタンス (id = 1859859960) を保持していることがわかります.<br>
                これを確認したら, ステップインを3回押して getActiveView() メソッドの中に入ってください.
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_10.png" class = "threeQuartersSize"></div>
            </p>
            <p class = "explanation">
                DefaultDrawingView クラスの getActiveView() メソッドに入りました.<br>
                ここで, 変数ビュー上の this を開くと, DefaultDrawingEditor クラスのインスタンス (id = 1859859960) が<br>
                フィールド activeView として DefaultDrawingView クラスのインスタンス (id = 150367587) を保持していることがわかります.<br>
                これを確認したら, ステップリターンを1回押して呼び出し元に戻ってください.<br>
                (このとき, 2つ呼び出し元である DefaultDragTracker クラスの mousePressed(MouseEvent) メソッドまで戻ることに注意してください)
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_11.png" class = "threeQuartersSize"></div>
            </p>
            <p class = "explanation">
                先ほどの操作によって, 現在の実行時点は DefaultDragTracker クラスの mousePressed(MouseEvent) メソッドの106行目になっているはずです.<br>
                ここでは, ステップオーバーを4回押して116行目まで進んでください.<br>
                116行目まで進んだら, 変数ビュー上の「呼び出し前」を開いて, レシーバのオブジェクトのIDを見ると, <br>
                先ほど取得してきた DefaultDrawingView クラスのインスタンス (id = 150367587) に対して getSelectedFigures() メソッドが呼び出されていることがわかります.<br>
                これを確認したら, ステップインを1回押して, このメソッドの中に入ってください.
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_12.png" class = "threeQuartersSize"></div>
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_13.png" class = "threeQuartersSize"></div>
            </p>
            <p class = "explanation">
                DefaultDrawingView クラスの getSelectedFigures() メソッドの中に入りました.<br>
                ここで, 変数ビュー上の this を開くと, DefaultDrawingView クラスのインスタンス (id = 150367587) が<br>
                フィールド selectedFigures として LinkedHashSet を保持していることがわかります.<br>
                また, ソースコードを見ると, Collections クラスの static メソッドである unmodifiableSet(Set) が呼び出されており,<br>
                その引数として フィールド getSelectedFigures が渡されていることが確認できます.<br>
                これを確認したら, 呼び出しスタック上で1つ呼び出し元をクリックしてください.
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_14.png" class = "threeQuartersSize"></div>
            </p>
            <p class = "explanation">
                現在は DefaultDragTracker クラスの mousePressed(MouseEvent) メソッドの116行目を見ています.<br>
                ここで課題A1は終了です. 時間計測を終了してください.
                <div class = "image"><img src = "./images_problem1/JHotDraw_1_15.png" class = "threeQuartersSize"></div>
            </p>
        </p>
    </body>
</html>