ORMを使っているジュニアエンジニアに「なぜORMを使うのか」と聞くと、ほとんどの場合、次の2つの答えが返ってくる。
- 生産性が上がる。
- クエリを自動生成してくれるため、特定のDBMSへの依存度が下がる。
SQLマッパー(MyBatis)とJPA(Java界隈のORM)の両方を実務で使ってきた立場から、私はSpringの世界において、これらのメリットがチーム全体でJPAの高い学習コストを受け入れるほど強力なものなのか? という疑問を持っていた。
JPAをきちんと使いこなすには、基本的なN+1問題や、エンティティを管理する永続性コンテキストの役割を理解する必要がある。
複雑なクエリはどのみちSQLマッパーやネイティブクエリで処理するとしても、こうした概念を十分に理解していないメンバーが一人でもいれば、意図しないクエリが大量に発行され、障害につながる可能性がある。
さらに最近はAIがかなり上手にSQLを書いてくれる。そうなると、生産性を理由にORMを使おうという主張の説得力は弱まるのではないか?
そんな中、「AIがクエリを上手に書いてくれるのに、まだORMは必要なのか?」 というテーマの動画を見た。動画の結論はこうだった。クエリを代わりに書いてくれるのは、ORMが提供するメリットのごく一部に過ぎない。だからこそ、依然としてORMを使うべきだ、と。
確かに「生産性が上がるからORMを使おう」というよりはるかに説得力があったので、ORMがどのような価値を提供できるのかを整理してみた。
1. プロジェクト内のSQL XMLファイルがもたらす違和感
MyBatisを使っているプロジェクトを開くと、Javaコードの隣にmapper/*.xmlファイルが大量に並んでいる。最初は「SQLを一か所にまとめて管理できてすっきりしている」と感じるかもしれないが、プロジェクトが大きくなるにつれて、この構造からくる違和感は徐々に具体的な不便さへと変わっていく。
第一に、SQLは結局のところ文字列だ。 コンパイラはXML内のSQLをチェックしない。カラム名のタイポ、存在しないテーブル、パラメータ名の不一致といったミスは、アプリケーションを実行し、該当クエリが呼び出されたタイミングで初めて発覚する。
第二に、リファクタリングツールが届かない。 Javaのフィールド名はIDEで一括変更できるが、テーブルのカラム名が変わればXMLファイルを文字列検索して一つひとつ修正しなければならない。修正漏れはやはり実行時に発見される。
第三に、XMLがもう一つのプログラミング言語になってしまう。 動的クエリのために<if>、<choose>、<foreach>のようなタグを使い始めると、分岐や繰り返しといったロジックがJavaではなくXMLの中に積み上がっていく。
<select id="findOrders" resultMap="orderResultMap">
SELECT *
FROM orders
<where>
<if test="status != null">
AND status = #{status}
</if>
<if test="memberGrade == 'VIP'">
AND total_price >= 10000
</if>
<if test="excludeCanceled">
AND status != 'CANCELED'
</if>
</where>
</select>
memberGrade == 'VIP'のときは1万円以上の注文だけを表示する、というのはビジネスルールだ。しかしこのルールは、ビジネスロジックを担うバックエンドのJavaコードのどこにも存在しない。開発者はJavaとXMLを行き来しながら処理の流れを把握しなければならず、このロジックは単体テストで検証するのも難しい。
ORMを使えば、テーブルとオブジェクトのマッピングはエンティティクラスの一か所に集約され、検索条件もJavaコードで表現されるため、コンパイラとIDEの恩恵を余すことなく受けられる。
2. DBテーブルの変更履歴を追跡しやすい
テーブル構造の変更履歴を別のドキュメントで管理することもできる。しかし、人が手作業で管理するドキュメントはいつか必ず更新漏れが起きる。そして一度ずれ始めると、ドキュメントと実際のDBのどちらが正しいのか分からなくなり、元に戻すのが難しくなる。
ORMを使えば、テーブルの構造はエンティティというコードで表現される。
@Entity
@Table(name = "member")
public class Member {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@Column(nullable = false, length = 50)
private String name;
/**
* 休眠会員分離ポリシーの導入に伴い追加 (ISSUE-1234)
* nullの場合はアクティブ会員
*/
@Comment("休眠移行日時")
private LocalDateTime dormantAt;
}
コードなので、コメントでカラムの意図や変更の背景を残すことができ、何よりGitの管理対象になる。Gitで管理されるため、誰が、いつ、なぜこのテーブルを変更したのかを、コミットメッセージやPRレビューも含めて追跡できる。
もちろん、エンティティが実際のDBと完全に一致していると断言することはできない。それでも、DBテーブルの情報を別ドキュメントで管理するより扱いやすいという点には、共感してもらえるだろう。
3. オブジェクト指向なコードを書きやすい
もちろん、SQLマッパーを使っていても、テーブルに対応するオブジェクトを作り、そのオブジェクトが行える振る舞いをメソッドとして定義しておけば、十分にオブジェクト指向なコードを書くことはできる。
しかしSQLマッパーを使うと、ビジネスロジックが自然とクエリの中に紛れ込んでしまうコードをはるかに書きやすくなってしまう。
SQLマッパーでよく見かけるコード
注文キャンセルの条件として、次の2つの条件を満たす場合のみキャンセル可能だとしよう。
- 決済完了前であること。
- 決済後であれば配送前で、かつ注文から7日以内の注文のみキャンセルできる。
<update id="cancelOrder">
UPDATE orders
SET status = 'CANCELED',
canceled_at = NOW()
WHERE id = #{orderId}
AND status IN ('PENDING', 'PAID')
AND ordered_at >= DATE_SUB(NOW(), INTERVAL 7 DAY)
</update>
@Transactional
public void cancel(Long orderId) {
int updated = orderMapper.cancelOrder(orderId);
if (updated == 0) {
throw new IllegalStateException("注文をキャンセルできません。");
}
}
短くて効率的だが、問題がある。
cancel()メソッドを見ただけでは、キャンセル条件が何なのか分からない。 キャンセル条件はクエリのWHERE句の中に隠れている。
また、updated == 0のとき、注文が存在しないからなのか、すでに配送が始まっているからなのか、7日を過ぎたからなのか、失敗の原因を区別できない。 ユーザーに正確な案内をするには、結局もう一度検索クエリを投げる必要がある。
ORMを使うと
ORMを使うと、ビジネスルールはクエリではなくエンティティの中に置かれることになる。
@Entity
@Table(name = "orders")
public class Order {
private static final Duration CANCELABLE_PERIOD = Duration.ofDays(7);
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
@Enumerated(EnumType.STRING)
private OrderStatus orderStatus;
private LocalDateTime orderedAt;
private LocalDateTime canceledAt;
@Version
private Long version;
public void cancel(LocalDateTime now) {
if (!orderStatus.isCancelable()) {
throw new IllegalStateException("配送が開始された注文はキャンセルできません。");
}
if (orderedAt.plus(CANCELABLE_PERIOD).isBefore(now)) {
throw new IllegalStateException("注文から7日を過ぎたためキャンセルできません。");
}
this.orderStatus = OrderStatus.CANCELED;
this.canceledAt = now;
}
}
@Transactional
public void serviceLayerCancel(Long orderId) {
Order order = orderRepository.findById(orderId)
.orElseThrow(() -> new NoSuchElementException("存在しない注文です。"));
order.cancel(LocalDateTime.now(clock));
// トランザクションのコミット時にUPDATEクエリが実行される。
}
キャンセル条件はOrderエンティティのcancel()メソッド1か所に集約されており、メソッド名だけで「Orderエンティティが自らキャンセル可能かどうかを判断する」という意図が伝わる。失敗の原因も、それぞれ明確なメッセージで区別される。
サービス層は「Orderオブジェクトを取得してキャンセルさせる」という流れだけを担当することになる。
おわりに
AIがクエリを上手に書いてくれるという事実は、「SQLを書く手間」を減らしてくれるだけで、ビジネスルールをどこに置くべきかという問いには答えてくれない。ORMの本当の価値はクエリの自動生成ではなく、
- テーブルとオブジェクトのマッピングを、コンパイラとIDEが検証できるコードとして管理し、
- テーブル構造の変更履歴をコードとGitで追跡し、
- ビジネスルールをクエリではなくオブジェクトの中に置くよう自然に導いてくれる
という点にある。
ORMを使えばSQLを知らなくていい、というわけではない。複雑なクエリはSQLマッパーを併用して解決するのが現実的であり、N+1や永続性コンテキストへの理解は依然として必須だ。ただ、その学習コストを払う価値があるかと問われれば、今なら「クエリを書くため」ではなく「オブジェクト指向なコードを書くため」という理由で、そうだと答えられそうだ。