単体テストの始め方/作り方

JJUG CCC 2025 Spring の発表資料
https://ccc2025spring.java-users.jp/

Zennの記事: https://zenn.dev/toms74209200/articles/first-step-unit-testing

# 参考文献

- 単体テストの考え方/使い方 プロジェクトの持続可能な成長を実現するための戦略, Vladimir Khorikov, 須田 智之, マイナビ出版, 2022 http://book.mynavi.jp/ec/products/detail/id=134252
- テスト駆動開発, Kent Beck, 和田 卓人, オーム社, 2017 https://www.ohmsha.co.jp/book/9784274217883/
- Googleのソフトウェアエンジニアリング―持続可能なプログラミングを支える技術、文化、プロセス, Titus Winters, Tom Manshreck, Hyrum Wright, 竹辺 靖昭, 久富木 隆一, オライリー・ジャパン, 2021 https://www.oreilly.co.jp/books/9784873119656/

Transcript

1. Toms(@toms74209200) 単体テストの始め方/作り方 JJUG CCC 2025 Spring 2025-06-07
2. パクリ・・・？ ʰ୯ମςετͷߟ͑ํ࢖͍ํʱ7MBEJNJS
   ,IPSJLPW
   ਢాஐ೭
   ϚΠφϏग़൛
3. Toms(@toms74209200) 株式会社アジェンダ（＠札幌） 基板からWebフロントエンドまでできる フルスタックエンジニア 自キ活はいいぞ whoami
4. とある開発現場・・・ 予約注文機能を追加しておいて🙋 • 通常の商品は在庫を確認して注文（既存仕様） • 予約注文の商品は在庫を確認しないで注文
5. まずは現行のコードを見てみよう public Order processOrder(OrderRequest request) throws InvalidOrderException, Insuff i cientStockException { Product product = productRepository.f i ndByCode(request.productCode()).orElse(null); if (product = = null) { throw new InvalidOrderException("ଘࡏ͠ͳ͍঎඼ίʔυͰ͢ɻ"); } if (request.quantity() > product.stock()) { throw new Insuff i cientStockException("ࡏݿ͕ෆ଍͍ͯ͠·͢ɻ"); } return orderRepository.save(new Order(request.productCode(), request.quantity())); }
6. public Order processOrder(OrderRequest request) throws InvalidOrderException, Insuff i cientStockException { Product product = productRepository.f i ndByCode(request.productCode()).orElse(null); if (product = = null) { throw new InvalidOrderException("ଘࡏ͠ͳ͍঎඼ίʔυͰ͢ɻ"); } if (request.quantity() > product.stock()) { throw new Insuff i cientStockException("ࡏݿ͕ෆ଍͍ͯ͠·͢ɻ"); } return orderRepository.save(new Order(request.productCode(), request.quantity())); } 商品コードから商品を検索 在庫の確認 注文を登録 まずは現行のコードを見てみよう
7. public Order processOrder(OrderRequest request) throws InvalidOrderException, Insuf fi cientStockException { Product product = productRepository. fi ndByCode(request.productCode()).orElse(null); if (product == null) { throw new InvalidOrderException("ଘࡏ͠ͳ͍঎඼ίʔυͰ͢ɻ"); } + if (product.isReservation()) { + return orderRepository.save(new Order(request.productCode(), request.quantity(), OrderType.RESERVATION)); + } if (request.quantity() > product.stock()) { throw new Insuf fi cientStockException("ࡏݿ͕ෆ଍͍ͯ͠·͢ɻ"); } + return orderRepository.save(new Order(request.productCode(), request.quantity(), OrderType.NORMAL)); } 予約注文機能を追加してみる できた🎉🎉🎉🎉🎉🎉🎉
8. public Order processOrder(OrderRequest request) throws InvalidOrderException, Insuf fi cientStockException { Product product = productRepository. fi ndByCode(request.productCode()).orElse(null); if (product == null) { throw new InvalidOrderException("ଘࡏ͠ͳ͍঎඼ίʔυͰ͢ɻ"); } + if (product.isReservation()) { + return orderRepository.save(new Order(request.productCode(), request.quantity(), OrderType.RESERVATION)); + } if (request.quantity() > product.stock()) { throw new Insuf fi cientStockException("ࡏݿ͕ෆ଍͍ͯ͠·͢ɻ"); } + return orderRepository.save(new Order(request.productCode(), request.quantity(), OrderType.NORMAL)); } テストも書いて🙋 🤔 どうやって？
9. まずはテストを書こう
10. まずはテストを書こう 🤔 どうやって？
11. テスト駆動開発 • コードを書く前に、失敗する自動テストコードを必ず書く。 • 重複を除去する。 ʰςετۦಈ։ൃʱ,FOU
    #FDL
    ࿨ా
    ୎ਓ
    ΦʔϜࣾ
