0 フォロワー

クラス yii\db\pgsql\ArrayExpressionBuilder

継承	yii\db\pgsql\ArrayExpressionBuilder
実装	yii\db\ExpressionBuilderInterface
使用トレイト	yii\db\ExpressionBuilderTrait
利用可能バージョン	2.0.14
ソースコード	https://github.com/yiisoft/yii2/blob/master/framework/db/pgsql/ArrayExpressionBuilder.php

クラス ArrayExpressionBuilder は PostgreSQL DBMS 用の yii\db\ArrayExpression を構築します。

保護されたプロパティ

継承されたプロパティを非表示

プロパティ	型	説明	定義元

パブリックメソッド

継承されたメソッドを非表示

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

保護されたメソッド

継承されたメソッドを非表示

メソッド	説明	定義元
buildPlaceholders()	$expression 値からプレースホルダ配列を構築します	yii\db\pgsql\ArrayExpressionBuilder
buildSubqueryArray()	サブクエリ SQL から配列式を構築します。	yii\db\pgsql\ArrayExpressionBuilder
getTypehint()		yii\db\pgsql\ArrayExpressionBuilder
typecastValue()	$expression で使用する $value をキャストします	yii\db\pgsql\ArrayExpressionBuilder

メソッド詳細

継承されたメソッドを非表示

__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\ArrayExpression\|yii\db\ExpressionInterface	構築する式
$params	配列	バインドパラメータ。
戻り値	文字列	追加でエスケープや引用符で囲まれることのない生の SQL。

ソースコード

                public function build(ExpressionInterface $expression, array &$params = [])
{
    $value = $expression->getValue();
    if ($value === null) {
        return 'NULL';
    }
    if ($value instanceof Query) {
        list ($sql, $params) = $this->queryBuilder->build($value, $params);
        return $this->buildSubqueryArray($sql, $expression);
    }
    $placeholders = $this->buildPlaceholders($expression, $params);
    return 'ARRAY[' . implode(', ', $placeholders) . ']' . $this->getTypehint($expression);
}

buildPlaceholders() 保護されたメソッド

$expression 値からプレースホルダ配列を構築します

protected array buildPlaceholders ( yii\db\ExpressionInterface $expression, &$params )
$expression	yii\db\ExpressionInterface\|yii\db\ArrayExpression
$params	配列	バインドパラメータ。

ソースコード

                protected function buildPlaceholders(ExpressionInterface $expression, &$params)
{
    $value = $expression->getValue();
    $placeholders = [];
    if ($value === null || !is_array($value) && !$value instanceof \Traversable) {
        return $placeholders;
    }
    if ($expression->getDimension() > 1) {
        foreach ($value as $item) {
            $placeholders[] = $this->build($this->unnestArrayExpression($expression, $item), $params);
        }
        return $placeholders;
    }
    foreach ($value as $item) {
        if ($item instanceof Query) {
            list ($sql, $params) = $this->queryBuilder->build($item, $params);
            $placeholders[] = $this->buildSubqueryArray($sql, $expression);
            continue;
        }
        $item = $this->typecastValue($expression, $item);
        if ($item instanceof ExpressionInterface) {
            $placeholders[] = $this->queryBuilder->buildExpression($item, $params);
            continue;
        }
        $placeholders[] = $this->queryBuilder->bindParam($item, $params);
    }
    return $placeholders;
}

buildSubqueryArray() 保護されたメソッド

サブクエリ SQL から配列式を構築します。

protected string buildSubqueryArray ( $sql, yii\db\ArrayExpression $expression )
$sql	文字列	サブクエリ SQL。
$expression	yii\db\ArrayExpression
戻り値	文字列	サブクエリ配列式。

ソースコード

                protected function buildSubqueryArray($sql, ArrayExpression $expression)
{
    return 'ARRAY(' . $sql . ')' . $this->getTypehint($expression);
}

getTypehint() 保護されたメソッド

protected string getTypehint ( yii\db\ArrayExpression $expression )
$expression	yii\db\ArrayExpression
戻り値	文字列	type に基づいた型キャスト式。

ソースコード

                protected function getTypehint(ArrayExpression $expression)
{
    if ($expression->getType() === null) {
        return '';
    }
    $result = '::' . $expression->getType();
    $result .= str_repeat('[]', $expression->getDimension());
    return $result;
}

typecastValue() protected メソッド

$expression で使用する $value をキャストします

protected yii\db\JsonExpression typecastValue ( yii\db\ArrayExpression $expression, $value )
$expression	yii\db\ArrayExpression
$value	mixed

ソースコード

                protected function typecastValue(ArrayExpression $expression, $value)
{
    if ($value instanceof ExpressionInterface) {
        return $value;
    }
    if (in_array($expression->getType(), [Schema::TYPE_JSON, Schema::TYPE_JSONB], true)) {
        return new JsonExpression($value);
    }
    return $value;
}