类 yii\db\sqlite\conditions\InConditionBuilder
公共方法
方法 | 描述 | 定义于 |
---|---|---|
__construct() | ExpressionBuilderTrait 构造函数。 | yii\db\ExpressionBuilderTrait |
build() | 该方法根据 $expression 构建原始 SQL,该 SQL 不会被额外转义或引用。 | yii\db\conditions\InConditionBuilder |
受保护方法
方法 | 描述 | 定义于 |
---|---|---|
buildCompositeInCondition() | 构建 IN 条件的 SQL。 | yii\db\sqlite\conditions\InConditionBuilder |
buildSubqueryInCondition() | 构建 IN 条件的 SQL。 | yii\db\sqlite\conditions\InConditionBuilder |
buildValues() | 构建将在 yii\db\conditions\InCondition 中使用的 $values | yii\db\conditions\InConditionBuilder |
getNullCondition() | 根据运算符构建列的 is null/is not null 条件 | yii\db\conditions\InConditionBuilder |
getRawValuesFromTraversableObject() | yii\db\conditions\InConditionBuilder |
方法详情
定义于: yii\db\ExpressionBuilderTrait::__construct()
ExpressionBuilderTrait 构造函数。
public void __construct ( yii\db\QueryBuilder $queryBuilder ) | ||
$queryBuilder | yii\db\QueryBuilder |
public function __construct(QueryBuilder $queryBuilder)
{
$this->queryBuilder = $queryBuilder;
}
定义于: yii\db\conditions\InConditionBuilder::build()
该方法根据 $expression 构建原始 SQL,该 SQL 不会被额外转义或引用。
public string build ( yii\db\ExpressionInterface $expression, array &$params = [] ) | ||
$expression | yii\db\ExpressionInterface|yii\db\conditions\InCondition |
要构建的表达式。 |
$params | array |
绑定参数。 |
返回值 | string |
不会被额外转义或引用的原始 SQL。 |
---|
public function build(ExpressionInterface $expression, array &$params = [])
{
$operator = strtoupper($expression->getOperator());
$column = $expression->getColumn();
$values = $expression->getValues();
if ($column === []) {
// no columns to test against
return $operator === 'IN' ? '0=1' : '';
}
if ($values instanceof Query) {
return $this->buildSubqueryInCondition($operator, $column, $values, $params);
}
if (!is_array($values) && !$values instanceof \Traversable) {
// ensure values is an array
$values = (array) $values;
}
if (is_array($column)) {
if (count($column) > 1) {
return $this->buildCompositeInCondition($operator, $column, $values, $params);
}
$column = reset($column);
}
if ($column instanceof \Traversable) {
if (iterator_count($column) > 1) {
return $this->buildCompositeInCondition($operator, $column, $values, $params);
}
$column->rewind();
$column = $column->current();
}
if ($column instanceof Expression) {
$column = $column->expression;
}
if (is_array($values)) {
$rawValues = $values;
} elseif ($values instanceof \Traversable) {
$rawValues = $this->getRawValuesFromTraversableObject($values);
}
$nullCondition = null;
$nullConditionOperator = null;
if (isset($rawValues) && in_array(null, $rawValues, true)) {
$nullCondition = $this->getNullCondition($operator, $column);
$nullConditionOperator = $operator === 'IN' ? 'OR' : 'AND';
}
$sqlValues = $this->buildValues($expression, $values, $params);
if (empty($sqlValues)) {
if ($nullCondition === null) {
return $operator === 'IN' ? '0=1' : '';
}
return $nullCondition;
}
if (strpos($column, '(') === false) {
$column = $this->queryBuilder->db->quoteColumnName($column);
}
if (count($sqlValues) > 1) {
$sql = "$column $operator (" . implode(', ', $sqlValues) . ')';
} else {
$operator = $operator === 'IN' ? '=' : '<>';
$sql = $column . $operator . reset($sqlValues);
}
return $nullCondition !== null && $nullConditionOperator !== null
? sprintf('%s %s %s', $sql, $nullConditionOperator, $nullCondition)
: $sql;
}
构建 IN 条件的 SQL。
protected string buildCompositeInCondition ( $operator, $columns, $values, &$params ) | ||
$operator | string | |
$columns | array|Traversable | |
$values | array | |
$params | array | |
返回值 | string |
SQL |
---|
protected function buildCompositeInCondition($operator, $columns, $values, &$params)
{
$quotedColumns = [];
foreach ($columns as $i => $column) {
if ($column instanceof Expression) {
$column = $column->expression;
}
$quotedColumns[$i] = strpos($column, '(') === false ? $this->queryBuilder->db->quoteColumnName($column) : $column;
}
$vss = [];
foreach ($values as $value) {
$vs = [];
foreach ($columns as $i => $column) {
if ($column instanceof Expression) {
$column = $column->expression;
}
if (isset($value[$column])) {
$phName = $this->queryBuilder->bindParam($value[$column], $params);
$vs[] = $quotedColumns[$i] . ($operator === 'IN' ? ' = ' : ' != ') . $phName;
} else {
$vs[] = $quotedColumns[$i] . ($operator === 'IN' ? ' IS' : ' IS NOT') . ' NULL';
}
}
$vss[] = '(' . implode($operator === 'IN' ? ' AND ' : ' OR ', $vs) . ')';
}
return '(' . implode($operator === 'IN' ? ' OR ' : ' AND ', $vss) . ')';
}
构建 IN 条件的 SQL。
protected string buildSubqueryInCondition ( $operator, $columns, $values, &$params ) | ||
$operator | string | |
$columns | array|string | |
$values | yii\db\Query | |
$params | array | |
返回值 | string |
SQL |
---|---|---|
抛出异常 | yii\base\NotSupportedException |
如果 |
protected function buildSubqueryInCondition($operator, $columns, $values, &$params)
{
if (is_array($columns)) {
throw new NotSupportedException(__METHOD__ . ' is not supported by SQLite.');
}
return parent::buildSubqueryInCondition($operator, $columns, $values, $params);
}
定义于: yii\db\conditions\InConditionBuilder::buildValues()
构建将在 yii\db\conditions\InCondition 中使用的 $values
protected array buildValues ( yii\db\conditions\ConditionInterface $condition, $values, &$params ) | ||
$condition | yii\db\conditions\ConditionInterface|yii\db\conditions\InCondition | |
$values | array | |
$params | array |
绑定参数 |
返回值 | array |
为 SQL 占位符准备的 |
---|
protected function buildValues(ConditionInterface $condition, $values, &$params)
{
$sqlValues = [];
$column = $condition->getColumn();
if (is_array($column)) {
$column = reset($column);
}
if ($column instanceof \Traversable) {
$column->rewind();
$column = $column->current();
}
if ($column instanceof Expression) {
$column = $column->expression;
}
foreach ($values as $i => $value) {
if (is_array($value) || $value instanceof \ArrayAccess) {
$value = isset($value[$column]) ? $value[$column] : null;
}
if ($value === null) {
continue;
} elseif ($value instanceof ExpressionInterface) {
$sqlValues[$i] = $this->queryBuilder->buildExpression($value, $params);
} else {
$sqlValues[$i] = $this->queryBuilder->bindParam($value, $params);
}
}
return $sqlValues;
}
定义于: yii\db\conditions\InConditionBuilder::getNullCondition()
根据运算符构建列的 is null/is not null 条件
protected string getNullCondition ( $operator, $column ) | ||
$operator | string | |
$column | string | |
返回值 | string |
is null 或 is not null 条件 |
---|
protected function getNullCondition($operator, $column)
{
$column = $this->queryBuilder->db->quoteColumnName($column);
if ($operator === 'IN') {
return sprintf('%s IS NULL', $column);
}
return sprintf('%s IS NOT NULL', $column);
}
受保护 数组 getRawValuesFromTraversableObject ( 可遍历 $traversableObject ) | ||
$traversableObject | 可遍历对象 | |
返回值 | array |
原始值 |
---|
protected function getRawValuesFromTraversableObject(\Traversable $traversableObject)
{
$rawValues = [];
foreach ($traversableObject as $value) {
if (is_array($value)) {
$values = array_values($value);
$rawValues = array_merge($rawValues, $values);
} else {
$rawValues[] = $value;
}
}
return $rawValues;
}
注册 或 登录 以发表评论。