Spec-Zone.ru › CakePHP 3.4

Класс ValuesExpression

Объект выражения для хранения вставляемых значений.

Помогает генерировать SQL с правильным количеством заготовок и корректно связывать значения в оператор.

Cake\Database\Expression\ValuesExpression реализует Cake\Database\ExpressionInterface использует Cake\Database\Type\ExpressionTypeCasterTrait , Cake\Database\TypeMapTrait
Пространство имён: Cake\Database\Expression
Расположение: Database/Expression/ValuesExpression.php

Краткое описание свойств

  • $_castedExpressions protected
    boolean

    Указывается, были ли значения уже преобразованы в выражения.

  • $_columns protected
    array
    Список столбцов, которые обязательно должны быть частью вставки.
  • $_query protected
    Cake\Database\Query|null
    Объект запроса, используемый в качестве выражения значений
  • $_values protected
    array
    Массив значений для вставки.

Унаследованные свойства

  • _typeMap

Краткое описание методов

  • __construct() public
    Конструктор
  • _columnNames() protected
    Получение исходных имён столбцов.
  • _processExpressions() protected
    Преобразование значений, требующих преобразования в выражения
  • add() public
    Добавление строки данных для вставки.
  • columns() public

    Устанавливает столбцы для вставки. Если параметры не указаны, возвращает текущие сохранённые столбцы.

  • getColumns() public
    Получение столбцов для вставки.
  • getQuery() public

    Получение объекта запроса, используемого в качестве выражения значений для оценки вставки записей в таблицу.

  • getValues() public
    Получение значений для вставки.
  • query() public

    Устанавливает объект запроса, используемый в качестве выражения значений для оценки вставки записей в таблицу. Если параметры не указаны, возвращает текущий сохранённый запрос.

  • setColumns() public
    Устанавливает столбцы для вставки.
  • setQuery() public

    Устанавливает объект запроса, используемый в качестве выражения значений для оценки вставки записей в таблицу.

  • setValues() public
    Устанавливает значения для вставки.
  • sql() public
    Преобразование значений в строку SQL с заготовками.
  • traverse() public
    Обход выражения значений.
  • values() public

    Устанавливает значения для вставки. Если параметры не указаны, возвращает текущие сохранённые значения.

Подробное описание методов

__construct()source public

__construct( array $columns , Cake\Database\TypeMap $typeMap )

Конструктор

Параметры

массив $columns
Список столбцов, которые будут частью значений.
Cake\Database\TypeMap $typeMap
Словарь столбец -> имена типов

_columnNames()source protected

_columnNames( )

Получение исходных имён столбцов.

Так как имена столбцов могут быть идентификаторами, нам нужно удалить идентификаторы из столбцов.

Возвращает

массив

_processExpressions()source protected

_processExpressions( )

Преобразование значений, требующих преобразования в выражения

add()source public

add( array|Cake\Database\Query $data )

Добавление строки данных для вставки.

Параметры

массив|Cake\Database\Query $data

Массив данных для добавления в вставку или запрос для выполнения команд типа INSERT INTO .. SELECT

Исключения

Cake\Database\Exception
При смешивании типов данных массив + Запрос.

columns()source public

columns( array|null $cols null )

Устанавливает столбцы для вставки. Если параметры не указаны, возвращает текущие сохранённые столбцы.

Устарело

3.4.0 Используйте setColumns()/getColumns() вместо этого.

Параметры

массив|null $cols необязательно null
Массив со столбцами для вставки.

Возвращает

массив|Cake\Database\Expression\ValuesExpression
$this

getColumns()source public

getColumns( )

Получение столбцов для вставки.

Возвращает

массив

getQuery()source public

getQuery( )

Получение объекта запроса, используемого в качестве выражения значений для оценки вставки записей в таблицу.

Возвращает

Cake\Database\Query

getValues()source public

getValues( )

Получение значений для вставки.

Возвращает

массив

query()source public

query( Cake\Database\Query $query null )

Устанавливает объект запроса, используемый в качестве выражения значений для оценки вставки записей в таблицу. Если параметры не указаны, возвращает текущий сохранённый запрос

Устарело

3.4.0 Используйте setQuery()/getQuery() вместо этого.

Параметры

Cake\Database\Query $query необязательно null
Запрос для установки

Возвращает

Cake\Database\Query|null|Cake\Database\Expression\ValuesExpression
$this

setColumns()source public

setColumns( array $cols )

