purchaseList = member.getPurchaseList();
boolean existsPurchaseTarget = false;
for (Purchase purchase : purchaseList) {
if (purchase.getPurchasePrice() >= 1500) {
existsPurchaseTarget = true;
}
}
if (!existsPurchaseTarget && member.isMemberStatusCode退会会員()) {
bl.setExistsWithdrawalOnly(true);
} else if (existsPurchaseTarget && !member.isMemberStatusCode退会会員()) {
bl.setExistsPurchasePriceOnly(true);
}
}
}
protected static class SelectPageUnionExistsReferrerAssertBoolean {
protected boolean existsWithdrawalOnly = false;
protected boolean existsPurchasePriceOnly = false;
public boolean isExistsWithdrawalOnly() {
return existsWithdrawalOnly;
}
public void setExistsWithdrawalOnly(boolean existsWithdrawalOnly) {
this.existsWithdrawalOnly = existsWithdrawalOnly;
}
public boolean isExistsPurchasePriceOnly() {
return existsPurchasePriceOnly;
}
public void setExistsPurchasePriceOnly(boolean existsPurchasePriceOnly) {
this.existsPurchasePriceOnly = existsPurchasePriceOnly;
}
}
// ===================================================================================
// OnClause
// ========
/**
* o OnClause(On句)に条件を追加: queryXxx().on().
* {left outer join xxx on xxx = xxx and [column] = ?}
*
* 「会員退会情報が存在している会員一覧」に対して、「退会理由コードがnullでない会員退会情報」を結合して取得。
* 会員退会情報が存在していても退会理由コードがnullの会員は、会員退会情報が取得されないようにする。
*
*
* OnClauseに条件を追加すると「条件に合致しない結合先レコードは結合しない」という感じになる。
* よく使われるのは「従属しない関係の結合先テーブルで論理削除されたものは結合しない」というような場合。
*
*
* OnClauseを使わないでWhere句に条件を入れると、条件に合致しない結合先レコードを
* 参照している基点レコードが検索対象外になってしまう。
* {left outer join xxx on xxx = xxx where [column] = ?}
*
*
* 例えば、会員{1,2,3,4,5}に対して会員退会情報{A,B,C}があり、それぞれ{1-A, 2-B, 3-C, 4-null, 5-null}
* というような関係で、「B」が退会理由コードを持っていない会員退会情報であった場合:
*
* 素直に「会員 left outer join 会員退会情報 on ...」すると結果は以下のようになる。
*
* 検索結果:{1-A, 2-B, 3-C, 4-null, 5-null}
*
* これを「会員 left outer join 会員退会情報 on ... and 会員退会情報.退会理由コード is not null」
* というようにOn句の中で「退会理由コードが存在すること」という条件を付与すると以下のようになる。
*
* 検索結果:{1-A, 2-null, 3-C, 4-null, 5-null}
*
* 退会理由コードを持っていない「B」が弾かれて結合されないのである。
* だからといって「2」の会員自体が検索結果から外れることはない。
*
* これを「会員 left outer join 会員退会情報 on ... where 会員退会情報.退会理由コード is not null」
* というようにWhere句にて「退会理由コードが存在すること」という条件を付与すると以下のようになる。
*
* 検索結果:{1-A, 3-C}
*
* これは今回やりたい検索とは全く違うものである。
*
*
* OnClauseでなくInlineViewを使っても同じ動きを実現することは可能である。
* しかし、条件によってはInlineViewの中でフルスキャンが走ってしまう可能性もあるので、
* パフォーマンスの観点からOnClauseの方が良いかと思われる。(実行計画が異なる)
* 但し、これはオプティマイザ次第なので、気になったらどちらかに調整するのが良いと思われる。
* {left outer join (select * from xxx where [column] = ?) xxx on xxx = xxx}
*
*/
public void test_selectList_query_queryForeign_on() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.setupSelect_MemberWithdrawalAsOne();
// 「退会理由コードがnullでない会員退会情報」のレコードは結合されてないようにする
// left outer join xxx on xxx = xxx and WithdrawalReasonCode is not null
cb.query().queryMemberWithdrawalAsOne().on().setWithdrawalReasonCode_IsNotNull();
// left outer join (select * from xxx where WithdrawalReasonCode is not null) xxx on xxx = xxx
// cb.query().queryMemberWithdrawalAsOne().inline().setWithdrawalReasonCode_IsNotNull();
// 会員退会情報が存在する会員だけを取得するようにする
cb.query().inScopeMemberWithdrawalAsOne(new SubQuery() {
public void query(MemberWithdrawalCB subCB) {
}
});
cb.query().queryMemberWithdrawalAsOne().addOrderBy_WithdrawalDatetime_Desc();
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertFalse(memberList.isEmpty());
boolean existsMemberWithdrawal = false;// 会員退会情報があってWithdrawalReasonCodeも存在する会員がいるか否か
boolean notExistsMemberWithdrawal = false;// 会員退会情報はあるけどWithdrawalReasonCodeがない会員がいるか否か
List notExistsMemberIdList = new ArrayList();
for (Member member : memberList) {
MemberWithdrawal memberWithdrawal = member.getMemberWithdrawalAsOne();
if (memberWithdrawal != null) {
log(member.getMemberName() + " -- " + memberWithdrawal.getWithdrawalReasonCode() + ", "
+ memberWithdrawal.getWithdrawalDatetime());
String withdrawalReasonCode = memberWithdrawal.getWithdrawalReasonCode();
assertNotNull(withdrawalReasonCode);
existsMemberWithdrawal = true;
} else {
// 会員退会情報は存在するけどWithdrawalReasonCodeが存在しない会員も取得できていること
log(member.getMemberName() + " -- " + memberWithdrawal);
notExistsMemberWithdrawal = true;
notExistsMemberIdList.add(member.getMemberId());
}
}
// 両方のパターンのデータがないとテストにならないので確認
assertTrue(existsMemberWithdrawal);
assertTrue(notExistsMemberWithdrawal);
// MemberWithdrawalを取得できなかった会員の会員退会情報がちゃんとあるかどうか確認
for (Integer memberId : notExistsMemberIdList) {
memberWithdrawalBhv.selectByPKValueWithDeletedCheck(memberId);// Expected no exception
}
}
// ===================================================================================
// Specify Column
// ==============
/**
* o 取得カラムの指定(SpecifyColumn): specify().columnXxx().
* 会員名称と会員ステータス名称だけの一覧を検索する。
*
* パフォーマンス上の考慮で1ミリ秒でも速くしたいシビアな検索処理の場合のために、
* 取得カラムを指定することができる。1テーブルのカラム数がやたら多いときに有効。
*
* @since 0.7.4
*/
public void test_specifyColumn() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.setupSelect_MemberStatus();
cb.specify().columnMemberName();
cb.specify().specifyMemberStatus().columnMemberStatusName();
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
assertNotNull(member.getMemberId()); // PK
assertNotNull(member.getMemberName()); // Specified
assertNull(member.getMemberAccount());
assertNull(member.getBirthdate());
assertNull(member.getFormalizedDatetime());
assertNull(member.getRegisterDatetime());
assertNull(member.getRegisterUser());
assertNull(member.getUpdateDatetime());
assertNull(member.getUpdateUser());
assertNull(member.getVersionNo());
assertNotNull(member.getMemberStatusCode()); // SetupSelect FK
assertNotNull(member.getMemberStatus().getMemberStatusCode()); // PK
assertNotNull(member.getMemberStatus().getMemberStatusName()); // Specified
assertNull(member.getMemberStatus().getDisplayOrder());
}
// [Description]
// A. 結合先テーブルに関しては、setupSelect_Xxx()を呼び出すことに変わりはなく、
// setupSelectしたテーブルの中から取得するカラムを指定する。
// -> setupSelectしてないテーブルのカラムを指定すると例外となる。
//
// B. カラムが指定されたテーブルのみカラムが絞り込まれ、カラムが指定されないテーブルは
// 通常通り全てのカラムが取得される。
// -> 例えば、ある一つの結合先テーブルだけカラム指定にすることも可能
//
// C. PKは、カラムが指定されなくても必ず取得される。(暗黙の指定カラム)
// D. SetupSelectされたFKは、カラムが指定されなくても必ず取得される。(暗黙の指定カラム)
}
// ===================================================================================
// (Specify)DerivedReferrer
// ========================
/**
* o 子テーブル導出カラムの指定((Specify)DerivedReferrer)-Max: specify().derivedXxxList().max().
* 会員の最終ログイン日時を取得。但し、モバイル端末からのログインは除く。
*
* 子テーブルの導出カラムを指定することができる。
* 例えば、子テーブルのとあるカラムの合計値や最大値などを取得することが可能である。
* 例題のSQL文のイメージは以下の通り:
*
*
* e.g. 最終ログイン日時を取得するSQL
* select member.*
* , (select max(LOGIN_DATETIME)
* from MEMBER_LOGIN
* where MEMBER_ID = member.MEMBER_ID
* and LOGIN_MOBILE_FLG = 0
* ) as LATEST_LOGIN_DATETIME
* from MEMBER member
*
* @since 0.7.4
*/
public void test_sepcify_derivedReferrer_max() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.specify().derivedMemberLoginList().max(new SubQuery() {
public void query(MemberLoginCB subCB) {
subCB.specify().columnLoginDatetime();// *Point!
subCB.query().setMobileLoginFlg_Equal_False();// Except Mobile
}
}, Member.ALIAS_latestLoginDatetime);
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertFalse(memberList.isEmpty());
boolean existsLoginDatetime = false;
boolean existsNullLoginDatetime = false;
for (Member member : memberList) {
String memberName = member.getMemberName();
Date latestLoginDatetime = member.getLatestLoginDatetime();
if (latestLoginDatetime != null) {
existsLoginDatetime = true;
} else {
// ログインを一度もしていない会員、もしくは、モバイルでしかログイン
// したことのない会員の最終ログイン日時はnullになる。
existsNullLoginDatetime = true;
}
log("memberName=" + memberName + ", latestLoginDatetime=" + latestLoginDatetime);
}
assertTrue(existsLoginDatetime);
assertTrue(existsNullLoginDatetime);
// [Description]
// A. 実装前に導出カラムを受け取るためのプロパティをEntityに定義する必要がある。
//
// ex) ExtendedのEntity(ExEntity)に最終ログイン日時のプロパティを手動で実装
// protected Date _latestLoginDatetime;
// public Date getLatestLoginDatetime() {
// return _latestLoginDatetime;
// }
// public void setLatestLoginDatetime(Date latestLoginDatetime) {
// _latestLoginDatetime = latestLoginDatetime;
// }
//
// B. 関数には、{max, min, sum, avg, count}が利用可能である。
// -> sumとavgは数値型のみ利用可能
// -> countの場合は子テーブルのPKを導出カラムとすることが基本
//
// C. 必ずSubQueryの中で導出カラムを「一つ」指定すること。
// -> 何も指定しない、もしくは、二つ以上の指定で例外発生
//
// D. 導出カラムは子テーブルのカラムのみサポートされる。
// -> 子テーブルの別の親テーブル(もしくはone-to-one)のカラムを導出カラムにはできない。
//
// E. 基点テーブルが複合主キーの場合はサポートされない。
//
// F. one-to-oneの子テーブルの場合はサポートされない。(そもそも不要である)
//
// G. SubQueryの中でsetupSelectやaddOrderByを指定しても無意味である。
//
// H. SpecifyColumnやUnionとも組み合わせて利用することが可能である。
//
// X. Eclipse(3.3)でのSubQuery実装手順:
// X-1. cb.sp まで書いて補完してEnter!
// --> cb.specify() になる
//
// X-2. cb.specify().der まで書いて補完して子テーブルを選択してEnter!
// --> cb.specify().deriveMemberLoginList() になる
//
// X-3. cb.specify().deriveMemberLoginList().ma まで書いて補完してEnter!
// --> cb.specify().deriveMemberLoginList().max(subQuery, aliasName) になる
// このとき[subQuery]部分が選択状態である
//
// X-4. cb.specify().deriveMemberLoginList().max(new , aliasName) まで書いて補完してEnter!
// --> カーソル位置から入力する文字は「new 」
// --> cb.specify().deriveMemberLoginList().max(new SubQuery, aliasName) になる
//
// X-5. cb.specify().deriveMemberLoginList().max(new SubQuery() {, aliasName) まで書いて補完してEnter!
// --> カーソル位置から入力する文字は「() {」
// --> cb.specify().deriveMemberLoginList().max(new SubQuery() {
// } , aliasName)
// になる
// --> [SubQuery]部分がコンパイルエラーになる
//
// X-6. コンパイルエラーの[SubQuery]にカーソルを合わせてctrl + 1を押してEnter!
// --> cb.specify().deriveMemberLoginList().max(new SubQuery() {
// public void query(MemberLoginCB subCB) {
// // todo Auto-generated method stub
// }
// } , aliasName)
// になる
// --> [aliasName]部分とセミコロンがないことでまだコンパイルエラーである
//
// X-7. aliasNameを指定して、セミコロンも付ける
// --> cb.specify().deriveMemberLoginList().max(new SubQuery() {
// public void query(MemberLoginCB subCB) {
// // todo Auto-generated method stub
// }
// } , "LATEST_LOGIN_DATETIME");
//
// X-8. TODOのコメント消して子テーブルの「導出カラムの指定」と「絞り込み条件」を実装する
}
/**
* 子テーブル導出カラムで並び替え(SpecifiedDerivedOrderBy)-Count: addSpecifiedDerivedOrderBy_Desc().
* 会員のログイン回数を取得する際に、ログイン回数の多い順そして会員IDの昇順で並べる。但し、モバイル端末からのログインは除く。
*
* 子テーブルの導出カラムで並び替えをすることができる。
* SQL文のイメージは以下の通り:
*
*
* ex) ログイン回数を取得するSQL
* select member.*
* , (select count(MEMBER_LOGIN_ID)
* from MEMBER_LOGIN
* where MEMBER_ID = member.MEMBER_ID
* ) as LOGIN_COUNT
* from MEMBER member
* order by LOGIN_COUNT desc, member.MEMBER_ID asc
*
* @since 0.7.4
*/
public void test_query_addSepcifidDerivedOrderBy_count() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.specify().derivedMemberLoginList().count(new SubQuery() {
public void query(MemberLoginCB subCB) {
subCB.specify().columnMemberLoginId();// *Point!
subCB.query().setMobileLoginFlg_Equal_False();// Except Mobile
}
}, Member.ALIAS_loginCount);
cb.query().addSpecifiedDerivedOrderBy_Desc(Member.ALIAS_loginCount);
cb.query().addOrderBy_MemberId_Asc();
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
String memberName = member.getMemberName();
Integer loginCount = member.getLoginCount();
assertNotNull(loginCount);// count()なので0件の場合は0になる(DB次第かも...)
log("memberName=" + memberName + ", loginCount=" + loginCount);
}
// [Description]
// A. (Specify)DerivedReferrerで指定されていないAliasNameを指定すると例外発生。
//
// B. withNullsFirst/Last()と組み合わせることも可能
// cb.query().addSpecifiedDerivedOrderBy_Desc("LOGIN_COUNT").withNullsLast();
}
/**
* 子テーブルカラムの種類数取得((Specify)DerivedReferrer)-CountDisticnt: derivedXxxList(), countDistinct().
* それぞれの会員の「購入済みプロダクトの種類数」を検索。
* @since 0.8.8
*/
public void test_sepcify_derivedReferrer_countDistinct() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.specify().derivedPurchaseList().countDistinct(new SubQuery() {
public void query(PurchaseCB subCB) {
subCB.specify().columnProductId();
subCB.query().setPaymentCompleteFlg_Equal_True();
}
}, Member.ALIAS_productKindCount);
cb.query().addSpecifiedDerivedOrderBy_Desc(Member.ALIAS_productKindCount);
cb.query().addOrderBy_MemberId_Asc();
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
String memberName = member.getMemberName();
Integer productKindCount = member.getProductKindCount();
assertNotNull(productKindCount);// count()なので0件の場合は0になる(DB次第かも...)
log("memberName=" + memberName + ", productKindCount=" + productKindCount);
}
assertTrue(cb.toDisplaySql().contains("count(distinct"));
}
// ===================================================================================
// (Query)DerivedReferrer
// ======================
/**
* 子テーブル導出カラムで絞り込み((Query)DerivedReferrer)-Max: derivedXxx(), max(), greaterEqual().
* 最大購入価格が1800円以上の支払済み購入のある会員一覧を検索。
* @since 0.8.8.1
*/
public void test_query_derivedReferrer_max_greaterEqual() {
// ## Arrange ##
Integer expected = 1800;
MemberCB cb = new MemberCB();
cb.query().setMemberStatusCode_Equal_正式会員();
cb.query().derivedPurchaseList().max(new SubQuery() {
public void query(PurchaseCB subCB) {
subCB.specify().columnPurchasePrice(); // *Point!
subCB.query().setPaymentCompleteFlg_Equal_True();
}
}).greaterEqual(expected); // *Don't forget!
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
memberBhv.loadPurchaseList(memberList, new ConditionBeanSetupper() {
public void setup(PurchaseCB cb) {
cb.query().setPaymentCompleteFlg_Equal_True();
}
});
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
log(member);
List purchaseList = member.getPurchaseList();
boolean exists = false;
for (Purchase purchase : purchaseList) {
Integer purchasePrice = purchase.getPurchasePrice();
if (purchasePrice >= expected) {
exists = true;
}
}
assertTrue(exists);
}
// [SQL]
// select dflocal.MEMBER_NAME as MEMBER_NAME, ...
// from MEMBER dflocal
// where dflocal.MEMBER_STATUS_CODE = 'FML'
// and (select max(dfsublocal_0.PURCHASE_PRICE)
// from PURCHASE dfsublocal_0
// where dfsublocal_0.MEMBER_ID = dflocal.MEMBER_ID
// and dfsublocal_0.PAYMENT_COMPLETE_FLG = 1
// ) >= 1800
// [Description]
// A. 比較演算子には、{=, >=, >, <=, <}が利用可能である。
//
// B. 関数には、{max, min, sum, avg, count, countDistinct}が利用可能である。
// -> sumとavgとcountとcountDistinctは数値型のみ利用可能
// -> countの場合は子テーブルのPKを導出カラムとすることが基本
//
// C. 必ずSubQueryの中で導出カラムを「一つ」指定すること。
// -> 何も指定しない、もしくは、二つ以上の指定で例外発生
//
// D. 導出カラムは基点テーブルのカラムのみサポートされる。
//
// E. 基点テーブルが複合主キーの場合はサポートされない。
//
// F. 必ずカラムの型とパラメータの型を合わせること!(count()とcountDistinct()は除く)
}
// ===================================================================================
// ScalarCondition
// ===============
/**
* 最大値レコードの検索(ScalarCondition)-Max: scalar_Equal(), max().
* 正式会員の中で一番若い(誕生日が最大値である)会員を検索。
* @since 0.8.8
*/
public void test_scalarCondition_Equal_max() {
// ## Arrange ##
Date expected = selectExpectedMaxBirthdayOn正式会員();
MemberCB cb = new MemberCB();
cb.query().setMemberStatusCode_Equal_正式会員();
cb.query().scalar_Equal().max(new SubQuery() {
public void query(MemberCB subCB) {
subCB.specify().columnBirthdate(); // *Point!
subCB.query().setMemberStatusCode_Equal_正式会員();
}
});
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
Date Birthdate = member.getBirthdate();
assertEquals(expected, Birthdate);
}
// [SQL]
// select dflocal.MEMBER_NAME as MEMBER_NAME, ...
// from MEMBER dflocal
// where dflocal.MEMBER_STATUS_CODE = 'FML'
// and dflocal.MEMBER_BIRTHDAY = (select max(dfsublocal_0.MEMBER_BIRTHDAY)
// from MEMBER dfsublocal_0
// where dfsublocal_0.MEMBER_STATUS_CODE = 'FML'
// )
// [Description]
// A. 比較演算子には、{=, >=, >, <=, <}が利用可能である。
//
// B. 関数には、{max, min, sum, avg}が利用可能である。
// -> sumとavgは数値型のみ利用可能
//
// C. 必ずSubQueryの中で導出カラムを「一つ」指定すること。
// -> 何も指定しない、もしくは、二つ以上の指定で例外発生
//
// D. 導出カラムは基点テーブルのカラムのみサポートされる。
//
// E. 基点テーブルが複合主キーの場合はサポートされない。
//
// F. 「とあるカラムの値が平均値を超えるレコードを検索」というのも可能である。
// cb.query().scalar_GreaterThan().avg(new SubQuery) {...
}
protected Date selectExpectedMaxBirthdayOn正式会員() {
Date expected = null;
{
MemberCB cb = new MemberCB();
cb.query().setMemberStatusCode_Equal_正式会員();
ListResultBean listAll = memberBhv.selectList(cb);
for (Member member : listAll) {
Date day = member.getBirthdate();
if (day != null && (expected == null || expected.getTime() < day.getTime())) {
expected = day;
}
}
}
return expected;
}
// ===================================================================================
// Fixed Condition
// ===============
/**
* 固定条件を加えたone-to-oneの取得:fixedCondition, selectSelect_Xxx(target).
*
* 会員と会員住所は構造的にはone-to-manyだが、固定条件を加えることによってone-to-oneになる
* という業務的な制約が存在する。その業務的な制約を活用して、会員を基点に会員住所を取得。
*
*
* 「何かしら固定条件を付与することによってone-to-manyがone-to-oneになる」というような場合、
* 「{DBFluteClient}/dfprop/additionalForeignKeyMap.dfprop」にて固定条件付きの疑似FK
* を設定し自動生成し直すことで、アプリケーション上でそのRelationを扱うことができる。
*
*
* ; FK_MEMBER_MEMBER_ADDRESS_VALID = map:{
* ; localTableName = MEMBER ; foreignTableName = MEMBER_ADDRESS
* ; localColumnName = MEMBER_ID ; foreignColumnName = MEMBER_ID
* ; fixedCondition =
* $$foreignAlias$$.VALID_BEGIN_DATE <= /[*]targetDate(Date)[*]/null
* and $$foreignAlias$$.VALID_END_DATE >= /[*]targetDate(Date)[*]/null
* ; fixedSuffix = AsValid
* }
* ※バインド変数コメントの「/[*]」の「[]」は実際には不要。JavaDoc上での記述の都合のために付けている。
*
*
* localTableName/foreignTableName/localColumnName/foreignColumnNameは通常の
* additionalForeignKeyMapでの設定方法と特に変わらないが、foreignTableが構造的には
* one-to-manyのmany側が指定されているのが特徴的である。
*
*
* fixedConditionが注目ポイントである。fixedConditionには固定条件を指定。
* これは「left outer join」のon句部分の結合条件としてそのまま展開される。
* 「$$foreignAlias$$」はforeignTableのAlias名として実行時に置換される。
* 「/[*]targetDate(Date)[*]/null」はバインド変数コメントとして解釈され、
* 自動生成時にsetupSelect_Xxx()やqueryXxx()の引数として展開される。
* その際、アプリケーション上の型は「(Date)」で指定された型となる。
* 「Date」なら「java.util.Date」、「Integer」なら「java.lang.Integer」となる。
* (ParameterBeanの型の自動解釈と同じである)
*
* バインド変数コメントを使わずにベタッと値を指定することも可能。
* 今回のExampleのような「有効期間」という概念で「固定条件に動的値」というのではなく、
* 「有効フラグがtrueのものを指定するとone-to-oneになる」というような
* 「固定条件に固定値」というパターンの場合はバインド変数コメントを使う必要はない。
* その場合、setupSelect_Xxx()やqueryXxx()の引数は無しで通常通りである。
*
*
* fixedSuffixは任意ではあるが、Relation名のユニーク性を厳密にするために
* 何かしら意味のあるSuffixを付けることが推奨される。今回のExampleだと、
* 「(会員を基点とした場合の)有効な会員住所」ということなので、「AsValid」
* というSuffixを付けている。
*
* @since 0.8.7
*/
public void test_fixedCondition_setupSelect() {
// ## Arrange ##
Calendar cal = Calendar.getInstance();
cal.set(2005, 11, 12); // 2005/12/12
Date targetDate = cal.getTime();
MemberCB cb = new MemberCB();
cb.setupSelect_MemberAddressAsValid(targetDate);
cb.query().addOrderBy_MemberId_Asc();
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertFalse(memberList.isEmpty());
boolean existsAddress = false;
SimpleDateFormat fmt = new SimpleDateFormat("yyyy/MM/dd");
String formattedTargetDate = fmt.format(targetDate);
log("[" + formattedTargetDate + "]");
for (Member member : memberList) {
String memberName = member.getMemberName();
MemberAddress memberAddressAsValid = member.getMemberAddressAsValid();
if (memberAddressAsValid != null) {
assertNotNull(memberAddressAsValid.getValidBeginDate());
assertNotNull(memberAddressAsValid.getValidEndDate());
String validBeginDate = fmt.format(memberAddressAsValid.getValidBeginDate());
String validEndDate = fmt.format(memberAddressAsValid.getValidEndDate());
assertTrue(validBeginDate.compareTo(formattedTargetDate) <= 0);
assertTrue(validEndDate.compareTo(formattedTargetDate) >= 0);
String address = memberAddressAsValid.getAddress();
log(memberName + ", " + validBeginDate + ", " + validEndDate + ", " + address);
existsAddress = true;
} else {
log(memberName + ", null");
}
}
assertTrue(existsAddress);
assertFalse(cb.toDisplaySql().contains("where")); // not use where clause
// [SQL]
// select dflocal.MEMBER_NAME as MEMBER_NAME, ...
// from MEMBER dflocal
// left outer join MEMBER_ADDRESS dfrelation_1
// on dflocal.MEMBER_ID = dfrelation_1.MEMBER_ID
// and dfrelation_1.VALID_BEGIN_DATE <= '2005-12-12'
// and dfrelation_1.VALID_END_DATE >= '2005-12-12'
// order by dflocal.MEMBER_ID asc
// [Description]
// A. selectSelect_Xxx(target)で別の値のtargetを指定して二回以上呼び出した時は最後の値が有効
// -> 「2007/01/01の会員住所」と「2008/01/01の会員住所」を同時に取り扱うことはできない
// (additionalForeignKeyにてSuffixだけ変えたリレーションをもう一つ設定すれば可能)
//
// B. fixedConditionを使ったRelationではReferrer関連のメソッドは生成されない
// ex) 会員住所のBehaviorにて会員に対するloadReferrerは生成されない
}
/**
* 固定条件を加えたone-to-oneの絞り込み:fixedCondition, queryXxx(target).
*
* 会員と会員住所は構造的にはone-to-manyだが、固定条件を加えることによってone-to-oneになる
* という業務的な制約が存在する。その業務的な制約を活用して、会員を基点に会員住所にて絞り込み。
*
* @since 0.8.7
*/
public void test_fixedCondition_query() {
// ## Arrange ##
Calendar cal = Calendar.getInstance();
cal.set(2005, 11, 12); // 2005/12/12
final Date targetDate = cal.getTime();
final String targetChar = "i";
MemberCB cb = new MemberCB();
LikeSearchOption likeSearchOption = new LikeSearchOption().likeContain();
cb.query().queryMemberAddressAsValid(targetDate).setAddress_LikeSearch(targetChar, likeSearchOption);
cb.query().queryMemberAddressAsValid(targetDate).addOrderBy_Address_Asc();
cb.query().addOrderBy_MemberId_Asc();
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertFalse(memberList.isEmpty());
memberBhv.loadMemberAddressList(memberList, new ConditionBeanSetupper() {
public void setup(MemberAddressCB cb) {
cb.query().setAddress_LikeSearch(targetChar, new LikeSearchOption().likeContain());
cb.query().setValidBeginDate_LessEqual(targetDate);
cb.query().setValidEndDate_GreaterEqual(targetDate);
}
});
SimpleDateFormat fmt = new SimpleDateFormat("yyyy/MM/dd");
String formattedTargetDate = fmt.format(targetDate);
log("[" + formattedTargetDate + "]");
for (Member member : memberList) {
MemberAddress memberAddressAsValid = member.getMemberAddressAsValid();
assertNull(memberAddressAsValid); // because of no setup-select.
List memberAddressList = member.getMemberAddressList();
assertEquals(1, memberAddressList.size());
MemberAddress memberAddress = memberAddressList.get(0);
String memberName = member.getMemberName();
Date validBeginDate = memberAddress.getValidBeginDate();
Date validEndDate = memberAddress.getValidEndDate();
String address = memberAddress.getAddress();
log(memberName + ", " + validBeginDate + ", " + validEndDate + ", " + address);
assertTrue(memberAddress.getAddress().contains("a"));
}
// [Description]
// A. queryXxx(target)で別の値のtargetを指定して二回以上呼び出した時は最後の値が有効
// -> 「2007/01/01の会員住所」と「2008/01/01の会員住所」を同時に取り扱うことはできない
//
// B. fixedConditionを使ったRelationではReferrer関連のメソッドは生成されない
// e.g. 会員住所のBehaviorにて会員に対するloadReferrerは生成されない
}
// ===================================================================================
// Statement Config
// ================
/**
* o Statementのコンフィグを設定: cb.configure(statementConfig).
*/
public void test_configure_statementConfig() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.configure(new StatementConfig().typeForwardOnly().queryTimeout(7).fetchSize(4).maxRows(3));
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertEquals(3, memberList.size());
}
// ===================================================================================
// ArrangeQuery
// ============
/**
* o where句の再利用(ArrangeQuery): cb.query().arrangeXxx().
* サービス会員を検索する。サービス会員は、商品ID "3" を購入したことのある、
* 会員名称が "S" で始まる正式会員とここでは定義する。
*
* ConditionQueryのExクラスに業務的にまとまった単位の条件設定メソッドを定義することで、
* その他のプロセスでも同じ条件(セット)を再利用できるようにすると、間違いが減ると同時に、
* 業務仕様の変更にも対応しやすくなる。
*
*/
public void test_arrangeQuery() {
// ## Arrange ##
MemberCB cb = new MemberCB();
cb.query().arrangeServiceMember();
cb.query().addOrderBy_MemberName_Asc();
// ## Act ##
ListResultBean memberList = memberBhv.selectList(cb);
// ## Assert ##
assertFalse(memberList.isEmpty());
for (Member member : memberList) {
log(member.toString());
assertTrue(member.getMemberName().startsWith("S"));
assertTrue(member.isMemberStatusCode正式会員());
}
// [SQL]
// select dflocal.MEMBER_ID as c1, ...
// from MEMBER dflocal
// where dflocal.MEMBER_NAME like 'S%' escape '|'
// and dflocal.MEMBER_STATUS_CODE = 'FML'
// and exists (select dfsublocal_0.MEMBER_ID
// from PURCHASE dfsublocal_0
// where dfsublocal_0.MEMBER_ID = dflocal.MEMBER_ID
// and dfsublocal_0.PRODUCT_ID = 3
// )
// order by dflocal.MEMBER_NAME asc
}
// ===================================================================================
// Display SQL
// ===========
/**
* o どんなにSubQueryやUnionの連打をしてもSQLが綺麗にフォーマット: toDisplaySql().
* ログでSQLが綺麗にフォーマットされていることを確認するだけ。
*
* デバッグのし易さの徹底と、ConditionBeanから外だしSQLへの移行時にスムーズにできるように
* ログのフォーマットを重視している。相関サブクエリなどはConditionBeanで書いてから出力された
* SQLをベースに実装した方が外だしSQLでありがちなケアレスバグも無くなる。
*
*/
public void test_toDisplaySql_Check_FormattedSQL() {
// - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
// 単にフォーマットされていることがみたいだけなので条件はかなり無茶苦茶
// - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
final MemberStatusCB cb = new MemberStatusCB();
cb.query().setDisplayOrder_Equal(3);
cb.query().existsMemberList(new SubQuery() {
public void query(MemberCB memberCB) {
memberCB.query().setBirthdate_LessEqual(new Date());
memberCB.query().existsPurchaseList(new SubQuery() {
public void query(PurchaseCB purchaseCB) {
purchaseCB.query().setPurchaseCount_GreaterEqual(2);
}
});
memberCB.query().existsMemberWithdrawalAsOne(new SubQuery() {
public void query(MemberWithdrawalCB subCB) {
final LikeSearchOption option = new LikeSearchOption().likeContain().escapeByPipeLine();
subCB.query().queryWithdrawalReason().setWithdrawalReasonText_LikeSearch("xxx", option);
subCB.union(new UnionQuery() {
public void query(MemberWithdrawalCB unionCB) {
unionCB.query().setWithdrawalReasonInputText_IsNotNull();
}
});
}
});
}
});
cb.query().setMemberStatusCode_Equal_正式会員();
cb.query().existsMemberLoginList(new SubQuery() {
public void query(MemberLoginCB subCB) {
subCB.query().inScopeMember(new SubQuery() {
public void query(MemberCB subCB) {
subCB.query().setBirthdate_GreaterEqual(new Date());
}
});
}
});
cb.query().addOrderBy_DisplayOrder_Asc().addOrderBy_MemberStatusCode_Desc();
log(ln() + cb.toDisplaySql());
}
}