12. テスト駆動開発 まずは日本語でテストケースを書いてみよう 予約商品を注文すると予約される これだけでOK🙆
13. テスト駆動開発 AAAパターン • Arrange（準備） • Act（実行） • Assert（確認） ʰ୯ମςετͷߟ͑ํ࢖͍ํʱ7MBEJNJS
    ,IPSJLPW
    ਢాஐ೭
    ϚΠφϏग़൛
14. テスト駆動開発 AAAパターン • Arrange（準備）：注文商品が予約商品 • Act（実行）：注文をする • Assert（確認）：予約注文として登録されるか ③ ActとAssertを満たすように ① 最も簡単なActから書く ② 検証したいことを確認
15. テスト駆動開発 AAAパターン / / Arrange: ஫จ঎඼͕༧໿঎඼ Product product = new Product(); product.setIsReservation(true); / / Act: ஫จΛ͢Δ orderService.processOrder(new OrderRequest(product.getProductCode(), 1); / / Assert: ༧໿஫จͱͯ͠ొ࿥͞ΕΔ͔ List<Order> orders = orderRepository.f i ndByProductCode(product.getProductCode()); assertThat(orders.get(0).getStatus()).isEqualTo(OrderType.RESERVATION); テストコードと日本語のコメントが1:1で対応する
16. / / Arrange: ஫จ঎඼͕༧໿঎඼ Product product = new Product(); product.setIsReservation(true); / / Act: ஫จΛ͢Δ orderService.processOrder(new OrderRequest(product.getProductCode(), 1); / / Assert: ༧໿஫จͱͯ͠ొ࿥͞ΕΔ͔ List<Order> orders = orderRepository.f i ndByProductCode(product.getProductCode()); assertThat(orders.get(0).getStatus()).isEqualTo(OrderType.RESERVATION); テスト駆動開発 AAAパターン 🤔 このままだと動かない Productはどうやってわたす？
17. テストのふるまいは入力と出力が決める テスト対象 入力：引数 出力：戻り値 隠れた入力 隠れた出力
18. 隠れた入力と隠れた出力 • 隠れた入力 • 時刻 • 状態 • 外部プロセス：HTTPリクエスト・DBアクセス • 隠れた出力 • 状態 • 外部プロセス: System.out.println
19. 隠れた入力と隠れた出力をテストするには？ 1. 公開する 
 状態を返す 
 戻り値として返す 2. テストダブルを使う 
 依存関係注入（DI:Dependency Injection）
20. リファクタリングして・・・できた🎉🎉🎉🎉🎉🎉🎉 / / Arrange: ஫จ঎඼͕༧໿঎඼ OrderRequest orderRequest = setupAndOrderReservationProductWithDefaultQuantity(); OrderService orderService = OrderServiceFactoryForTest.createOrderService(); / / Act: ஫จΛ͢Δ Order order = orderService.order(orderRequest); / / Assert: ༧໿஫จͱͯ͠ొ࿥͞ΕΔ verifyOrderIsReservationProduct(order);
21. / / Arrange: ஫จ঎඼͕༧໿঎඼ OrderRequest orderRequest = setupAndOrderReservationProductWithDefaultQuantity(); OrderService orderService = OrderServiceFactoryForTest.createOrderService(); / / Act: ஫จΛ͢Δ Order order = orderService.order(orderRequest); / / Assert: ༧໿஫จͱͯ͠ొ࿥͞ΕΔ verifyOrderIsReservationProduct(order); わかりにくいのでやり直し 🙅
22. テストはDRYよりDAMP(Descriptive And Meaningful Phrases) テストはより説明的に String productCode = "product123"; Product product = new Product(); product.setPreOrder(true); product.setCode(productCode); when(inventoryRepository.f i ndByCode(productCode)) .thenReturn(product);
23. わかりやすい検証を選ぶ assertThat(actualOrderIds.get(0)) .isEqualTo(expectedOrderId); assertThat(actualOrderIds).contains(expectedOrderId); NG🙅 OK🙆
24. まとめ • まずはテストコードから • AAAパターンを日本語で考えよう • 入力と出力・隠れた入力と隠れた出力を分けて考えよう • わかりやすいテストコードを書こう • DRYよりDAMP • わかりやすい検証を選ぶ