JPAを使うときの指針メモ

はじめに

JPAを使うときの指針メモです。

JPQLではなくCriteriaを使う

SQLを知っているとJPQLの方がとっつきやすいのですが、以下の理由からCriteriaを使ったほうがよさそうです。

CriteriaはDB変更に強い

JPQLはタイプセーフではないので、Entityクラス名や変数名が変わってもコンパイルエラーになりません。
対応箇所は自分で洗い出すか、動かしてエラーになるまでわかりません。
一方Criteriaは、Entityを変更した時点でコンパイルエラーになるので対応箇所がすぐにわかります。

JPQLをデバックするのは大変

SQLと違ってDBのコンソールで試すことが出来ないので、SQLの感覚で長いJPQLを書いてエラーになったらデバックするのがかなり大変です。
エラーメッセージとにらめっこする羽目になります。

コード例

JPQLのサンプル

// nameが"aaa aaa"のデータを検索
List<User> users = User.find("name", "aaa aaa").fetch();

Criteriaのサンプル

// nameが"aaa aaa"のデータを検索
Session session = (Session) JPA.em().getDelegate();
Criteria criteria = session.createCriteria(User.class);
criteria.add(Restrictions.eq("name", "aaa aaa"));
List<User> users =  criteria.list();

※サンプルコードはPlayFramework1.2系のものです。参考程度に見ていただき、実際の書き方は各FWのサイト等でご確認ください。

JPAからいきなりDTO（画面に表示するためのオブジェクト）にマッピングしようとしない

クエリの結果は単項目かEntityオブジェクトの形で受け取るのが普通です。
複数のEntityから任意の項目を取得したい場合、JPAでは単純なクエリを投げて、結果をEntityとして取得します。
複数Entityの情報が必要な場合は複数回クエリを投げて、ビジネスロジックでオブジェクトを操作してDTOに詰め直します。

慣れるまではSQLで書けば一発なのにムキー！となりますね。