Устанавливает столбцы для вставки.

Параметры

массив $cols
Массив со столбцами для вставки.

Возвращает


$this

setQuery()source public

setQuery( Cake\Database\Query $query )

Устанавливает объект запроса, используемый в качестве выражения значений для оценки вставки записей в таблицу.

Параметры

Cake\Database\Query $query
Запрос для установки

Возвращает


$this
END_OF_DOCUMENT_MARKER

setValues()source public

setValues( array $values )

Устанавливает значения для вставки.

Параметры

массив $values
Массив со значениями для вставки.

Возвращает


$this

sql()source public

sql( Cake\Database\ValueBinder $generator )

Преобразует значения в строку SQL с заполнительми.

Параметры

Cake\Database\ValueBinder $generator
Объект генератора заполнителей

Возвращает

строка

Реализация

Cake\Database\ExpressionInterface::sql()

traverse()source public

traverse( callable $visitor )

Обход выражения значений.

Этот метод также обходит любые запросы, которые должны быть использованы в значениях INSERT.

Параметры

лямбда-функция $visitor
Визитор для обхода выражения.

Реализация

Cake\Database\ExpressionInterface::traverse()

values()source public

values( array|null $values null )

Устанавливает значения для вставки. Если параметры не переданы, возвращает текущие сохраненные значения.

Устарело

3.4.0 Используйте setValues()/getValues() вместо этого.

Параметры

массив|null $values необязательно null
Массив со значениями для вставки.

Возвращает

массив|Cake\Database\Expression\ValuesExpression
$this

Методы, используемые из Cake\Database\Type\ExpressionTypeCasterTrait

_castToExpression()source protected

_castToExpression( mixed $value , string $type )

Условно преобразует переданное значение в объект ExpressionInterface, если класс типа реализует ExpressionTypeInterface. В противном случае возвращает значение без изменений.

Параметры

смешанный $value
Значение для преобразования в ExpressionInterface
строка $type
Имя типа

Возвращает

смешанный

_requiresToExpressionCasting()source protected

_requiresToExpressionCasting( array $types )

Возвращает массив с типами, для которых значения должны быть преобразованы в выражения, из списка имен типов, переданных в качестве параметра.

Параметры

массив $types
Список имен типов

Возвращает

массив

Методы, используемые из Cake\Database\TypeMapTrait

defaultTypes()source public

defaultTypes( array $types null )

Позволяет задавать типы по умолчанию при цепочечном запросе

Устарело

3.4.0 Используйте setDefaultTypes()/getDefaultTypes() вместо этого.

Параметры

массив $types необязательно null
Массив типов для установки.

Возвращает


$this|массив

getDefaultTypes()source public

getDefaultTypes( )

Получает типы по умолчанию текущей карты типов.

Возвращает

массив

getTypeMap()source public

getTypeMap( )

Возвращает существующую карту типов.

Возвращает

Cake\Database\TypeMap

setDefaultTypes()source public

setDefaultTypes( array $types )

Позволяет задавать типы по умолчанию при цепочечном запросе.

Параметры

массив $types
Массив типов для установки.

Возвращает


$this

setTypeMap()source public

setTypeMap( array|Cake\Database\TypeMap $typeMap )

Создает новую карту типов, если $typeMap является массивом, в противном случае меняет её на указанную.

Параметры

массив|Cake\Database\TypeMap $typeMap
Создает карту типов, если это массив, в противном случае устанавливает указанную карту типов

Возвращает


$this

typeMap()source public

typeMap( array|Cake\Database\TypeMap|null $typeMap null )

Создает новую карту типов, если $typeMap является массивом, в противном случае возвращает существующую карту типов или меняет её на указанную.

Устарело

3.4.0 Используйте setTypeMap()/getTypeMap() вместо этого.

Параметры

массив|Cake\Database\TypeMap|null $typeMap необязательно null
Создает карту типов, если это массив, в противном случае устанавливает указанную карту типов

Возвращает


$this|\Cake\Database\TypeMap

Подробности свойств

$_castedExpressionssource

protected boolean

Указывает, были ли значения уже преобразованы в выражения.

false

$_columnssource

protected массив

Список столбцов, которые должны быть частью вставки.

[]

$_querysource

protected Cake\Database\Query|null

Объект запроса, используемый в качестве выражения значений

$_valuessource

protected массив

Массив значений для вставки.

[]

© 2005–2017 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.4/class-Cake.Database.Expression.ValuesExpression.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API