Fork: 0
nitta-lab / pushpullRefactoringExperiments
Transfer to URL with SHA Find file
Newer
Older
pushpullRefactoringExperiments / courseA / ProblemA1.html
Naoya Nitta on 12 Aug 2022 7 KB リファクタリングの作業内容の文言修正．
Raw Blame History 
  1. <!DOCTYPE HTML>
  2. <html lang="ja">
  3. <head>
  4.     <title>課題A1</title>
  5.     <meta charset="UTF-8">
  6.     <link rel = "stylesheet" type = "text/css" href = "../prettify.css">
  7. </head>
  8. <style>
  9.     .image_size{
  10.         width: 800px;
  11.         height: 550px;
  12.     }
  13. </style>
  14. <body>
  15. <h1>課題A1</h1>
  16.  
  17. <hr size="5">
  18.  
  19. <h2>課題の概要</h2>
  20.  
  21. <p>
  22.     課題A1では，StockManagement の Handling から Shipping へのデータ転送について見ていきます．
  23.     Handling は，ユーザの入力（搬入または出庫依頼）に対する処理をまとめたクラスで，Shippingは出庫の指示を表すクラスです．<br>
  24.     この課題では，
  25.  
  26.     <blockquote>
  27.         <strong>「Handling の情報が更新されたときにその情報を Shipping にPUSH型で転送しているプログラムを，PULL型で転送するようにリファクタリングすること」</strong>
  28.     </blockquote>
  29.  
  30.     を目的とします．<br>
  31.     リファクタリングの詳しい作業手順は以下で説明します．
  32. </p>
  33.  
  34. <hr size="5">
  35.  
  36. <h2>リファクタリング作業</h2>
  37.  
  38. <p>
  39.     以下では，リファクタリングに要した時間を測っていただきますので，お手元に時計をご用意ください．<br>
  40.     時間計測にあたって，急いで作業していただく必要はまったくありません．<br>
  41.     最初の課題から最後の課題まで一定のペースを保てるよう, <font color="red">正しくリファクタリングを行うこと</font>を意識してください．<br>
  42.     この課題で作業していただく内容は，
  43.     <blockquote>
  44.         <strong>「Handling の情報が更新されたときにその情報を Shipping にPUSH型で転送しているプログラムを，PULL型で転送するようにリファクタリングすること」</strong>
  45.     </blockquote>
  46.     です．<br>
  47.     開発環境を立ち上げてソースコードの確認をしていただいて構いませんが，ソースコードの変更は時間計測の準備ができるまで行わないで下さい．<br>
  48.     リファクタリングの作業手順を以下に説明します．
  49. </p>
  50. <p>
  51.     まず，現時点での Handling から Shipping へのデータ転送に関するクラス図とシーケンス図を以下に示します．<br>
  52.     <img src="../images/stock_class_push.jpg" class = "halfSize">
  53.     <img src="../images/stock_seq_push.jpg" class = "halfSize"><br>
  54.     現時点ではPUSH型のデータ転送で実装されているため，Handling クラスの updateAvailable() メソッドと，updateRequest() から Shipping クラスの updateHandling() メソッドを呼び出すために Handling クラスが Shipping クラスを参照しています．<br>
  55.     ここで StockManagement クラスは，初期化時に Handling クラスや Shipping クラスのインスタンスを生成し，それらのインスタンスを関連付ける役割を担っています．<br>
  56.     また，Handling クラスや Shipping クラスにアクセスするための入口（Facade）としての役割も担っています．<br>
  57.     StockManagement，Handling，Shipping クラスのいずれも resources パッケージの中に入っています．<br>
  58. </p>
  59. <p>
  60.     これを，以下のクラス図とシーケンス図に示すようなPUSH型のデータ転送になるよう，手作業でリファクタリングを行っていただきます．<br>
  61.     <img src="../images/stock_class_pull.jpg" class = "halfSize">
  62.     <img src="../images/stock_seq_pull.jpg" class = "halfSize"><br>
  63.     今度はPULL型のデータ転送であるため，Shipping クラスの getValue() メソッドから Handling クラスの getValue() メソッドを呼び出すために Shipping クラスが Handling クラスを参照していることに注意してください．<br>
  64. </p>
  65. <p>
  66.     リファクタリングの作業手順の詳細を以下に示します．<br>
  67.     <ol>
  68.     <li>テストプログラムを実行して正しく動作することを確認する．</li>
  69.     <li>Shipping クラスに，Handling クラスのインスタンスを参照するフィールド Handling handling を追加する．</li>
  70.     <li>Shipping クラスに，Handling クラスのインスタンスを引数に取るコンストラクタを追加する．</li>
  71.     <li>Handling クラスのコンストラクタを，Shipping クラスのインスタンスを引数に取らないように書き換える．</li>
  72.     <li>Handling クラスのフィールド shipping を削除する．</li>
  73.     <li>StockManagement クラスのコンストラクタ内で，Shipping クラスのインスタンスが Handling クラスのインスタンスを参照するよう，インスタンスの生成順や生成方法を変更する．</li>
  74.     <li>Shipping クラスの出庫指示の内容を保存するためのフィールド Item value を削除する．</li>
  75.     <li>Handling クラスの updateAvailable() メソッドと updateRequest() メソッドの最後の Shipping クラスの updateHandling() メソッドの呼び出し文を削除する．</li>
  76.     <li>Shipping クラスの getValue() メソッドを Handling クラスの getValue() メソッドを呼び出すように書き換える．</li>
  77.     <li>Shipping クラスの updateHandling() メソッド内で行っていた，ユーザの入力に対する処理内容(ItemHandling)をもとに出庫指示の内容(Item)を作成する処理を，getValue() メソッドに移動し，出庫指示の内容を getValue() メソッドの戻り値として返すようにする．</li>
  78.     <li>Shipping クラスの void updateHandling(ItemHandling handling) メソッドを削除する．</li>
  79.     <li>テストプログラムを実行して正しく動作することを確認する．</li>
  80.     </ol>
  81. </p>
  82. <p>
  83.     作業に着手する前に，メッセージでお伝えした自分専用のブランチ（user??）を切って，一度プッシュを行ってください．<br>
  84.     プッシュを行った後，開発環境の準備ができれば，<font color="red">時間計測を開始</font>してください. 時間計測はできる限り，30秒以内の単位での計測をお願いします. <br>
  85.     テストプログラムが正しく動作するまでは作業完了とは見なされないので注意してください．
  86. </p>
  87.  
  88. <p>
  89.     リファクタリングの作業が完了したら作業時間を記録し，その後，作業結果を自分専用のブランチにコミット＆プッシュしてください．<br>
  90.     ただし，<font color="red">main ブランチには決してマージをしないように，また自分専用のブランチを決して削除しないように</font>注意してください． <br>
  91.     プッシュ後に，以下のアンケートにお答えください．
  92. </p>
  93.  
  94. <blockquote>
  95.     <a href="https://docs.google.com/forms/d/e/1FAIpQLScnswXih-4nrtlit5vfdhouSLpM4nbMorZksfUP754ufmyOjA/viewform?usp=sf_link" target="_blank">アンケート回答</a>
  96. </blockquote>
  97.  
  98. <hr size="5">
  99.  
  100. <p style="margin-bottom:2em;"></p>
  101. <a href="DescriptionAlgolike.html">次へ</a>
  102. </body>