org.dbflute.cbean.sqlclause.subquery.DerivedReferrer Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of dbflute-runtime Show documentation
Show all versions of dbflute-runtime Show documentation
The runtime library of DBFlute
/*
* Copyright 2014-2021 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
* either express or implied. See the License for the specific language
* governing permissions and limitations under the License.
*/
package org.dbflute.cbean.sqlclause.subquery;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import org.dbflute.cbean.cipher.GearedCipherManager;
import org.dbflute.cbean.coption.DerivedReferrerOption;
import org.dbflute.cbean.sqlclause.SqlClause;
import org.dbflute.dbmeta.DBMeta;
import org.dbflute.dbmeta.info.ColumnInfo;
import org.dbflute.dbmeta.name.ColumnRealName;
import org.dbflute.dbmeta.name.ColumnRealNameProvider;
import org.dbflute.dbmeta.name.ColumnSqlName;
import org.dbflute.dbmeta.name.ColumnSqlNameProvider;
import org.dbflute.util.Srl;
/**
* @author jflute
* @since 0.9.7.2 (2010/06/20 Sunday)
*/
public abstract class DerivedReferrer extends AbstractSubQuery {
// ===================================================================================
// Attribute
// =========
protected final String _mainSubQueryIdentity;
// ===================================================================================
// Constructor
// ===========
public DerivedReferrer(SubQueryPath subQueryPath, ColumnRealNameProvider localRealNameProvider,
ColumnSqlNameProvider subQuerySqlNameProvider, int subQueryLevel, SqlClause subQuerySqlClause, String subQueryIdentity,
DBMeta subQueryDBMeta, GearedCipherManager cipherManager, String mainSubQueryIdentity) {
super(subQueryPath, localRealNameProvider, subQuerySqlNameProvider, subQueryLevel, subQuerySqlClause, subQueryIdentity,
subQueryDBMeta, cipherManager);
_mainSubQueryIdentity = mainSubQueryIdentity;
}
// ===================================================================================
// Build Clause
// ============
public String buildDerivedReferrer(String function, String correlatedColumnDbName, String relatedColumnDbName,
String correlatedFixedCondition, DerivedReferrerOption option) {
setupOptionAttribute(option);
if (isSinglePrimaryKey(correlatedColumnDbName, relatedColumnDbName)) {
final ColumnRealName correlatedColumnRealName = _localRealNameProvider.provide(correlatedColumnDbName);
final ColumnSqlName relatedColumnSqlName = _subQuerySqlNameProvider.provide(relatedColumnDbName);
final String subQueryClause =
buildSubQueryClause(function, correlatedColumnRealName, relatedColumnSqlName, correlatedFixedCondition, option);
final String beginMark = resolveSubQueryBeginMark(_subQueryIdentity) + ln();
final String endMark = resolveSubQueryEndMark(_subQueryIdentity);
final String endIndent = " ";
return doBuildDerivedReferrer(function, correlatedColumnRealName, relatedColumnSqlName, subQueryClause, beginMark, endMark,
endIndent);
} else {
final List columnDbNameSplit = Srl.splitListTrimmed(correlatedColumnDbName, ",");
final ColumnRealName[] correlatedColumnRealNames = new ColumnRealName[columnDbNameSplit.size()];
for (int i = 0; i < columnDbNameSplit.size(); i++) {
correlatedColumnRealNames[i] = _localRealNameProvider.provide(columnDbNameSplit.get(i));
}
final List relatedColumnSplit = Srl.splitListTrimmed(relatedColumnDbName, ",");
final ColumnSqlName[] relatedColumnSqlNames = new ColumnSqlName[relatedColumnSplit.size()];
for (int i = 0; i < relatedColumnSplit.size(); i++) {
relatedColumnSqlNames[i] = _subQuerySqlNameProvider.provide(relatedColumnSplit.get(i));
}
final String subQueryClause =
buildSubQueryClause(function, correlatedColumnRealNames, relatedColumnSqlNames, correlatedFixedCondition, option);
final String beginMark = resolveSubQueryBeginMark(_subQueryIdentity) + ln();
final String endMark = resolveSubQueryEndMark(_subQueryIdentity);
final String endIndent = " ";
return doBuildDerivedReferrer(function, correlatedColumnRealNames, relatedColumnSqlNames, subQueryClause, beginMark, endMark,
endIndent);
}
}
protected void setupOptionAttribute(DerivedReferrerOption option) {
ColumnInfo columnInfo = _subQuerySqlClause.getSpecifiedColumnInfoAsOne();
if (columnInfo == null) {
columnInfo = _subQuerySqlClause.getSpecifiedDerivingColumnInfoAsOne();
}
option.xsetTargetColumnInfo(columnInfo); // basically not null (checked before)
option.xjudgeDatabase(_subQuerySqlClause);
}
protected abstract String doBuildDerivedReferrer(String function, ColumnRealName correlatedColumnRealName,
ColumnSqlName relatedColumnSqlName, String subQueryClause, String beginMark, String endMark, String endIndent);
protected abstract String doBuildDerivedReferrer(String function, ColumnRealName[] correlatedColumnRealNames,
ColumnSqlName[] relatedColumnSqlNames, String subQueryClause, String beginMark, String endMark, String endIndent);
// ===================================================================================
// (Single PrimaryKey) SubQuery Clause
// ===================================
/**
* Build the clause of sub-query by single primary key.
* @param function The expression for deriving function. (NotNull)
* @param correlatedColumnRealName The real names of correlated column that is main-query table's column. (NotNull)
* @param relatedColumnSqlName The real names of related column that is sub-query table's column. (NotNull)
* @param correlatedFixedCondition The fixed condition as correlated condition. (NullAllowed)
* @param option The option of DerivedReferrer. (NotNull)
* @return The clause of sub-query. (NotNull)
*/
protected String buildSubQueryClause(String function, ColumnRealName correlatedColumnRealName, ColumnSqlName relatedColumnSqlName,
String correlatedFixedCondition, DerivedReferrerOption option) {
final String tableAliasName = getSubQueryLocalAliasName();
final ColumnSqlName derivedColumnSqlName = getDerivedColumnSqlName();
if (derivedColumnSqlName == null) {
throwDerivedReferrerInvalidColumnSpecificationException(function);
}
final ColumnRealName derivedColumnRealName = getDerivedColumnRealName();
final String subQueryClause;
if (_subQuerySqlClause.hasUnionQuery()) {
subQueryClause = buildUnionSubQueryClause(function, correlatedColumnRealName, relatedColumnSqlName, option, tableAliasName,
derivedColumnRealName, derivedColumnSqlName, correlatedFixedCondition);
} else {
final String selectClause = "select " + buildFunctionPart(function, derivedColumnRealName, option, false);
final String fromWhereClause;
if (option.isSuppressCorrelation()) { // e.g. myselfDerived
fromWhereClause = buildPlainFromWhereClause(selectClause, tableAliasName, correlatedFixedCondition);
} else { // basically here
fromWhereClause = buildCorrelationFromWhereClause(selectClause, tableAliasName, correlatedColumnRealName,
relatedColumnSqlName, correlatedFixedCondition);
}
subQueryClause = selectClause + " " + fromWhereClause;
}
return resolveSubQueryLevelVariable(subQueryClause);
}
// -----------------------------------------------------
// (Single PrimaryKey) Union Handling
// ----------------------------------
protected String buildUnionSubQueryClause(String function, ColumnRealName correlatedColumnRealName, ColumnSqlName relatedColumnSqlName,
DerivedReferrerOption option, String tableAliasName, ColumnRealName derivedColumnRealName, ColumnSqlName derivedColumnSqlName,
String correlatedFixedCondition) {
final String mainSql = buildUnionMainPartClause(relatedColumnSqlName, tableAliasName, derivedColumnRealName, derivedColumnSqlName,
correlatedFixedCondition);
final String mainAlias = buildSubQueryMainAliasName();
final String whereJoinCondition;
if (option.isSuppressCorrelation()) { // e.g. myselfDerived
whereJoinCondition = "";
} else { // mainly here
final ColumnRealName relatedColumnRealName = ColumnRealName.create(mainAlias, relatedColumnSqlName);
final StringBuilder sb = new StringBuilder();
sb.append(ln()).append(" where ");
sb.append(relatedColumnRealName).append(" = ").append(correlatedColumnRealName);
if (isFixedCondition(correlatedFixedCondition)) {
sb.append(ln()).append(" and ");
sb.append(Srl.replace(correlatedFixedCondition, tableAliasName + ".", mainAlias + "."));
}
whereJoinCondition = sb.toString(); // correlation
}
final ColumnRealName mainDerivedColumnRealName = ColumnRealName.create(mainAlias, derivedColumnSqlName);
return doBuildUnionSubQueryClause(function, option, mainSql, mainAlias, whereJoinCondition, mainDerivedColumnRealName);
}
protected String buildUnionMainPartClause(ColumnSqlName relatedColumnSqlName, String tableAliasName,
ColumnRealName derivedColumnRealName, ColumnSqlName derivedColumnSqlName, String correlatedFixedCondition) {
// derivedColumnSqlName : e.g. PURCHASE_PRICE
// derivedRealSqlName : might be sub-query
final ColumnSqlName derivedRealSqlName = derivedColumnRealName.getColumnSqlName();
final StringBuilder keySb = new StringBuilder();
if (isFixedCondition(correlatedFixedCondition)) {
setupUnionMainForFixedCondition(keySb, tableAliasName, derivedColumnSqlName);
} else { // no fixed condition, mainly here
final List pkList = _subQueryDBMeta.getPrimaryInfo().getPrimaryColumnList();
for (ColumnInfo pk : pkList) {
final ColumnSqlName pkSqlName = pk.getColumnSqlName();
if (pkSqlName.equals(derivedRealSqlName) || pkSqlName.equals(relatedColumnSqlName)) {
continue; // to suppress same columns selected
}
keySb.append(keySb.length() > 0 ? ", " : "");
keySb.append(ColumnRealName.create(tableAliasName, pk.getColumnSqlName()));
}
if (!relatedColumnSqlName.equals(derivedRealSqlName)) { // to suppress same columns selected
keySb.append(keySb.length() > 0 ? ", " : "");
keySb.append(ColumnRealName.create(tableAliasName, relatedColumnSqlName));
}
}
setupUnionMainForDerivedColumn(keySb, derivedColumnRealName, derivedColumnSqlName, derivedRealSqlName);
return completeUnionMainWholeClause(tableAliasName, keySb);
}
protected String doBuildUnionSubQueryClause(String function, DerivedReferrerOption option, String mainSql, String mainAlias,
String whereJoinCondition, ColumnRealName mainDerivedColumnRealName) {
final String beginMark = resolveSubQueryBeginMark(_mainSubQueryIdentity) + ln();
final String endMark = resolveSubQueryEndMark(_mainSubQueryIdentity);
return "select " + buildFunctionPart(function, mainDerivedColumnRealName, option, true) // select
+ ln() + " from (" + beginMark + mainSql + ln() + " ) " + mainAlias + endMark // from
+ whereJoinCondition; // where
}
protected void setupUnionMainForFixedCondition(StringBuilder keySb, String tableAliasName, ColumnSqlName derivedColumnSqlName) {
// all columns because fixed condition might contain them
final List columnInfoList = _subQueryDBMeta.getColumnInfoList();
for (ColumnInfo columnInfo : columnInfoList) {
final ColumnSqlName sqlName = columnInfo.getColumnSqlName();
if (sqlName.equals(derivedColumnSqlName)) {
continue; // to suppress same columns selected
}
final ColumnRealName realName = ColumnRealName.create(tableAliasName, columnInfo.getColumnSqlName());
keySb.append(keySb.length() > 0 ? ", " : "");
keySb.append(realName);
}
}
protected void setupUnionMainForDerivedColumn(StringBuilder keySb, ColumnRealName derivedColumnRealName,
ColumnSqlName derivedColumnSqlName, ColumnSqlName derivedRealSqlName) {
// derivedColumnSqlName : e.g. PURCHASE_PRICE
// derivedRealSqlName : might be sub-query
if (mightBeSubQueryOrCalculation(derivedRealSqlName)) { // nested sub-query or calculation
if (!isNestedDerivedReferrer(derivedRealSqlName)) { // might be calculation (needs to resolve location)
// #hope if correlation column is same as derived column with calculation, duplicate column error
keySb.append(keySb.length() > 0 ? ", " : "");
final String realNameExp = derivedColumnRealName.toString();
final String locationResolved = _subQueryPath.resolveParameterLocationPath(realNameExp);
keySb.append(locationResolved).append(" as ").append(derivedColumnSqlName);
}
// *skip here if nested sub-query, handled at function part in select clause
} else {
keySb.append(keySb.length() > 0 ? ", " : "");
keySb.append(derivedColumnRealName);
}
}
protected boolean mightBeSubQueryOrCalculation(ColumnSqlName derivedRealSqlName) {
final String exp = derivedRealSqlName.toString();
return exp.contains(" ") || exp.contains("("); // not accurate but small problem
}
protected String completeUnionMainWholeClause(String tableAliasName, StringBuilder keySb) {
final String selectClause = "select " + keySb.toString();
final String fromWhereClause = buildPlainFromWhereClause(selectClause, tableAliasName, null);
return selectClause + " " + fromWhereClause;
}
// ===================================================================================
// SubQuery Clause (Compound PrimaryKey)
// =====================================
/**
* Build the clause of sub-query by compound primary key.
* @param function The expression for deriving function. (NotNull)
* @param correlatedColumnRealNames The real names of correlated column that is main-query table's column. (NotNull)
* @param relatedColumnSqlNames The real names of related column that is sub-query table's column. (NotNull)
* @param correlatedFixedCondition The fixed condition as correlated condition. (NullAllowed)
* @param option The option of DerivedReferrer. (NotNull)
* @return The clause of sub-query. (NotNull)
*/
protected String buildSubQueryClause(String function, ColumnRealName[] correlatedColumnRealNames, ColumnSqlName[] relatedColumnSqlNames,
String correlatedFixedCondition, DerivedReferrerOption option) {
final String tableAliasName = getSubQueryLocalAliasName();
final ColumnSqlName derivedColumnSqlName = getDerivedColumnSqlName();
if (derivedColumnSqlName == null) {
throwDerivedReferrerInvalidColumnSpecificationException(function);
}
final ColumnRealName derivedColumnRealName = getDerivedColumnRealName();
final String subQueryClause;
if (_subQuerySqlClause.hasUnionQuery()) {
subQueryClause = buildUnionSubQueryClause(function, correlatedColumnRealNames, relatedColumnSqlNames, option, tableAliasName,
derivedColumnRealName, derivedColumnSqlName, correlatedFixedCondition);
} else {
final String selectClause = "select " + buildFunctionPart(function, derivedColumnRealName, option, false);
final String fromWhereClause;
if (option.isSuppressCorrelation()) { // e.g. myselfDerived
fromWhereClause = buildPlainFromWhereClause(selectClause, tableAliasName, correlatedFixedCondition);
} else { // basically here
fromWhereClause = buildCorrelationFromWhereClause(selectClause, tableAliasName, correlatedColumnRealNames,
relatedColumnSqlNames, correlatedFixedCondition);
}
subQueryClause = selectClause + " " + fromWhereClause;
}
return resolveSubQueryLevelVariable(subQueryClause);
}
// -----------------------------------------------------
// (Compound PrimaryKey) Union Handling
// ------------------------------------
protected String buildUnionSubQueryClause(String function, ColumnRealName[] correlatedColumnRealNames,
ColumnSqlName[] relatedColumnSqlNames, DerivedReferrerOption option, String tableAliasName,
ColumnRealName derivedColumnRealName, ColumnSqlName derivedColumnSqlName, String correlatedFixedCondition) {
final String mainSql = buildUnionMainPartClause(correlatedColumnRealNames, relatedColumnSqlNames, tableAliasName,
derivedColumnRealName, derivedColumnSqlName, correlatedFixedCondition);
final String mainAlias = buildSubQueryMainAliasName();
final String whereJoinCondition;
if (option.isSuppressCorrelation()) { // e.g. myselfDerived
whereJoinCondition = "";
} else { // mainly here
final StringBuilder sb = new StringBuilder();
sb.append(ln()).append(" where ");
for (int i = 0; i < correlatedColumnRealNames.length; i++) {
if (i > 0) {
sb.append(ln()).append(" and ");
}
sb.append(ColumnRealName.create(mainAlias, relatedColumnSqlNames[i]));
sb.append(" = ").append(correlatedColumnRealNames[i]);
}
if (isFixedCondition(correlatedFixedCondition)) {
if (correlatedColumnRealNames.length > 0) { // basically true (but just in case)
sb.append(ln()).append(" and ");
}
sb.append(Srl.replace(correlatedFixedCondition, tableAliasName + ".", mainAlias + "."));
}
whereJoinCondition = sb.toString(); // correlation
}
final ColumnRealName mainDerivedColumnRealName = ColumnRealName.create(mainAlias, derivedColumnSqlName);
return doBuildUnionSubQueryClause(function, option, mainSql, mainAlias, whereJoinCondition, mainDerivedColumnRealName);
}
protected String buildUnionMainPartClause(ColumnRealName[] correlatedColumnRealNames, ColumnSqlName[] relatedColumnSqlNames,
String tableAliasName, ColumnRealName derivedColumnRealName, ColumnSqlName derivedColumnSqlName,
String correlatedFixedCondition) {
// similar to simple primary key so refer it
final StringBuilder keySb = new StringBuilder();
final ColumnSqlName derivedRealSqlName = derivedColumnRealName.getColumnSqlName();
if (isFixedCondition(correlatedFixedCondition)) {
setupUnionMainForFixedCondition(keySb, tableAliasName, derivedColumnSqlName);
} else { // no fixed condition, mainly here
final Set relatedColumnSqlSet = new HashSet();
for (ColumnSqlName columnSqlName : relatedColumnSqlNames) {
relatedColumnSqlSet.add(columnSqlName);
}
final ColumnSqlName derivedSqlName = derivedRealSqlName;
final List pkList = _subQueryDBMeta.getPrimaryInfo().getPrimaryColumnList();
for (ColumnInfo pk : pkList) {
final ColumnSqlName pkSqlName = pk.getColumnSqlName();
if (pkSqlName.equals(derivedSqlName) || relatedColumnSqlSet.contains(pkSqlName)) {
continue; // to suppress same columns selected
}
keySb.append(keySb.length() > 0 ? ", " : "");
keySb.append(ColumnRealName.create(tableAliasName, pk.getColumnSqlName()));
}
for (ColumnSqlName relatedSqlName : relatedColumnSqlNames) {
if (relatedSqlName.equals(derivedSqlName)) {
continue; // to suppress same columns selected
}
keySb.append(keySb.length() > 0 ? ", " : "");
keySb.append(ColumnRealName.create(tableAliasName, relatedSqlName));
}
}
setupUnionMainForDerivedColumn(keySb, derivedColumnRealName, derivedColumnSqlName, derivedRealSqlName);
return completeUnionMainWholeClause(tableAliasName, keySb);
}
// ===================================================================================
// Derived Column
// ==============
protected ColumnSqlName getDerivedColumnSqlName() {
return _subQuerySqlClause.getSpecifiedResolvedColumnSqlNameAsOne();
}
protected ColumnRealName getDerivedColumnRealName() {
return _subQuerySqlClause.getSpecifiedResolvedColumnRealNameAsOne(); // resolved calculation
}
// ===================================================================================
// Function Part
// =============
protected String buildFunctionPart(String function, ColumnRealName columnRealName, DerivedReferrerOption option, boolean union) {
final String connector = buildFunctionConnector(function);
final String columnWithEndExp;
{
final String aliasDef = getDerivedReferrerNestedAliasDef();
final ColumnSqlName columnSqlName = columnRealName.getColumnSqlName();
if (isNestedDerivedReferrer(columnSqlName)) { // e.g. select max((select ... from ...))
// needs to resolve location path on nested query, connect it to base location
final String sqlNameExp = columnSqlName.toString(); // no use tableAlias here because of sub-query
final String localtionResolved = _subQueryPath.resolveParameterLocationPath(sqlNameExp);
final String aliasResolved = resolveNestedDerivedReferrerAliasDef(localtionResolved, aliasDef);
columnWithEndExp = union ? resolveUnionCorrelation(aliasResolved) : aliasResolved;
} else { // normal column derived
// might be calculation e.g. sub1loc.DOCKSIDE_PRICE + coalesce(HUNGER_PRICE, 0)
// so also needs to resolve location here
final ColumnInfo derivedColumnInfo = _subQuerySqlClause.getSpecifiedColumnInfoAsOne();
final String localtionResolved = _subQueryPath.resolveParameterLocationPath(columnRealName.toString());
columnWithEndExp = decrypt(derivedColumnInfo, localtionResolved) + ")";
}
}
final String functionExp = function + connector + columnWithEndExp;
return option.filterFunction(functionExp);
}
protected String resolveNestedDerivedReferrerAliasDef(String derivedExp, String aliasDef) {
return replace(derivedExp, aliasDef, ")"); // ' as dfrelview' to ')'
}
protected String resolveUnionCorrelation(String derivedExp) {
// replace e.g. ... = sub1loc.MEMBER_ID to ... = sub1main.MEMBER_ID
final String basePointAlias = _subQuerySqlClause.getBasePointAliasName();
final String mainAlias = buildSubQueryMainAliasName();
return replace(derivedExp, basePointAlias, mainAlias);
}
// ===================================================================================
// Assist Helper
// =============
protected boolean isFixedCondition(String correlatedFixedCondition) {
return correlatedFixedCondition != null && correlatedFixedCondition.trim().length() > 0;
}
protected boolean isNestedDerivedReferrer(String name) {
return name.contains(getDerivedReferrerNestedAliasDef());
}
protected boolean isNestedDerivedReferrer(ColumnSqlName name) {
return name.toString().contains(getDerivedReferrerNestedAliasDef());
}
protected String getDerivedReferrerNestedAliasDef() {
return " as " + getDerivedReferrerNestedAlias();
}
protected String getDerivedReferrerNestedAlias() {
return _subQuerySqlClause.getDerivedReferrerNestedAlias();
}
// ===================================================================================
// Assert/Exception
// ================
protected abstract void throwDerivedReferrerInvalidColumnSpecificationException(String function);
// *unused for a long time, DBMS checks it in many cases and cannot help keeping compatible
//protected void assertDerivedReferrerColumnType(String function, String derivedColumnDbName) {
// if (derivedColumnDbName.contains(".")) {
// derivedColumnDbName = derivedColumnDbName.substring(derivedColumnDbName.lastIndexOf(".") + ".".length());
// }
// final Class derivedColumnType = _subQueryDBMeta.findColumnInfo(derivedColumnDbName).getObjectNativeType();
// doAssertDerivedReferrerColumnType(function, derivedColumnDbName, derivedColumnType);
//}
//
//protected abstract void doAssertDerivedReferrerColumnType(String function, String derivedColumnDbName, Class deriveColumnType);
// ===================================================================================
// Function Connector
// ==================
protected String buildFunctionConnector(String function) {
if (function != null && function.endsWith("(distinct")) { // for example 'count(distinct'
return " ";
} else {
return "(";
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy