変更差分の確認と完了条件

変更差分を確かめる

Eclipse の「Git ステージング」ビューで差分を確かめます。

  • 更新した座標とバージョンが、バージョンページの候補どおりである
  • バージョンページの別々の候補(系列)が混ざっていない
  • 書き換えは利用箇所に限られ、業務ロジックを不用意に変えていない
  • 設定の変更は理由を説明できる
  • 外部のリポジトリ・デバッグ用の設定・検査を外すコードを足していない
  • 確かめるために出力したファイル(dependency-tree-*.txt など)をコミットしていない

完了条件

環境

  • Java・ビルドツール・IDE が、正式に採用しているバージョンで、更新先が求めるバージョン以上である
  • 社内のリポジトリから更新先のバージョンを取得できる

依存関係

  • 対象のライブラリと関連モジュールが、更新先のバージョンにそろっている
  • 古いバージョン・古い座標・新旧の名前空間が混在していない
  • WAR に入った JAR を確かめた

コードと設定

  • バージョンページの「この経路でやること」の「該当」をすべて行い、「未確認」は確かめた結果を記録した
  • 設定・入力の上限・例外の応答・リソースの解放を確かめた

ビルドとテスト

  • コンパイル・テスト・パッケージが成功する
  • 更新前とテストの件数・失敗・スキップを比べた
  • 再スキャンの結果と残ったリスクを記録した

共通手順書の章

  1. 作業の全体像
  2. 開発環境と前提
  3. 作業前の準備
  4. 更新前の記録
  5. 利用箇所の調べ方
  6. 依存定義の更新
  7. IDE への反映
  8. 解決されたバージョンの確認
  9. コンパイルエラーの切り分け
  10. import の一括置き換え(javax → jakarta)
  11. 非推奨の警告の扱い
  12. 概算工数の出し方
  13. リソースの解放と入力の安全性
  14. ビルド・テスト・WAR の確認
  15. 他の JAR に同梱された複製
  16. 再スキャン
  17. 変更差分の確認と完了条件
  18. ロールバックと作業記録
  19. 検証環境等への配備