package io.ebeaninternal.api; import io.ebeaninternal.server.persist.MultiValueWrapper; import io.ebeaninternal.server.querydefn.NaturalKeyBindParam; import java.io.Serializable; import java.util.ArrayList; import java.util.Collection; import java.util.LinkedHashMap; import java.util.List; import java.util.Map; import java.util.Map.Entry; /** * Parameters used for binding to a statement. *
* Supports ordered or named parameters. *
*/ public class BindParams implements Serializable { private static final long serialVersionUID = 4541081933302086285L; private final List positionedParameters = new ArrayList<>(); private final Map* This is to handle binding collections to in clauses. The number of values * in the collection effects the query (number of bind values) and so must be * taken into account when calculating the query hash. *
*/ public String calcQueryPlanHash() { StringBuilder builder = new StringBuilder(); buildQueryPlanHash(builder); return builder.toString(); } /** * Calculate and return a query plan bind hash with total bind count. */ public void buildQueryPlanHash(StringBuilder builder) { int tempBindCount; int bc = 0; for (Param param : positionedParameters) { tempBindCount = param.queryBindCount(); bc += tempBindCount; builder.append("p").append(bc).append(" ?:").append(tempBindCount).append(","); } for (Map.Entry* Needs special treatment as the value should not be included in a log. *
*/ public Param setEncryptionKey(String name, Object value) { Param p = getParam(name); p.setEncryptionKey(value); return p; } /** * Register the named parameter as an Out parameter. */ public void registerOut(String name, int outType) { Param p = getParam(name); p.setOutType(outType); } /** * Return the Parameter for a given position. */ public Param getParameter(int position) { // Used to read Out value by CallableSql return getParam(position); } /** * Return the named parameter. */ public Param getParameter(String name) { return getParam(name); } /** * Return the values of ordered parameters. */ public List positionedParameters() { return positionedParameters; } /** * Set the sql with named parameters replaced with place holder ?. */ public void setPreparedSql(String preparedSql) { this.preparedSql = preparedSql; } /** * Return the sql with ? place holders (named parameters have been processed * and ordered). */ public String getPreparedSql() { return preparedSql; } /** * Return true if the bind hash and count has not changed. */ public boolean isSameBindHash() { if (bindHash == null) { bindHash = calcQueryPlanHash(); return false; } String oldPlan = bindHash; bindHash = calcQueryPlanHash(); return bindHash.equals(oldPlan); } /** * Create a new positioned parameters orderedList. */ public OrderedList createOrderedList() { positionedParameters.clear(); return new OrderedList(positionedParameters); } /** * The bind parameters in the correct binding order. ** This is the result of converting sql with named parameters * into sql with ? and ordered parameters. *
*/ public static final class OrderedList { private final List paramList; private final StringBuilder preparedSql; public OrderedList() { this(new ArrayList<>()); } public OrderedList(List paramList) { this.paramList = paramList; this.preparedSql = new StringBuilder(); } /** * Add a parameter in the correct binding order. */ public void add(Param param) { paramList.add(param); } /** * Return the number of bind parameters in this list. */ public int size() { return paramList.size(); } /** * Returns the ordered list of bind parameters. */ public List list() { return paramList; } /** * Append parsedSql that has named parameters converted into ?. */ public void appendSql(String parsedSql) { preparedSql.append(parsedSql); } public String getPreparedSql() { return preparedSql.toString(); } } /** * A In Out capable parameter for the CallableStatement. */ public static final class Param implements Serializable { private static final long serialVersionUID = 1L; private boolean encryptionKey; private boolean isInParam; private boolean isOutParam; private int type; private Object inValue; private Object outValue; /** * Construct a Parameter. */ public Param() { } public int queryBindCount() { if (inValue == null) { return 0; } if (inValue instanceof Collection>) { return ((Collection>) inValue).size(); } return 1; } /** * Create a deep copy of the Param. */ public Param copy() { Param copy = new Param(); copy.isInParam = isInParam; copy.isOutParam = isOutParam; copy.type = type; copy.inValue = inValue; copy.outValue = outValue; return copy; } @Override public int hashCode() { int hc = getClass().hashCode(); hc = hc * 92821 + (isInParam ? 0 : 1); hc = hc * 92821 + (isOutParam ? 0 : 1); hc = hc * 92821 + (type); hc = hc * 92821 + (inValue == null ? 0 : inValue.hashCode()); return hc; } @Override public boolean equals(Object o) { return o != null && (o == this || (o instanceof Param) && hashCode() == o.hashCode()); } /** * Return true if this is an In parameter that needs to be bound before * execution. */ public boolean isInParam() { return isInParam; } /** * Return true if this is an out parameter that needs to be registered * before execution. */ public boolean isOutParam() { return isOutParam; } /** * Return the jdbc type of this parameter. Used for registering Out * parameters and setting NULL In parameters. */ public int getType() { return type; } /** * Set the Out parameter type. */ public void setOutType(int type) { this.type = type; this.isOutParam = true; } /** * Set the In value. */ public void setInValue(Object in) { this.inValue = in; this.isInParam = true; } /** * Set an encryption key (which can not be logged). */ public void setEncryptionKey(Object in) { this.inValue = in; this.isInParam = true; this.encryptionKey = true; } /** * Specify that the In parameter is NULL and the specific type that it * is. */ public void setInNullType(int type) { this.type = type; this.inValue = null; this.isInParam = true; } /** * Return the OUT value that was retrieved. This value is set after * CallableStatement was executed. */ public Object getOutValue() { return outValue; } /** * Return the In value. If this is null, then the type should be used to * specify the type of the null. */ public Object getInValue() { return inValue; } /** * Set the OUT value returned by a CallableStatement after it has * executed. */ public void setOutValue(Object out) { this.outValue = out; } /** * If true do not include this value in a transaction log. */ public boolean isEncryptionKey() { return encryptionKey; } } }