package com.example.dbflute.basic.dbflute.howto;
import java.sql.Timestamp;
import java.util.ArrayList;
import java.util.Calendar;
import java.util.Date;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import javax.annotation.Resource;
import org.seasar.dbflute.bhv.ConditionBeanSetupper;
import org.seasar.dbflute.cbean.AndQuery;
import org.seasar.dbflute.cbean.ListResultBean;
import org.seasar.dbflute.cbean.OrQuery;
import org.seasar.dbflute.cbean.PagingResultBean;
import org.seasar.dbflute.cbean.SubQuery;
import org.seasar.dbflute.cbean.UnionQuery;
import org.seasar.dbflute.cbean.coption.LikeSearchOption;
import com.example.dbflute.basic.dbflute.cbean.MemberCB;
import com.example.dbflute.basic.dbflute.cbean.MemberLoginCB;
import com.example.dbflute.basic.dbflute.cbean.PurchaseCB;
import com.example.dbflute.basic.dbflute.exbhv.MemberBhv;
import com.example.dbflute.basic.dbflute.exbhv.PurchaseBhv;
import com.example.dbflute.basic.dbflute.exentity.Member;
import com.example.dbflute.basic.dbflute.exentity.MemberWithdrawal;
import com.example.dbflute.basic.dbflute.exentity.Product;
import com.example.dbflute.basic.dbflute.exentity.ProductStatus;
import com.example.dbflute.basic.dbflute.exentity.Purchase;
import com.example.dbflute.basic.dbflute.exentity.WithdrawalReason;
import com.example.dbflute.basic.unit.UnitContainerTestCase;
/**
* ConditionBeanの中級編Example実装。
*
* ターゲットは以下の通り：
* o DBFluteってどういう機能があるのかを探っている方
* o DBFluteで実装を開始する方・実装している方
*
* コンテンツは以下の通り：
* o many(one)-to-one-to-one(親の親)を結合して取得する検索: setupSelect_Xxx().withXxx().
* o many(one)-to-one-to-one-to-one(親の親の親)を結合して取得する検索: setupSelect_Xxx().withXxx().withXxx().
* o Query-Equal条件で区分値機能を使ってタイプセーフに区分値を指定: setXxx_Equal_Xxx().
* o Query-NotEqual条件: setXxx_NotEqual().
* o Query-NotEqual条件で区分値機能でタイプセーフに区分値を指定: setXxx_NotEqual_Xxx().
* o Query-GreaterThan条件: setXxx_GreaterThan().
* o Query-GreaterEqual条件: setXxx_GreaterEqual().
* o Query-LessThan条件: setXxx_LessThan().
* o Query-LessEqual条件: setXxx_LessEqual().
* o Query-PrefixSearch条件(前方一致): setXxx_PrefixSearch().
* o Query-InScope条件(in ('a', 'b')): setXxx_InScope().
* o Query-NotInScope条件(not in ('a', 'b')): setXxx_NotInScope().
* o Query-LikeSearch条件の前方一致: setXxx_LikeSearch(), option.likePrefix().
* o Query-LikeSearch条件の部分一致: setXxx_LikeSearch(), option.likeContain().
* o Query-LikeSearch条件の後方一致: setXxx_LikeSearch(), option.likeSuffix().
* o Query-LikeSearch条件のエスケープ付き曖昧検索: setXxx_LikeSearch().
* o Query-NotLikeSearch条件の前方一致: setXxx_NotLikeSearch(), option.likePrefix().
* o Query-ExistsReferrerで子テーブルの条件で絞り込み: cb.query().existsXxxList().
* o Query-ExistsReferrerでmany-to-manyの関係のテーブルの条件で絞り込み: cb.query().existsXxxList().
* o Query-ExistsReferrerで親テーブルの子テーブル(兄弟テーブル)の条件で絞り込み: cb.query().queryXxx().existsYyyList().
* o Query-NotExistsReferrerで子テーブルの条件で絞り込み: cb.query().notExistsXxxList().
* o Query-InScopeRelationで子テーブルの条件で絞り込み: cb.query().inScopeXxxList().
* o Query-InScopeRelationでmany-to-manyの関係のテーブルの条件で絞り込み: cb.query().inScopeXxxList().
* o Query-NotInScopeRelationで子テーブルの条件で絞り込み: cb.query().notInScopeXxxList().
* o Query-DateFromTo(日付の範囲検索): query().setXxx_DateFromTo().
* o or条件: orScopeQuery().
* o or条件の中おand条件: orScopeQueryAndPart().
* o Union: union().
* o UnionAll: unionAll().
* o ページング検索: cb.paging(pageSize, pageNumber).
* o 先頭のn件を検索: cb.fetchFirst(fetchSize).
* o 更新ロックを取得: cb.lockForUpdate().
* o ConditionBeanで組み立てたSQLをログに表示: toDisplaySql().
* o ConditionBeanで組み立てたSQLをログに表示(SubQuery含み): toDisplaySql().
*
* @author jflute
* @since 0.7.3 (2008/06/01 Sunday)
*/
public class ConditionBeanMiddleTest extends UnitContainerTestCase {
// ===================================================================================
// Attribute
// =========
/** The behavior of Member. (Injection Object) */
@Resource
protected MemberBhv memberBhv;
/** The behavior of Purchase. (Injection Object) */
@Resource
protected PurchaseBhv purchaseBhv;
// ===================================================================================
// SetupSelect
// ===========
/**
* o many(one)-to-one-to-one(親の親)を結合して取得する検索: setupSelect_Xxx().withXxx().
* 「会員ステータス」と「会員退会情報」ならびに「退会理由」をSetupSelectして検索。
*/
public void test_setupSelect() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.setupSelect_MemberWithdrawalAsOne().withWithdrawalReason();
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertFalse(memberList.isEmpty());
boolean existsWithdrawalReason = false;
for (Member member : memberList) {
log("[MEMBER]: " + member.getMemberName());
MemberWithdrawal memberWithdrawalAsOne = member.getMemberWithdrawalAsOne();
if (memberWithdrawalAsOne != null) {// {1 : 0...1}の関連なのでnullチェック
WithdrawalReason withdrawalReason = memberWithdrawalAsOne.getWithdrawalReason();
if (withdrawalReason != null) {// NullableなFKなのでnullチェック
String withdrawalReasonCode = memberWithdrawalAsOne.getWithdrawalReasonCode();
String withdrawalReasonText = withdrawalReason.getWithdrawalReasonText();
log(" [WITHDRAWAL]" + withdrawalReasonCode + " - " + withdrawalReasonText);
existsWithdrawalReason = true;
} else {
log(" [WITHDRAWAL]" + memberWithdrawalAsOne);
}
}
}
assertTrue(existsWithdrawalReason);
// [Description]
// A. setupSelect_Xxx()した後に続いてwithXxx()と指定することでさらに上の階層を指定できる。
// B. 指定できる階層は無限階層である。(withXxx().withXxx().withXxx()...)
}
/**
* o many(one)-to-one-to-one-to-one(親の親の親)を結合して取得する検索: setupSelect_Xxx().withXxx().withXxx().
* 購入から会員、会員から会員退会情報、会員退会情報から退会理由までの３階層を結合して取得。
* 実務ではあまりこういった検索はないと思われるが、説明材料のExampleとして実装している。
*/
public void test_setupSelect_withForeign_withForeign() {
// ## Arrange ##
PurchaseCB cb = new PurchaseCB();
cb.setupSelect_Member().withMemberWithdrawalAsOne().withWithdrawalReason();// *Point!
cb.setupSelect_Member().withMemberStatus();
cb.setupSelect_Product().withProductStatus();
cb.query().addOrderBy_PurchaseDatetime_Desc().addOrderBy_PurchaseId_Asc();
// ## Act ##
ListResultBean purchaseList = purchaseBhv.selectList(cb);
// ## Assert ##
assertNotSame(0, purchaseList.size());
boolean existsWithdrawal = false;
for (Purchase purchase : purchaseList) {
Product product = purchase.getProduct();
ProductStatus productStatus = product.getProductStatus();
assertNotNull(product);
assertNotNull(productStatus);
log("[PURCHASE]: " + purchase.getPurchaseId() + ", " + product.getProductName() + ", " + productStatus);
Member member = purchase.getMember();
assertNotNull(member);
assertNotNull(member.getMemberStatus());
MemberWithdrawal memberWithdrawalAsOne = member.getMemberWithdrawalAsOne();
if (memberWithdrawalAsOne != null) {
WithdrawalReason withdrawalReason = memberWithdrawalAsOne.getWithdrawalReason();
if (withdrawalReason != null) {
String reasonText = withdrawalReason.getWithdrawalReasonText();
log(" [MEMBER]: " + member.getMemberId() + ", " + member.getMemberName() + ", " + reasonText);
assertNotNull(reasonText);
existsWithdrawal = true;
}
}
}
assertTrue("退会者が少なくとも一人以上は存在してないとテストにならない", existsWithdrawal);
}
// /- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
// 子テーブルの取得に関しては、BehaviorMiddleTestのLoadReferrerにて
// - - - - - - - - - -/
// ===================================================================================
// Query
// =====
// -----------------------------------------------------
// Equal
// -----
// /- - - - - - - - - - - - - - - - - - - - - - - - - - -
// Equalの基本的な利用に関しては、ConditionBeanBasicTestにて
// - - - - - - - - - -/
/**
* o Query-Equal条件で区分値機能を使ってタイプセーフに区分値を指定: setXxx_Equal_Xxx().
* 正式会員の会員を検索。
*/
public void test_query_setMemberStatusCode_Equal_Classification() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.query().setMemberStatusCode_Equal_正式会員();// *Point!
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
assertTrue(member.isMemberStatusCode正式会員());
}
// [SQL]
// where MEMBER_STATUS_CODE = 'FML'
// [Description]
// 区分値定義は、DBFluteプロパティ(dfprop)の
// 「classificationDefinitionMap.dfprop」と「classificationDeploymentMap.dfprop」
// にて
}
// -----------------------------------------------------
// NotEqual
// --------
/**
* o Query-NotEqual条件: setXxx_NotEqual().
* 会員アカウントが「Pixy」でない会員を検索。
*/
public void test_query_NotEqual() {
// ## Arrange ##
int countAll = memberBhv.selectCount(new MemberCB());
MemberCB cb = new MemberCB();
cb.query().setMemberAccount_NotEqual("Pixy");// *Point!
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertFalse(memberList.isEmpty());
assertEquals(countAll - 1, memberList.size());
for (Member member : memberList) {
assertNotSame("Pixy", member.getMemberAccount());
}
// [SQL]
// where MEMBER_ACCOUNT <> 'Pixy'
// [Description]
// A. 別の値で二回呼び出しても上書きになるだけなので注意。
// -> その場合NotInScopeを利用
//
// B. 数値型と日付型に関しては、EMechaやDBFluteClientテンプレートにおいて、
// 利用頻度の少なさからデフォルトで生成されないような設定になっている。
// -> {DBFluteClient}/dfprop/includeQueryMap.dfprop
}
/**
* o Query-NotEqual条件で区分値機能でタイプセーフに区分値を指定: setXxx_NotEqual_Xxx().
* 正式会員でない会員を検索。
*/
public void test_query_NotEqual_Classification() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.query().setMemberStatusCode_NotEqual_正式会員();// *Point!
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
assertFalse(member.isMemberStatusCode正式会員());
}
// [SQL]
// where MEMBER_STATUS_CODE <> 'FML'
}
// -----------------------------------------------------
// GreaterThan
// -----------
/**
* o Query-GreaterThan条件: setXxx_GreaterThan().
* 会員ID「3」より大きい会員IDを持った会員を検索。
*/
public void test_query_GreaterThan() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.query().setMemberId_GreaterThan(3);// *Point!
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
assertTrue(member.getMemberId() > 3);
}
// [SQL]
// where MEMBER_ID > 3
}
// -----------------------------------------------------
// GreaterEqual
// ------------
/**
* o Query-GreaterEqual条件: setXxx_GreaterEqual().
* 会員ID「3」以上の会員IDを持った会員を検索。
*/
public void test_query_GreaterEqual() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.query().setMemberId_GreaterEqual(3);// *Point!
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
assertTrue(member.getMemberId() >= 3);
}
// [SQL]
// where MEMBER_ID >= 3
}
// -----------------------------------------------------
// LessThan
// --------
/**
* o Query-LessThan条件: setXxx_LessThan().
* 会員ID「3」より小さい会員IDを持った会員を検索。
*/
public void test_query_LessThan() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.query().setMemberId_LessThan(3);// *Point!
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
assertTrue(member.getMemberId() < 3);
}
// [SQL]
// where MEMBER_ID < 3
}
// -----------------------------------------------------
// LessEqual
// ---------
/**
* o Query-LessEqual条件: setXxx_LessEqual().
* 会員ID「3」以下の会員IDを持った会員を検索。
*/
public void test_query_LessEqual() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.query().setMemberId_LessEqual(3);// *Point!
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
assertTrue(member.getMemberId() <= 3);
}
// [SQL]
// where MEMBER_ID <= 3
}
// -----------------------------------------------------
// PrefixSearch
// ------------
/**
* o Query-PrefixSearch条件(前方一致): setXxx_PrefixSearch().
* 会員名称が'S'で始まる会員を検索。
*/
public void test_query_PrefixSearch() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.query().setMemberName_PrefixSearch("S");// *Point!
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
log("memberName=" + member.getMemberName());
assertTrue(member.getMemberName().startsWith("S"));
}
// [SQL]
// where MEMBER_NAME like 'S%'
// [Description]
// A. ワイルドカード'%'は内部的に自動付与される。
// B. 自動でエスケープ処理が施される。
// C. 同じカラムに複数回設定を設定した場合は、設定した分条件が展開される
}
// -----------------------------------------------------
// InScope
// -------
/**
* o Query-InScope条件(in ('a', 'b')): setXxx_InScope().
* 会員ID「3」・「6」・「7」の会員を検索。
*/
public void test_query_InScope() {
// ## Arrange ##
MemberCB cb = new MemberCB();
List expectedMemberIdList = new ArrayList();
expectedMemberIdList.add(3);
expectedMemberIdList.add(6);
expectedMemberIdList.add(7);
cb.query().setMemberId_InScope(expectedMemberIdList);// *Point!
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
log("memberId=" + member.getMemberId());
assertTrue(expectedMemberIdList.contains(member.getMemberId()));
}
// [Description]
// A. 空のリストが指定された場合は、その条件は無効になる。
// -> nullが指定された場合と同じ
//
// B. リストの中に同じ値が格納されている場合は、そのまま処理される。
// -> 例えば、'6'が二つ格納されていたら: in (3, 6, 6, 7)
//
// C. リストの中にnullや空文字が登録されている場合は、それら値だけ無視される。
// -> リストの中が全てnullや空文字なら「A」と同じ
//
// D. 同じカラムに複数回設定を設定した場合は、設定した分条件が展開される
}
// -----------------------------------------------------
// NotInScope
// ----------
/**
* o Query-NotInScope条件(not in ('a', 'b')): setXxx_NotInScope().
* 会員ID「3」・「6」・「7」でない会員を検索
*/
public void test_query_NotInScope() {
// ## Arrange ##
MemberCB cb = new MemberCB();
List expectedMemberIdList = new ArrayList();
expectedMemberIdList.add(3);
expectedMemberIdList.add(6);
expectedMemberIdList.add(7);
cb.query().setMemberId_NotInScope(expectedMemberIdList);// *Point!
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
log("memberId=" + member.getMemberId());
if (expectedMemberIdList.contains(member.getMemberId())) {
fail();
}
}
// [Description]
// A. 空のリストが指定された場合は、その条件は無効になる。
// -> nullが指定された場合と同じ
//
// B. リストの中に同じ値が格納されている場合は、そのまま処理される。
// -> 例えば、'6'が二つ格納されていたら: in (3, 6, 6, 7)
//
// C. リストの中にnullや空文字が登録されている場合は、それら値だけ無視される。
// -> リストの中が全てnullや空文字なら「A」と同じ
//
// D. 同じカラムに複数回設定を設定した場合は、設定した分条件が展開される
}
// -----------------------------------------------------
// LikeSearch
// ----------
/**
* Query-LikeSearch条件の前方一致: setXxx_LikeSearch(), option.likePrefix().
* 会員名称が'S'で始まる会員を検索。
*/
public void test_query_LikeSearch_likePrefix() {
// ## Arrange ##
MemberCB cb = new MemberCB();
// *Point!
LikeSearchOption option = new LikeSearchOption().likePrefix();
cb.query().setMemberName_LikeSearch("S", option);
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
log("memberName=" + member.getMemberName());
assertTrue(member.getMemberName().startsWith("S"));
}
// [Description]
// A. LikeSearchOptionの指定は必須。(nullは例外)
// B. likeXxx()を指定すると自動でエスケープ処理が施される。
// C. 同じカラムに複数回設定を設定した場合は、設定した分条件が展開される
}
/**
* Query-LikeSearch条件の部分一致: setXxx_LikeSearch(), option.likeContain().
* 会員名称に'v'が含まれる会員を検索。
*/
public void test_query_LikeSearch_likeContain() {
// ## Arrange ##
MemberCB cb = new MemberCB();
// *Point!
LikeSearchOption option = new LikeSearchOption().likeContain();
cb.query().setMemberName_LikeSearch("v", option);
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
log("memberName=" + member.getMemberName());
assertTrue(member.getMemberName().contains("v"));
}
// [Description]
// A. LikeSearchOptionの指定は必須。(nullは例外)
// B. likeXxx()を指定すると自動でエスケープ処理が施される。
// C. 同じカラムに複数回設定を設定した場合は、設定した分条件が展開される
}
/**
* Query-LikeSearch条件の後方一致: setXxx_LikeSearch(), option.likeSuffix().
* 会員名称が'r'で終わる会員を検索。
*/
public void test_query_LikeSearch_likeSuffix() {
// ## Arrange ##
MemberCB cb = new MemberCB();
// *Point!
LikeSearchOption option = new LikeSearchOption().likeSuffix();
cb.query().setMemberName_LikeSearch("r", option);
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
log("memberName=" + member.getMemberName());
assertTrue(member.getMemberName().endsWith("r"));
}
// [Description]
// A. LikeSearchOptionの指定は必須。(nullは例外)
// B. likeXxx()を指定すると自動でエスケープ処理が施される。
// C. 同じカラムに複数回設定を設定した場合は、設定した分条件が展開される
}
/**
* Query-LikeSearch条件のエスケープ付き曖昧検索: setXxx_LikeSearch().
* 会員名称に'100%ジュース|和歌山_テ'という文字が含まれる会員を検索。
* 但し、'果汁100パーセントジュース|和歌山Aテスト'というような会員名称は検索対象になってはならない。
* (条件値に既に含まれている'%'や'_'がワイルドカードとして扱われてはならない)
* 想定されるSQL(Where句)は以下のような形である。
*
* -- 会員名称に'100%ジュース|和歌山_テ'という文字が含まれる会員
* where MEMBER_NAME like '%100|%ジュース||和歌山|_テ%' escape '|'
*
* {エスケープ文字の埋め込み}
* A. 条件値に含まれているエスケープ文字'|' → '||'
* B. 条件値に含まれているワイルドカード文字'%' → '|%'
* C. 条件値に含まれているワイルドカード文字'_' → '|_'
*
*/
public void test_query_LikeSearch_likeContain_AllEscape() {
// ## Arrange ##
String keyword = "100%ジュース|和歌山_テ";
String expectedMemberName = "果汁" + keyword + "スト";
String dummyMemberName = "果汁100パーセントジュース|和歌山Aテスト";
// escape処理の必要な会員がいなかったので、ここで一時的に登録
Member escapeMember = new Member();
escapeMember.setMemberName(expectedMemberName);
escapeMember.setMemberAccount("temporaryAccount");
escapeMember.setMemberStatusCode_正式会員();
memberBhv.insert(escapeMember);
// escape処理をしない場合にHITする会員も登録
Member nonEscapeOnlyMember = new Member();
nonEscapeOnlyMember.setMemberName(dummyMemberName);
nonEscapeOnlyMember.setMemberAccount("temporaryAccount2");
nonEscapeOnlyMember.setMemberStatusCode_正式会員();
memberBhv.insert(nonEscapeOnlyMember);
// 一時的に登録した会員が想定しているものかどうかをチェック
MemberCB checkCB = new MemberCB();
// Check if not escape!
checkCB.query().setMemberName_LikeSearch(keyword, new LikeSearchOption().likeContain().notEscape());
assertEquals("escapeなしで2件ともHITすること", 2, memberBhv.selectList(checkCB).size());
// /- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MemberCB cb = new MemberCB();
LikeSearchOption option = new LikeSearchOption().likeContain(); // *Point!
cb.query().setMemberName_LikeSearch(keyword, option);
// - - - - - - - - - -/
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertEquals(1, memberList.size());// このキーワードにHITする人は１人しかいない
Member actualMember = memberList.get(0);
log(actualMember);
assertEquals(expectedMemberName, actualMember.getMemberName());
// [SQL]
// select ...
// from MEMBER
// where MEMBER_NAME like '%100|%ジュース||和歌山|_テ%' escape '|'
// [Description]
// A. likeXxx()を指定すると自動でエスケープ処理が施される。
// B. likeXxx()を指定した後にnotEscape()を呼ぶとエスケープ処理が解除される。
}
// /= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
// [Tips]: そもそもエスケープ付き曖昧検索とは？
//
// 曖昧検索は、条件値に含まれているワイルドカード(%や_)を使って、
// 前方一致・部分一致等を実現する。例えば、条件値が'S%'であれば
// 「Sで始まるもの」、'%S%'であれば「Sを含むもの」という検索になる
// しかし、もしデータベース上に「100%ジュースの飲み物」という文字が
// 格納されていて、「'100%ジュース'を含むもの」という検索をしたい場合に、
// 条件値が'%100%ジュース%'では正確な検索をすることができない。
//
// [曖昧検索-'100%ジュース'を含むもの]
// =============================================================
// -- 「'100%ジュース'を含むもの」
// where xxx like '%100%ジュース%'
// =============================================================
//
// なにがまずいかというと、もしデータベース上に「100回回ってから飲むジュース」
// というデータが入ってたら、このデータも検索対象になってしまうのである。
// 「'100%ジュース'を含むもの」という条件からは外れたデータである。
// つまりは、ワイルドカード(%や_)も通常の文字として扱いたいこともあるということ。
//
// SQLでは、文字として扱いたい'%'や'_'がある場合に、それらを条件値の中でエスケープする。
// そのときエスケープ文字を明示的に指定する。
//
// [エスケープ付き曖昧検索-ワイルドカード文字をエスケープ]
// =============================================================
// -- 「'100%ジュース'を含むもの」
// where xxx like '%100|%ジュース%' escape '|'
// =============================================================
//
// こうすることで、エスケープ文字でエスケープされた'%'や'_'はワイルドカードではなく、
// 通常の文字として扱われる。エスケープ文字をエスケープすることも可能。
//
// [エスケープ付き曖昧検索-エスケープ文字をエスケープ]
// =============================================================
// -- 「'aaa|bbb'を含むもの」
// where xxx like '%aaa||bbb%' escape '|'
// =============================================================
// = = = = = = = = = =/
// -----------------------------------------------------
// NotLikeSearch
// -------------
/**
* o Query-NotLikeSearch条件の前方一致: setXxx_NotLikeSearch(), option.likePrefix().
* 会員名称が'S'で始まらない会員を検索。
*/
public void test_query_NotLikeSearch_likePrefix() {
// ## Arrange ##
MemberCB cb = new MemberCB();
// *Point!
LikeSearchOption option = new LikeSearchOption().likePrefix();
cb.query().setMemberName_NotLikeSearch("S", option);
// ## Act ##
List memberList = memberBhv.selectList(cb);
// ## Assert ##
assertNotNull(memberList);
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
log("memberName=" + member.getMemberName());
assertFalse(member.getMemberName().startsWith("S"));
}
// [Description]
// A. LikeSearchOptionの指定は必須。(nullは例外)
// B. likeXxx()を指定すると自動でエスケープ処理が施される。
// C. 同じカラムに複数回設定を設定した場合は、設定した分条件が展開される
}
// -----------------------------------------------------
// ExistsReferrer
// --------------
/**
* o Query-ExistsReferrerで子テーブルの条件で絞り込み: cb.query().existsXxxList().
* 一回の購入で二点以上の購入をしたことのある会員を検索。
* Existsの相関サブクエリを使って子テーブルの条件で絞り込む。
*/
public void test_query_exists_ReferrerCondition() {
// ## Arrange ##
MemberCB cb = new MemberCB();
// *Point!
cb.query().existsPurchaseList(new SubQuery() {
public void query(PurchaseCB subCB) {
subCB.query().setPurchaseCount_GreaterThan(2);
}
});
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
memberBhv.loadPurchaseList(memberList, new ConditionBeanSetupper() {
public void setup(PurchaseCB subCB) {
subCB.setupSelect_Product();
}
});
for (Member member : memberList) {
log("[MEMBER] " + member.getMemberId() + ", " + member.getMemberName());
List purchaseList = member.getPurchaseList();
boolean existsPurchase = false;
for (Purchase purchase : purchaseList) {
Product product = purchase.getProduct();
Integer purchaseCount = purchase.getPurchaseCount();
String productName = product.getProductName();
log(" [PURCHASE] " + purchase.getPurchaseId() + ", " + purchaseCount + ", " + productName);
if (purchaseCount > 2) {
existsPurchase = true;
}
}
assertTrue(existsPurchase);
}
// [SQL]
// select ...
// from MEMBER dfloc
// where exists (select sub1loc.MEMBER_ID
// from PURCHASE sub1loc
// where sub1loc.MEMBER_ID = dfloc.MEMBER_ID
// and sub1loc.PURCHASE_COUNT > 2
// )
// [Description]
// A. 複数回設定を設定した場合は、設定した分条件が展開される
}
/**
* o Query-ExistsReferrerでmany-to-manyの関係のテーブルの条件で絞り込み: cb.query().existsXxxList().
* 商品名称が'Storm'で始まる商品を購入したことのある会員を検索。
* Existsの相関サブクエリを使って子テーブルを経由してその親テーブルの条件で絞り込む。
*/
public void test_query_exists_ManyToManyCondition() {
// ## Arrange ##
MemberCB cb = new MemberCB();
// *Point!
cb.query().existsPurchaseList(new SubQuery() {
public void query(PurchaseCB subCB) {
subCB.query().queryProduct().setProductName_PrefixSearch("Storm");
}
});
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
memberBhv.loadPurchaseList(memberList, new ConditionBeanSetupper() {
public void setup(PurchaseCB subCB) {
subCB.setupSelect_Product();
}
});
for (Member member : memberList) {
log("[MEMBER] " + member.getMemberId() + ", " + member.getMemberName());
List purchaseList = member.getPurchaseList();
boolean existsProduct = false;
for (Purchase purchase : purchaseList) {
Product product = purchase.getProduct();
Integer purchaseCount = purchase.getPurchaseCount();
String productName = product.getProductName();
log(" [PURCHASE] " + purchase.getPurchaseId() + ", " + purchaseCount + ", " + productName);
if (productName.startsWith("Storm")) {
existsProduct = true;
}
}
assertTrue(existsProduct);
}
}
/**
* o Query-ExistsReferrerで親テーブルの子テーブル(兄弟テーブル)の条件で絞り込み: cb.query().queryXxx().existsYyyList().
* モバイル(携帯)からログインしたことのある会員の購入リストを検索。
* Existsの相関サブクエリを使って親テーブルの子テーブル(会員ログイン)を経由して絞り込む。
*/
public void test_query_exists_ForeignReferrerCondition() {
// ## Arrange ##
PurchaseCB cb = new PurchaseCB();
// *Point!
cb.query().queryMember().existsMemberLoginList(new SubQuery() {
public void query(MemberLoginCB subCB) {
subCB.query().setMobileLoginFlg_Equal_True();
}
});
cb.query().addOrderBy_MemberId_Asc().addOrderBy_ProductId_Asc();
// ## Act ##
ListResultBean purchaseList = purchaseBhv.selectList(cb);
// ## Assert ##
List purchaseIdList = new ArrayList();
Set memberIdSet = new HashSet();
for (Purchase purchase : purchaseList) {
// Show only
Long purchaseId = purchase.getPurchaseId();
Integer memberId = purchase.getMemberId();
Integer productId = purchase.getProductId();
Timestamp purchaseDatetime = purchase.getPurchaseDatetime();
log("[PURCHASE] " + purchaseId + ", " + memberId + ", " + productId + ", " + purchaseDatetime);
purchaseIdList.add(purchaseId);
memberIdSet.add(memberId);
}
MemberCB memberCB = new MemberCB();
memberCB.query().existsMemberLoginList(new SubQuery() {
public void query(MemberLoginCB subCB) {
subCB.query().setMobileLoginFlg_Equal_True();
}
});
memberCB.query().existsPurchaseList(new SubQuery() {
public void query(PurchaseCB subCB) {
}
});
int expected = memberBhv.selectCount(memberCB);
assertEquals(expected, memberIdSet.size());
// [SQL]
// select ...
// from PURCHASE dfloc
// left outer join MEMBER dfrel_0 on dfloc.MEMBER_ID = dfrel_0.MEMBER_ID
// where exists (select sub1loc.MEMBER_ID
// from MEMBER_LOGIN sub1loc
// where sub1loc.MEMBER_ID = dfrel_0.MEMBER_ID
// and sub1loc.LOGIN_MOBILE_FLG = 1
// )
// order by dfloc.MEMBER_ID asc, dfloc.PRODUCT_ID asc
}
/**
* o Query-NotExistsReferrerで子テーブルの条件で絞り込み: cb.query().notExistsXxxList().
* 一回の購入で二点以上の購入をしたこと「ない」会員を検索。
* NotExistsの相関サブクエリを使って子テーブルの条件で絞り込む。
* @since 0.7.5
*/
public void test_query_notExists_ReferrerCondition() {
// ## Arrange ##
MemberCB cb = new MemberCB();
// *Point!
cb.query().notExistsPurchaseList(new SubQuery() {
public void query(PurchaseCB subCB) {
subCB.query().setPurchaseCount_GreaterThan(2);
}
});
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
ConditionBeanSetupper setuppper = new ConditionBeanSetupper() {
public void setup(PurchaseCB subCB) {
subCB.setupSelect_Product();
}
};
memberBhv.loadPurchaseList(memberList, setuppper);
for (Member member : memberList) {
log("[MEMBER] " + member.getMemberId() + ", " + member.getMemberName());
List purchaseList = member.getPurchaseList();
boolean existsPurchase = false;
for (Purchase purchase : purchaseList) {
Product product = purchase.getProduct();
Integer purchaseCount = purchase.getPurchaseCount();
String productName = product.getProductName();
log(" [PURCHASE] " + purchase.getPurchaseId() + ", " + purchaseCount + ", " + productName);
if (purchaseCount > 2) {
existsPurchase = true;
}
}
assertFalse(existsPurchase);
}
}
// -----------------------------------------------------
// InScopeRelation
// ---------------
/**
* o Query-InScopeRelationで子テーブルの条件で絞り込み: cb.query().inScopeXxxList().
* 一回の購入で二点以上の購入をしたことのある会員を検索。
* InScopeのサブクエリを使って子テーブルの条件で絞り込む。
*/
public void test_query_inScope_ReferrerCondition() {
// ## Arrange ##
MemberCB cb = new MemberCB();
// *Point!
cb.query().inScopePurchaseList(new SubQuery() {
public void query(PurchaseCB subCB) {
subCB.query().setPurchaseCount_GreaterThan(2);
}
});
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
memberBhv.loadPurchaseList(memberList, new ConditionBeanSetupper() {
public void setup(PurchaseCB subCB) {
subCB.setupSelect_Product();
}
});
for (Member member : memberList) {
log("[MEMBER] " + member.getMemberId() + ", " + member.getMemberName());
List purchaseList = member.getPurchaseList();
boolean existsPurchase = false;
for (Purchase purchase : purchaseList) {
Product product = purchase.getProduct();
Integer purchaseCount = purchase.getPurchaseCount();
String productName = product.getProductName();
log(" [PURCHASE] " + purchase.getPurchaseId() + ", " + purchaseCount + ", " + productName);
if (purchaseCount > 2) {
existsPurchase = true;
}
}
assertTrue(existsPurchase);
}
// [Description]
// A. ExistsReferrerと結果は全く同じになる。
// -> 実行計画が変わる可能性あり
// B. 複数回設定を設定した場合は、設定した分条件が展開される
}
/**
* o Query-InScopeRelationでmany-to-manyの関係のテーブルの条件で絞り込み: cb.query().inScopeXxxList().
* 商品名称が'Storm'で始まる商品を購入したことのある会員を検索。
* InScopeのサブクエリを使って子テーブルを経由してその親テーブルの条件で絞り込む。
*/
public void test_query_inScope_ManyToManyCondition() {
// ## Arrange ##
MemberCB cb = new MemberCB();
// *Point!
cb.query().inScopePurchaseList(new SubQuery() {
public void query(PurchaseCB subCB) {
subCB.query().queryProduct().setProductName_PrefixSearch("Storm");
}
});
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
memberBhv.loadPurchaseList(memberList, new ConditionBeanSetupper() {
public void setup(PurchaseCB subCB) {
subCB.setupSelect_Product();
}
});
for (Member member : memberList) {
log("[MEMBER] " + member.getMemberId() + ", " + member.getMemberName());
List purchaseList = member.getPurchaseList();
boolean existsProduct = false;
for (Purchase purchase : purchaseList) {
Product product = purchase.getProduct();
Integer purchaseCount = purchase.getPurchaseCount();
String productName = product.getProductName();
log(" [PURCHASE] " + purchase.getPurchaseId() + ", " + purchaseCount + ", " + productName);
if (productName.startsWith("Storm")) {
existsProduct = true;
}
}
assertTrue(existsProduct);
}
// [Description]
// A. ExistsReferrerと結果は全く同じになる。
// -> 実行計画が変わる可能性あり
}
/**
* o Query-NotInScopeRelationで子テーブルの条件で絞り込み: cb.query().notInScopeXxxList().
* 一回の購入で二点以上の購入をしたこと「ない」会員を検索。
* NotInScopeのサブクエリを使って子テーブルの条件で絞り込む。
* @since 0.7.5
*/
public void test_query_notInScope_ReferrerCondition() {
// ## Arrange ##
MemberCB cb = new MemberCB();
// *Point!
cb.query().notInScopePurchaseList(new SubQuery() {
public void query(PurchaseCB subCB) {
subCB.query().setPurchaseCount_GreaterThan(2);
}
});
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
memberBhv.loadPurchaseList(memberList, new ConditionBeanSetupper() {
public void setup(PurchaseCB subCB) {
subCB.setupSelect_Product();
}
});
for (Member member : memberList) {
log("[MEMBER] " + member.getMemberId() + ", " + member.getMemberName());
List purchaseList = member.getPurchaseList();
boolean existsPurchase = false;
for (Purchase purchase : purchaseList) {
Product product = purchase.getProduct();
Integer purchaseCount = purchase.getPurchaseCount();
String productName = product.getProductName();
log(" [PURCHASE] " + purchase.getPurchaseId() + ", " + purchaseCount + ", " + productName);
if (purchaseCount > 2) {
existsPurchase = true;
}
}
assertFalse(existsPurchase);
}
// [Description]
// A. NotExistsReferrerと結果は全く同じになる。
// -> 実行計画が変わる可能性あり
}
// -----------------------------------------------------
// DateFromTo
// ----------
/**
* o Query-DateFromTo(日付の範囲検索): query().setXxx_DateFromTo().
* '2007/11/26'から'2007/12/01'の期間正式会員になった会員を検索。
* '2007/12/01'の日に正式会員になった人もちゃんと対象になること。
*
* 例えば、日付で範囲検索する画面から条件を入力する場合、終了日に'2007/12/01'と
* 入れられたら、'2007/12/01 14:23:43'のデータも対象になって欲しいことが多い。
* しかし、入力された日付でそのままSQLの条件に組み込むと、「less equal '2007/12/01 00:00:00'」
* となって、'2007/12/01'から一秒でも過ぎたデータが対象にならなくなってしまう。
* そのため、入力された終了日を加工して、'2007/12/01 23:59:59'とするか、
* 一日進めて「less than '2007/12/02 00:00:00'」とするかで対応することが多いが、
* これを都度都度各ディベロッパーが実装すると、実装方法がバラバラになってしまうだけでなく、
* 細かい日付操作や演算子の調整というところでバグの温床となってしまう。
* (テストで見つけにくいバグでもあり、とてもやっかいである)
* このDateFromToを使えば、その細かい日付操作や演算子の調整を安全に実装することができる。
*
*
* DB側では時刻も含めた上で正確な日時として管理しておいて、画面からの検索は時刻無し日付で
* 範囲検索をするというような状況でとても有効である。特にイベント系の日時ではそういうことが多い。
* 運用時のいざって時のために時刻を保持しておきたいが、画面からの範囲検索は日付で絞れれば良いという場合である。
*
*/
public void test_query_DateFromTo() {
// ## Arrange ##
MemberCB cb = new MemberCB();
Calendar cal = Calendar.getInstance();
cal.set(2007, 10, 26);// 2007/11/26
Date fromDate = new Date(cal.getTimeInMillis());
cal.set(2007, 11, 1);// 2007/12/01
Date toDate = new Date(cal.getTimeInMillis());
cb.query().setFormalizedDatetime_DateFromTo(fromDate, toDate);// *Point!
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
log(member.getMemberName() + ", " + member.getFormalizedDatetime());
}
}
// ===================================================================================
// OrScopeQuery
// ============
/**
* o or条件: orScopeQuery().
* 「仮会員」もしくは「会員名称が'St'で始まる」会員を「会員名称の降順」で検索。
*/
public void test_orScopeQuery() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.setupSelect_MemberStatus();
cb.orScopeQuery(new OrQuery() {
public void query(MemberCB orCB) {
orCB.query().setMemberStatusCode_Equal_仮会員();
orCB.query().setMemberName_PrefixSearch("St");
}
});
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertHasAnyElement(memberList);
boolean existsProvisional = false;
boolean existsStPrefix = false;
for (Member member : memberList) {
String memberName = member.getMemberName();
String memberStatusName = member.getMemberStatus().getMemberStatusName();
if (!memberName.startsWith("St")) {
log("[Provisional]: " + memberName + ", " + memberStatusName);
assertTrue(member.isMemberStatusCode仮会員());
existsProvisional = true;
} else if (!member.isMemberStatusCode仮会員()) {
log("[Starts with St]: " + memberName + ", " + memberStatusName);
assertTrue(memberName.startsWith("St"));
existsStPrefix = true;
} else {
existsProvisional = true;
existsStPrefix = true;
log("[Both]: " + memberName + ", " + memberStatusName);
}
}
assertTrue(existsProvisional);
assertTrue(existsStPrefix);
// [SQL]
// select ...
// from MEMBER dfloc
// where (dfloc.MEMBER_STATUS_CODE = 'PRV'
// or dfloc.MEMBER_NAME like 'St%' escape '|'
// )
// [Description]
// A. Scope内のConditionBeanでは絞り込み条件だけを指定する
// C. 幾つかの定型的なor条件は、OrScopeQueryを使わずに指定できる
// -> IsNullOrEmpty, FromToOption の orIsNull, LikeSearch の asOrSplit
}
/**
* o or条件の中おand条件: orScopeQueryAndPart().
* 「生年月日が不明の仮会員」もしくは「会員名称が'St'で始まる」会員を「会員名称の降順」で検索。
*/
public void test_orScopeQueryAndPart() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.setupSelect_MemberStatus();
cb.orScopeQuery(new OrQuery() {
public void query(MemberCB orCB) {
orCB.orScopeQueryAndPart(new AndQuery() {
public void query(MemberCB andCB) {
andCB.query().setMemberStatusCode_Equal_仮会員();
andCB.query().setBirthdate_IsNull();
}
});
orCB.query().setMemberName_PrefixSearch("St");
}
});
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertHasAnyElement(memberList);
boolean existsProvisional = false;
boolean existsStPrefix = false;
for (Member member : memberList) {
String memberName = member.getMemberName();
String memberStatusName = member.getMemberStatus().getMemberStatusName();
if (!memberName.startsWith("St")) {
log("[Provisional]: " + memberName + ", " + memberStatusName);
assertTrue(member.isMemberStatusCode仮会員());
assertNull(member.getBirthdate());
existsProvisional = true;
} else if (!member.isMemberStatusCode仮会員()) {
log("[Starts with St]: " + memberName + ", " + memberStatusName);
assertTrue(memberName.startsWith("St"));
existsStPrefix = true;
} else {
existsProvisional = true;
existsStPrefix = true;
log("[Both]: " + memberName + ", " + memberStatusName);
}
}
assertTrue(existsProvisional);
assertTrue(existsStPrefix);
// [SQL]
// select ...
// from MEMBER dfloc
// where ((dfloc.MEMBER_STATUS_CODE = 'PRV' and dfloc.BIRTHDATE is null)
// or dfloc.MEMBER_NAME like 'St%' escape '|'
// )
// [Description]
// A. Scope内のConditionBeanでは絞り込み条件だけを指定する
// B. 残念ながら、AndPartの中でさらにネストしたOrScopeQueryはできない
// C. 幾つかの定型的なor条件は、OrScopeQueryを使わずに指定できる
// -> IsNullOrEmpty, FromToOption の orIsNull, LikeSearch の asOrSplit
}
// ===================================================================================
// Union
// =====
/**
* o Union: union().
* 「仮会員」もしくは「会員名称が'St'で始まる」会員を「会員名称の降順」で検索。
* 関連テーブルとして会員ステータスを取得。
*/
public void test_union() {
MemberCB cb = new MemberCB();
cb.setupSelect_MemberStatus();
cb.query().setMemberStatusCode_Equal_仮会員();
cb.union(new UnionQuery() {
public void query(MemberCB unionCB) {
unionCB.query().setMemberName_PrefixSearch("St");
}
});
cb.query().addOrderBy_MemberName_Desc();
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertHasAnyElement(memberList);
boolean existsProvisional = false;
boolean existsStPrefix = false;
for (Member member : memberList) {
String memberName = member.getMemberName();
String memberStatusName = member.getMemberStatus().getMemberStatusName();
if (!memberName.startsWith("St")) {
log("[Provisional]: " + memberName + ", " + memberStatusName);
assertTrue(member.isMemberStatusCode仮会員());
existsProvisional = true;
} else if (!member.isMemberStatusCode仮会員()) {
log("[Starts with St]: " + memberName + ", " + memberStatusName);
assertTrue(memberName.startsWith("St"));
existsStPrefix = true;
} else {
existsProvisional = true;
existsStPrefix = true;
log("[Both]: " + memberName + ", " + memberStatusName);
}
}
assertTrue(existsProvisional);
assertTrue(existsStPrefix);
// [SQL]
// select ...
// from MEMBER dfloc
// where dfloc.MEMBER_STATUS_CODE = 'PRV'
// union
// select ...
// from MEMBER dfloc
// where dfloc.MEMBER_NAME like 'S%'
// order by MEMBER_NAME desc
// [Description]
// A. ConditionBeanでは自テーブル同士のUnionが可能である。
// B. Unionが指定できる回数は無限である。
// C. 条件的に取得するデータがかぶらないのであればunionAll()の方が良い。
// D. Union側のConditionBeanではsetupSelectとaddOrderByを呼び出す必要はない。
// -> 絞り込み条件のみ設定すること
}
/**
* o UnionAll: unionAll().
* 「生年月日が1967/01/01より昔」もしくは「生年月日がnull」の会員を「生年月日の降順、会員名称の昇順」で検索。
* 互いの条件でデータがかぶらないので、UnionAllを利用。
*/
public void test_unionAll() {
MemberCB cb = new MemberCB();
Calendar cal = Calendar.getInstance();
cal.set(1967, 0, 1);// 1967/01/01
cb.query().setBirthdate_LessThan(new Date(cal.getTimeInMillis()));
cb.unionAll(new UnionQuery() {
public void query(MemberCB unionCB) {
unionCB.query().setBirthdate_IsNull();
}
});
cb.query().addOrderBy_Birthdate_Desc();
cb.query().addOrderBy_MemberName_Asc();
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertHasAnyElement(memberList);
for (Member member : memberList) {
log("[MEMBER]: " + member.getMemberName() + ", " + member.getBirthdate());
}
// [SQL]
// select ...
// from MEMBER dfloc
// where dfloc.MEMBER_BIRTHDAY < '1967-01-01'
// union all
// select ...
// from MEMBER dfloc
// where dfloc.MEMBER_BIRTHDAY is null
// order by MEMBER_BIRTHDAY desc, MEMBER_NAME asc
// [Description]
// A. ConditionBeanでは自テーブル同士のUnionAllが可能である。
// B. UnionAllが指定できる回数は無限である。
// C. Union側のConditionBeanではsetupSelectとaddOrderByを呼び出す必要はない。
// -> 絞り込み条件のみ設定すること
}
// ===================================================================================
// Paging
// ======
/**
* o ページング検索: cb.paging(pageSize, pageNumber).
* 会員名称の昇順のリストを「１ページ４件」の「３ページ目」(９件目から１２件目)を検索。
* ※詳しくはBehaviorMiddleTestの「ページング検索: selectPage().」を参照。
*/
public void test_paging() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.query().addOrderBy_MemberName_Asc();
cb.paging(4, 3);// The page size is 4 records per 1 page, and The page number is 3.
// ## Act ##
PagingResultBean page3 = memberBhv.selectPage(cb);
// ## Assert ##
assertNotSame(0, page3.size());
for (Member member : page3) {
log(member.toString());
}
log("allRecordCount=" + page3.getAllRecordCount());
log("allPageCount=" + page3.getAllPageCount());
log("currentPageNumber=" + page3.getCurrentPageNumber());
log("currentStartRecordNumber=" + page3.getCurrentStartRecordNumber());
log("currentEndRecordNumber=" + page3.getCurrentEndRecordNumber());
log("isExistPrePage=" + page3.isExistPrePage());
log("isExistNextPage=" + page3.isExistNextPage());
// [Description]
// A. paging()メソッドはDBFlute-0.7.3よりサポート。
// DBFlute-0.7.2までは以下の通り：
// fetchFirst(4);
// fetchPage(3);
}
// ===================================================================================
// Fetch Setting
// =============
/**
* o 先頭のn件を検索: cb.fetchFirst(fetchSize).
* 生年月日の降順で先頭の会員を検索。
*/
public void test_fetchFirst() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.query().addOrderBy_Birthdate_Desc().withNullsLast();
cb.fetchFirst(1);// *Point!
// ## Act ##
Member member = memberBhv.selectEntityWithDeletedCheck(cb);
// ## Assert ##
log(member.getMemberName() + ", " + member.getBirthdate());
// [Description]
// A. DBFlute-0.7.3よりサポートされたpaging()メソッドでも同様のことが可能。
// paging(1, 1);
//
// B. 引数のfetchSizeは、マイナス値や０が指定されると例外発生
}
// ===================================================================================
// Lock Setting
// ============
/**
* o 更新ロックを取得: cb.lockForUpdate().
*/
public void test_lockForUpdate() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.query().setMemberId_Equal(3);
cb.lockForUpdate();
// ## Act ##
Member member = memberBhv.selectEntityWithDeletedCheck(cb);
// ## Assert ##
assertNotNull(member);
}
// ===================================================================================
// Display SQL
// ===========
/**
* o ConditionBeanで組み立てたSQLをログに表示: toDisplaySql().
* ConditionBeanで実装していて、途中で外だしSQLで書かなければならないことがわかったときに、
* その途中まで書いたConditionBeanをベースにSQLを書くことができる。
* (スムーズに外だしへの移行が可能であり、かつ、SQLも安全に実装できる)
*/
public void test_toDisplaySql() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.setupSelect_MemberStatus();
cb.query().setMemberName_LikeSearch("S", new LikeSearchOption().likePrefix().escapeByAtMark());
cb.query().addOrderBy_Birthdate_Desc().addOrderBy_MemberId_Asc();
cb.lockForUpdate();
cb.fetchFirst(2);
cb.fetchPage(3);
// ## Act ##
String displaySql = cb.toDisplaySql();// *Point!
// ## Assert ##
StringBuilder sb = new StringBuilder();
sb.append("{SQL}" + ln());
sb.append(displaySql);
log(sb);
assertTrue(displaySql.contains("'S%'"));
assertTrue(displaySql.contains(" escape '@'"));
assertTrue(displaySql.contains("for update"));
assertTrue(displaySql.contains(" order by "));
assertTrue(displaySql.contains(" limit "));
assertTrue(displaySql.contains(" offset "));
}
/**
* o ConditionBeanで組み立てたSQLをログに表示(SubQuery含み): toDisplaySql().
* SubQueryはSQLとしてバグリやすい部分なため、最初から外だしSQLだとわかっていても、
* ConditionBeanで一度組み立ててからSQLのベースとなる文字列をログから取得するのも良い。
* SubQueryを含んだSQLも見やすい形でフォーマットされる。
*/
public void test_toDisplaySql_SubQuery() {
MemberCB cb = new MemberCB();
cb.setupSelect_MemberStatus();
cb.query().existsPurchaseList(new SubQuery() {
public void query(PurchaseCB subCB) {
subCB.query().setPurchaseDatetime_LessThan(currentTimestamp());
subCB.query().setPurchaseCount_GreaterEqual(2);
}
});
cb.query().existsPurchaseList(new SubQuery() {
public void query(PurchaseCB subCB) {
subCB.query().setPurchaseDatetime_LessThan(currentTimestamp());
subCB.query().setPurchaseCount_GreaterEqual(6);
}
});
// ## Act ##
String displaySql = cb.toDisplaySql();
// ## Assert ##
StringBuilder sb = new StringBuilder();
sb.append("{SQL}" + ln());
sb.append(displaySql);
log(sb);
assertTrue(displaySql.contains(">= 2"));
assertTrue(displaySql.contains(" exists "));
// [SQL]
// select ...
// from MEMBER dfloc
// left outer join MEMBER_STATUS dfrel_0 on dfloc.MEMBER_STATUS_CODE = dfrel_0.MEMBER_STATUS_CODE
// where exists (select sub1loc.MEMBER_ID
// from PURCHASE sub1loc
// where sub1loc.MEMBER_ID = dfloc.MEMBER_ID
// and sub1loc.PURCHASE_DATETIME < '2008-06-01 05.09.24'
// and sub1loc.PURCHASE_COUNT >= 2
// )
}
}