"おまじない"はもう卒業！ デバッガで探るSpring Bootの裏側と「学び方」の学び方

Transcript

1. "おまじない"はもう卒業！ デバッガで探るSpring Bootの裏側と「学び方」の学び方 2025/11/15 JJUG CCC 2025 Fall #jjug_ccc_i 竹内 雅和 (@tm0920.bsky.social)
2. 自己紹介 ・竹内 雅和 ・入社6年目 ・主にバックエンド担当 ・フロント/クラウドもちょっと触る ・Springの経験は3年くらい ・Bluesky：@tm0920.bsky.social ▪ 今回の資料 ↓
3. 目次 • 学びの停滞感について • ググっても解決しない問題との遭遇 • Springの基礎 • デバッグのコツ • まとめ
4. 学びの停滞感について • ”おまじない” • 「中級者への壁」
5. ”おまじない” • @Autowired をつけると DIされる • @Transactional をつけるとトランザクションできる • @Controller, @Service … • Service 層を実装するときは必ず IF を定義する
6. 「中級者への壁」 • なぜ動くのか、説明できない • チュートリアル レベルの学習は終えた。 • 応用的な実装や、原因不明のエラーに遭遇すると手が止まる。 • ググっても、自分のケースに合う答えがなかなか見つからない…。 次に何をどう学べば良いの？
7. ググっても解決しない問題との遭遇 • 一般的に想定されるアプリとDB • 今回のPJのアプリとDB • ググってみても…。 • Mapperから先の処理が全く分からない…。 • 挫折ポイント
8. 一般的に想定されるアプリとDB 接続先のDBは固定
9. 今回のPJのアプリとDB ユーザー毎に接続先のDBが違う
10. ググってみても…。 • AbstractRoutingDataSource というクラスを使うらしい…。 • 自分の環境では上手く動かない…。 • 記事に書いてある説明の内容が全く分からない…。 Datasource、SpringManagedTransaction …？？？
11. Mapper から先の処理が全く分からなかった
12. 背後に何かいる
13. ここを調べるには？
14. 挫折ポイント（普通にデバッグしても追えない） MapperはInterfaceで定義 このメソッドを実装しているクラス？
15. 挫折ポイント（普通にデバッグしても追えない） @Autowired で DIされて Mapperの実装クラスが入っているは ず。 ここにブレークポイント ＆ ステップイン すれば良いのでは？
16. 挫折ポイント（普通にデバッグしても追えない） UserMapperは…？ updateOne() は…？ invoke() なんて呼んでませ んけど…？
17. 挫折ポイント（普通にデバッグしても追えない） UserMapperは…？ updateOne() は…？ invoke() なんて呼んでませ んけど…？ 普通にデバッグしても追えない…
18. Springの基礎を知る • IoCとは • AOPとは • AOPを実現する仕組み
19. IoC とは ※ 参考：『Spring 徹底入門』(株式会社NTTデータ 著)
20. IoC とは ※ 参考：『Spring 徹底入門』(株式会社NTTデータ 著)
21. IoC とは ※ 参考：『Spring 徹底入門』(株式会社NTTデータ 著)
22. AOP とは ※ 参考：Spring AOP Tutorial for Beginners - Step by Step with Example https://www.javaguides.net/2019/05/understanding-spring-aop-concepts-and-terminology-with-example.html
23. AOP とは ※ 参考：Spring AOP Tutorial for Beginners - Step by Step with Example https://www.javaguides.net/2019/05/understanding-spring-aop-concepts-and-terminology-with-example.html
24. AOP とは ※ 参考：Spring AOP Tutorial for Beginners - Step by Step with Example https://www.javaguides.net/2019/05/understanding-spring-aop-concepts-and-terminology-with-example.html
25. AOP とは ※ 参考：Spring AOP Tutorial for Beginners - Step by Step with Example https://www.javaguides.net/2019/05/understanding-spring-aop-concepts-and-terminology-with-example.html
26. AOP とは
27. AOPとは ※ 参考：『Spring 徹底入門』(株式会社NTTデータ 著)
28. AOPを実現する仕組み ・IoCが管理するオブジェクト ( Bean )に対して、 AOPの実装を埋め込んでいる ・アプリからBeanを取得する時、Bean のインスタンスそのものではなく、 Proxyでラップされた状態で取得され る。 ・Beanの処理を呼ぶ時に Proxyを経由して、AOPの処理を実行 している。 ※ 参考：『Spring 徹底入門』(株式会社NTTデータ 著)
29. 仕組みを踏まえた上で処理を見ていく • Mapperから先の処理を見ていく • デバッグのコツ • デバッグを通して分かったこと
30. Mapperから先の処理を見ていく UserMapperは…？ updateOne() は…？ invoke() なんて呼んでませ んけど…？
31. Mapperから先の処理を見ていく UserMapperがラップされ たProxy Proxyのメソッドが呼ばれて る
32. デバッグのコツ • スタックトレースを読む • 変数を見る • ブレークポイントを貼ってみる • ステップ実行もしつつ繰り返して…
33. スタックトレースを読む
34. スタックトレースを読む
35. ブレークポイントを貼ってみる
36. 変数を見てみる
37. ステップ実行もしつつ繰り返して…
38. BaseExecutor の update() を呼び出す
39. SimpleExecutor の doUpdate() を呼び出す
40. SimpleExecutor の prepareStatement() を呼び出す
41. BaseExecutor の getConnection() を呼び出す
42. SpringManagedTransaction の getConnection() を呼び出す
43. SpringManagedTransaction の openConnection() を呼び出す
44. DataSourceUtils の getConnection() を呼び出す
45. DataSourceUtils の doGetConnection() を呼び出す
46. DataSourceUtils の fetchConnection() を呼び出す
47. HikariDataSource の getConnection() を呼び出す
48. HikariPool の getConnection()を呼び出す
49. HikariPool の getConnection()を呼び出す
50. PoolEntry の createProxyConnection()を呼び出す
51. ProxyFactory の getProxyConnection()を呼び出す
52. HikariProxyConnectionのインスタンスを生成 ※ 一旦、呼び出し元を辿って戻ります。
53. RoutingStatementHandler の update() を呼び出す
54. PreparedStatementHandler の update() を呼び出す
55. PreparedStatementLogger の execute() を呼び出す
56. ProxyPreparedStatement の execute() を呼び出す
57. JdbcPreparedStatement の execute() を呼び出す
58. Command の executeUpdate() が呼ばれてSQLが実行される
59. デバッグを通して分かったこと • Mapperのメソッドが呼ばれてからSQLが実行されるまでの処理の流れ。 • DBとの接続（Connection）は DataSource の実装クラスで行われていること。 ◦ AbstractRoutingDataSource は DataSource を実装した AbstractDataSourceを継承したクラス
60. 【まとめ】フレームワークの裏側を探る『学び方』 • 例外をわざと発生させて、スタックトレースを読む。 • IDEのステップ実行と変数を参照して 内部のコードを追っていく。 • 内部のコードを追った後だと、技術記事の理解度が格段に上がる！ • 「ステップアウト」で呼び出し元を辿って、 処理の流れを整理するのがオススメ。 • フレームワークの基礎的な設計思想を簡単に知っておくと デバッグしやすい。 • 「おまじないだから…」から少しずつ脱却していきましょう！
61. ご清聴ありがとうございました 質疑応答(例) • 前提知識として読んでおくと良い Springの公式ドキュメントや書籍？ • 効率的に「当たり」をつけるためのコツ？ （何でもどうぞ…！） （アンケートも書いてほしい…🙏→） 今回の資料 ↓ 全体アンケート↓　セッションアンケート↓