0 フォロワー

クラス yii\db\oci\conditions\InConditionBuilder

すべてのクラス | プロパティ | メソッド
継承yii\db\oci\conditions\InConditionBuilder » yii\db\conditions\InConditionBuilder
実装yii\db\ExpressionBuilderInterface
使用トレイトyii\db\ExpressionBuilderTrait
ソースコード https://github.com/yiisoft/yii2/blob/master/framework/db/oci/conditions/InConditionBuilder.php

保護されたプロパティ

継承されたプロパティを隠す

プロパティ タイプ 説明 定義元

パブリックメソッド

継承されたメソッドを隠す

メソッド 説明 定義元
__construct() ExpressionBuilderTrait のコンストラクタ。 yii\db\ExpressionBuilderTrait
build() このメソッドは、追加でエスケープまたは引用符で囲まれない $expression から生の SQL を構築します。 yii\db\oci\conditions\InConditionBuilder

保護されたメソッド

継承されたメソッドを隠す

メソッド 説明 定義元
buildCompositeInCondition() IN 条件の SQL を構築します。 yii\db\conditions\InConditionBuilder
buildSubqueryInCondition() IN 条件の SQL を構築します。 yii\db\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
splitCondition() Oracle DBMS は、IN 条件で 1000 を超えるパラメータをサポートしていません。 yii\db\oci\conditions\InConditionBuilder

メソッドの詳細

継承されたメソッドを隠す

__construct() パブリックメソッド

定義元: yii\db\ExpressionBuilderTrait::__construct()

ExpressionBuilderTrait のコンストラクタ。

public void __construct ( yii\db\QueryBuilder $queryBuilder )
$queryBuilder yii\db\QueryBuilder 

                public function __construct(QueryBuilder $queryBuilder)
{
    $this->queryBuilder = $queryBuilder;
}
build() パブリックメソッド

このメソッドは、追加でエスケープまたは引用符で囲まれない $expression から生の SQL を構築します。

public string build ( yii\db\ExpressionInterface $expression, array &$params = [] )
$expression yii\db\ExpressionInterface|yii\db\conditions\InCondition

構築される式。
$params array

バインドパラメータ。
return string

追加でエスケープまたは引用符で囲まれない生の SQL。

 

                public function build(ExpressionInterface $expression, array &$params = [])
{
    $splitCondition = $this->splitCondition($expression, $params);
    if ($splitCondition !== null) {
        return $splitCondition;
    }
    return parent::build($expression, $params);
}
buildCompositeInCondition() 保護されたメソッド

定義元: yii\db\conditions\InConditionBuilder::buildCompositeInCondition()

IN 条件の SQL を構築します。

protected string buildCompositeInCondition ( $operator, $columns, $values, &$params )
$operator string
$columns array|Traversable
$values array
$params array
return string

SQL

 

                protected function buildCompositeInCondition($operator, $columns, $values, &$params)
{
    $vss = [];
    foreach ($values as $value) {
        $vs = [];
        foreach ($columns as $column) {
            if ($column instanceof Expression) {
                $column = $column->expression;
            }
            if (isset($value[$column])) {
                $vs[] = $this->queryBuilder->bindParam($value[$column], $params);
            } else {
                $vs[] = 'NULL';
            }
        }
        $vss[] = '(' . implode(', ', $vs) . ')';
    }
    if (empty($vss)) {
        return $operator === 'IN' ? '0=1' : '';
    }
    $sqlColumns = [];
    foreach ($columns as $i => $column) {
        if ($column instanceof Expression) {
            $column = $column->expression;
        }
        $sqlColumns[] = strpos($column, '(') === false ? $this->queryBuilder->db->quoteColumnName($column) : $column;
    }
    return '(' . implode(', ', $sqlColumns) . ") $operator (" . implode(', ', $vss) . ')';
}
buildSubqueryInCondition() protected メソッド

定義場所: yii\db\conditions\InConditionBuilder::buildSubqueryInCondition()

IN 条件の SQL を構築します。

protected string buildSubqueryInCondition ( $operator, $columns, $values, &$params )
$operator string
$columns array|string
$values yii\db\Query
$params array
return string

SQL

 

                protected function buildSubqueryInCondition($operator, $columns, $values, &$params)
{
    $sql = $this->queryBuilder->buildExpression($values, $params);
    if (is_array($columns)) {
        foreach ($columns as $i => $col) {
            if ($col instanceof Expression) {
                $col = $col->expression;
            }
            if (strpos($col, '(') === false) {
                $columns[$i] = $this->queryBuilder->db->quoteColumnName($col);
            }
        }
        return '(' . implode(', ', $columns) . ") $operator $sql";
    }
    if ($columns instanceof Expression) {
        $columns = $columns->expression;
    }
    if (strpos($columns, '(') === false) {
        $columns = $this->queryBuilder->db->quoteColumnName($columns);
    }
    return "$columns $operator $sql";
}
buildValues() protected メソッド

定義場所: 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

バインドパラメータ
return 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;
}
getNullCondition() protected メソッド (バージョン 2.0.31 以降で利用可能)

定義場所: yii\db\conditions\InConditionBuilder::getNullCondition()

演算子に基づいて、列の is null/is not null 条件を構築します

protected string getNullCondition ( $operator, $column )
$operator string
$column string
return string

NULLであるか、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() protected メソッド (バージョン 2.0.31 以降で利用可能)

定義場所: yii\db\conditions\InConditionBuilder::getRawValuesFromTraversableObject()

protected array getRawValuesFromTraversableObject ( Traversable $traversableObject )
$traversableObject Traversable
return 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;
}
splitCondition() protected メソッド

Oracle DBMS は、IN 条件で 1000 を超えるパラメータをサポートしていません。

このメソッドは、長いIN条件をより小さい条件のシリーズに分割します。

protected string|null splitCondition ( yii\db\conditions\InCondition $condition, &$params )
$condition yii\db\ExpressionInterface|yii\db\conditions\InCondition

構築される式。
$params array

バインドパラメータ。
return string|null

分割が必要ない場合はNull。それ以外の場合は、構築されたSQL条件。

 

                protected function splitCondition(InCondition $condition, &$params)
{
    $operator = $condition->getOperator();
    $values = $condition->getValues();
    $column = $condition->getColumn();
    if ($values instanceof \Traversable) {
        $values = iterator_to_array($values);
    }
    if (!is_array($values)) {
        return null;
    }
    $maxParameters = 1000;
    $count = count($values);
    if ($count <= $maxParameters) {
        return null;
    }
    $slices = [];
    for ($i = 0; $i < $count; $i += $maxParameters) {
        $slices[] = $this->queryBuilder->createConditionFromArray([$operator, $column, array_slice($values, $i, $maxParameters)]);
    }
    array_unshift($slices, ($operator === 'IN') ? 'OR' : 'AND');
    return $this->queryBuilder->buildCondition($slices, $params);
}