設計・テスト・レビュー

2026/10/15

Spring Bootで入力チェックが重複する｜ControllerとServiceの分け方

先に結論画面とAPIの両方に同じ重複チェックを書いているなら、メール重複などの業務判断をServiceへ集約します。必須・文字数・形式は各入口のForm／Requestで検証し、Controllerは結果をHTMLやJSONへ返します。同じ業務エラーでも、画面の項目エラーとAPIの409応答は分けて扱えます。登録画面とAPIを作ったら、メール重複のif文が両方にできた。Serviceへ移すと、今度は例外が画面へ表示されず500になる。この記事は、そのような入力チェックの重複とエラー応答の分け方を整理しま ...

設計・テスト・レビュー

2026/10/15

Spring BootのServiceに業務ロジックを書く理由

AIによる要約Spring BootのServiceは、業務処理やユースケースを表す中心的な場所です。Controllerに業務ロジックを書くと入口ごとに処理が散らばります。Serviceに寄せることで、再利用しやすく、テストしやすく、トランザクション境界も考えやすくなります。 Spring Bootの現場でよく言われるのが「業務ロジックはServiceに書きましょう」という話です。ただ、初学者にとっては、Controllerに書いても動くのに、なぜServiceへ移す必要があるのか分かりにくいかもしれ ...

設計・テスト・レビュー

2026/10/15

Spring Bootの@Transactionalはどこに付ける？

AIによる要約Spring Bootの@Transactionalは、基本的にRepositoryではなく、業務処理のまとまりを表すServiceメソッドに付けることが多いです。どこからどこまでを1つの更新単位にするかを決めるためのアノテーションであり、何となく付けるものではありません。 Spring BootでDB更新を扱うと、@Transactionalというアノテーションが出てきます。初学者は、とりあえずRepositoryや更新メソッドに付ければよいと考えがちですが、現場では「どこからどこまでを ...

設計・テスト・レビュー

2026/10/15

Spring BootのDTO変換はどこでやるべきか

AIによる要約Spring BootのDTO変換は、必ずController、必ずServiceと決まるものではありません。大事なのは、Entityを外へ直接出さず、画面/API用の形に変換することです。単純な変換はControllerやService、複雑な変換はMapperへ分けると読みやすくなります。 Spring Bootの現場では、Entityをそのまま画面やAPIに返さず、DTOへ変換することが多いです。しかし、DTO変換をどこに書くかは初学者が迷いやすいポイントです。Controllerに ...

設計・テスト・レビュー

2026/10/15

Spring BootのControllerでやってはいけないこと

AIによる要約Spring BootのControllerは、リクエストを受け取り、入力を確認し、Serviceを呼び出し、レスポンスを返す入口です。業務ロジック、DBアクセス、長い条件分岐、Entityの直接返却を詰め込むと、レビューで指摘されやすくなります。 Spring Bootを学び始めると、最初に触ることが多いのがControllerです。URLを受けて画面やJSONを返せるので、つい何でもControllerに書きたくなります。しかし現場では、Controllerが太くなるとレビューでかなり ...

設計・テスト・レビュー

2026/10/15

Javaのequalsをオーバーライドする注意点

AIによる要約Javaでequalsをオーバーライドするときは、単にIDEで生成すればよいわけではありません。何を同じとみなすのか、hashCodeと揃っているか、変更される値を比較に使っていないかを確認する必要があります。 equalsは、オブジェクト同士を「同じものとして扱うか」を決めるメソッドです。現場では、ID、コード値、注文番号など、業務上の同一性を表すクラスでよく話題になります。この記事のポイント equalsは同一判定のルールを表すオーバーライドするならhashCodeもセットで考える ...

設計・テスト・レビュー

2026/9/6

Cookie削除処理の例で見る、型安全と凝集性を意識したstaticメソッドの使い方

Cookie操作を例として、コードの修正案を提示します。今回のコードでは、責任の分担と修正に対する拡張性の確保を目指します。

設計・テスト・レビュー

2026/9/6

MockMvc#performのPOSTで複数のform情報を送信する方法

Springのテストをするときに使用するmockmvc#performで複数のフォーム情報を送信する場合の書き方2通りをメモ

設計・テスト・レビュー

2026/10/15

プログラミングにおいてJavaDoc/コードコメントの効果的な書き方について

このページに書いてあることこのページでちょろっと書いた、「意味のないコメント」についてさらに啓蒙が必要だと思ったので追記します。対象はJavaDocとコードコメントの両方です。関連記事プログラミングのバグや無駄を減らすために意識してほしいこと4つ文字列比較・マジックナンバー・定数・コメントについて、バグや無駄を減らすための見直しポイントを確認できます。記事を読む → 自分もハッピー、以後メンテナンスする人もハッピーになるためにプログラムを書く人の助けになれば。ちなみにコードレビュアーからの目線と ...

設計・テスト・レビュー

2026/9/6

Spring Framework初心者が知るべき考え方(ハリウッドの原則って何だ)

このページに書いてあること Springを使う時に（というか全てのフレームワークが大抵当てはまりますが）重要になる考え方を説明します。使い方とかではなくて、Frameworkの概念そのものといってもいいかもしれません。これを知っているのと知らないのでは、Springが動かないなんていうときの調査の効率が変わってきます。ハリウッドの原則ってなんだというところと、Spring Frameworkにどうか関わっているのかを見てみましょう。このブログ内でもいくつかSpringについての記事があるので、よけれ ...

« Prev 1 2 3 4 Next »