SimpleORM4J

概要

このページでは、SimpleORM4Jを使用した検索処理（SELECT）に関してご説明をしていきます。
リレーショナルデータベースへの検索処理で登場するクラスは以下になります。

また、SELECT処理で使用する「Criteria」クラスのメソッドは以下になります。

いくつかのメソッドを使用した処理の流れは以下になります。

try {
	// エンティティマネージャを生成
	EntityManager em = EntityManagerFactory.createEntityManager();
	// クライテリアを取得
	Criteria criteria = em.getCriteria();
	// クエリ内容の作成
	criteria.select(
				Department.class.getDeclaredField("id"),
				Department.class.getDeclaredField("name"),
				Department.class.getDeclaredField("schoolId"))
		  .from(Department.class)
		  .join(JoinType.LEFT, School.class,
			  Expression.equal(School.class.getDeclaredField("id"), Department.class.getDeclaredField("schoolId")))
		  .where(Expression.equal(School.class.getDeclaredField("id"), ":id"));
	// クエリを生成
	Query query = em.createQuery(criteria);
	// パラメータ設定
	query.setParameter("id", 1);
	// クエリ発行
	List<Department> resultList = (List<Department>) query.getResultList();
	System.out.println(resultList);
} catch (Exception e) {
	e.printStackTrace();
}

クエリ内容の作成（Criteria）

SimpleORM4JでのSELECT処理で使用するCriteriaクラスのメソッドに関してご説明をしていきます。
Criteriaで設定した内容がリレーショナルデータベースに問い合わせされます。
また、Criteriaメソッドは自インスタンを返却しますので、メソッドチェーンでの指定が可能です。

selectメソッド

検索フィールドを指定するメソッドです。
指定できるものは以下になります。

• エンティティクラス
• エンティティクラスのフィールド
• 式表現（Expression）※ 集約関数式・別名式に限られます

■ エンティティクラスの指定
criteria.select(School.class)

■ エンティティクラスのフィールド指定例
criteria.select(
		Department.class.getDeclaredField("id"),
		Department.class.getDeclaredField("name"),
		Department.class.getDeclaredField("schoolId"))

■ 式表現（Expression）指定例
criteria.select(
		Expression.as(Expression.count("*"), "CNT"),
		Expression.as(Expression.count(School.class.getDeclaredField("id")), "CNT_SCHOOL"),
		Expression.as(Expression.sum(School.class.getDeclaredField("id")), "SUM_SCHOOL"),
		Expression.as(Expression.avg(School.class.getDeclaredField("id")), "AVG_SCHOOL"),
		Expression.as(Expression.max(Department.class.getDeclaredField("schoolId")), "MAX_SCHOOL"),
		Expression.as(Expression.min(Subject.class.getDeclaredField("departmentId")), "MIN_DEPARTMENT"))

リレーショナルデータベースのROWデータがマッピングされるクラスですが、selectメソッドでの指定によって判定がされます。

fromメソッド

SELECT対象のテーブルを指定します。

■ 指定例
criteria.from(School.class)

joinメソッド

joinメソッドは、結合テーブルとその結合方法、結合条件を指定します。

■ 指定例
criteria.from(School.class)
    	  .join(JoinType.INNER, Department.class,
			  Expression.equal(School.class.getDeclaredField("id"), Department.class.getDeclaredField("schoolId")))
    	  .join(JoinType.INNER, Subject.class,
			  Expression.equal(Department.class.getDeclaredField("id"), Subject.class.getDeclaredField("departmentId")))

whereメソッド

検索条件（行条件）を指定します。
さまざまな式表現（Expression）を指定できます。
詳細は、式表現を参照ください。

■ 指定例（名前付きブレースホルダを使用）
criteria.where(Expression.between(School.class.getDeclaredField("id"), ":min", ":max"))

groupByメソッド

グルーピングするフィールド（カラム）を指定します。

■ 指定例
criteria.groupBy(
		School.class.getDeclaredField("id"),
		Department.class.getDeclaredField("id"),
		Subject.class.getDeclaredField("id"))

havingメソッド

集約したフィールド（カラム）に対する検索条件を指定します。

■ 指定例
criteria.having(Expression.greaterThan(Subject.class.getDeclaredField("id"), 30))

orderByメソッド

ソート条件を指定します。

■ 指定例
criteria.orderyBy(
		Expression.asc(School.class.getDeclaredField("id")),
		Expression.desc(Department.class.getDeclaredField("id")))

クエリメソッド

Criteriaの内容で生成されたクエリ（Query）のメソッドには以下があります。

■ 指定例
Query query = em.createQuery(criteria);
List<Department> resultList = (List<Department>) query.getResultList();