Класс ValuesExpression
Объект выражения для хранения вставляемых значений.
Помогает генерировать SQL с правильным количеством заготовок и корректно связывать значения в операторе.
- Cake\Database\Expression\ValuesExpression реализует Cake\Database\ExpressionInterface использует Cake\Database\Type\ExpressionTypeCasterTrait , Cake\Database\TypeMapTrait
Краткое описание свойств
-
$_castedExpressionsprotectedbooleanУказывается, были ли значения уже преобразованы в выражения.
-
$_columnsprotectedСписок столбцов, которые должны быть частью вставки.array -
$_queryprotectedОбъект запроса для использования в качестве выражения значенийCake\Database\Query|null -
$_valuesprotectedМассив значений для вставки.array
Унаследованные свойства
Краткое описание методов
- __construct() publicКонструктор
- _columnNames() protectedПолучить имена столбцов.
- _processExpressions() protectedПреобразует значения, которые необходимо преобразовать в выражения
- add() publicДобавить строку данных для вставки.
-
Устанавливает столбцы для вставки. Если параметры не переданы, возвращает текущие сохраненные столбцы.
- getColumns() publicПолучить столбцы для вставки.
- getQuery() public
Получить объект запроса, используемый в качестве выражения значений для оценки вставки записей в таблицу.
- getValues() publicПолучить значения для вставки.
-
Устанавливает объект запроса, используемый в качестве выражения значений для оценки вставки записей в таблицу. Если параметры не переданы, возвращает текущий сохраненный запрос
- setColumns() publicУстанавливает столбцы для вставки.
- setQuery() public
Устанавливает объект запроса, используемый в качестве выражения значений для оценки вставки записей в таблицу.
- setValues() publicУстанавливает значения для вставки.
- sql() publicПреобразовать значения в строку SQL с заготовками.
- traverse() 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 deprecated
columns( array|null $cols = null )
Устанавливает столбцы для вставки. Если параметры не переданы, возвращает текущие сохраненные столбцы.
Устарело
3.4.0 Используйте setColumns()/getColumns() вместо этого.Параметры
- массив|null
$colsoptional null - Массив с столбцами для вставки.
Возвращает
массив|Cake\Database\Expression\ValuesExpression$this
getQuery()source public
getQuery( )
Получение объекта запроса, используемого как выражение значений для оценки вставки записей в таблицу.
Возвращает
Cake\Database\Query|nullquery()source public deprecated
query( Cake\Database\Query $query = null )
Устанавливает объект запроса, используемый как выражение значений для оценки вставки записей в таблицу. Если параметры не переданы, возвращает текущий сохраненный запрос.
Устарело
3.4.0 Используйте setQuery()/getQuery() вместо этого.Параметры
-
Cake\Database\Query$queryoptional 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
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 deprecated
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 deprecated
defaultTypes( array $types = null )
Позволяет установить значения по умолчанию для типов при цепочечном запросе
Устарело
3.4.0 Используйте setDefaultTypes()/getDefaultTypes() вместо этого.Параметры
- массив
$typesнеобязательно null - Массив типов для установки.
Возвращает
$this|массив
getDefaultTypes()source public
getDefaultTypes( )
Получает значения типов по умолчанию текущей схемы типов.
Возвращает
массивgetTypeMap()source public
getTypeMap( )
Возвращает существующую схему типов.
Возвращает
Cake\Database\TypeMapsetDefaultTypes()source public
setDefaultTypes( array $types )
Переопределяет значения типов по умолчанию для полей в реализующем объекте.
Этот метод полезен, если вам нужно установить схемы типов, которые совместно используются несколькими функциями/выражениями в запросе.
Чтобы добавить значение по умолчанию без перезаписи существующих, используйте getTypeMap()->addDefaults()
Параметры
- массив
$types - Массив типов для установки.
Возвращает
$this
См. также
\Cake\Database\TypeMap::setDefaults()setTypeMap()source public
setTypeMap( array|Cake\Database\TypeMap $typeMap )
Создаёт новую схему типов, если $typeMap является массивом, в противном случае меняет её на переданную.
Параметры
- массив|
Cake\Database\TypeMap$typeMap - Создаёт схему типов, если массив, в противном случае устанавливает переданную схему типов
Возвращает
$this
typeMap()source public deprecated
typeMap( array|Cake\Database\TypeMap|null $typeMap = null )
Создаёт новую схему типов, если $typeMap является массивом, в противном случае возвращает существующую схему типов или меняет её на переданную.
Устарело
3.4.0 Используйте setTypeMap()/getTypeMap() вместо этого.Параметры
- массив|
Cake\Database\TypeMap|null$typeMapнеобязательно null - Создаёт схему типов, если массив, в противном случае устанавливает переданную схему типов
Возвращает
$this|\Cake\Database\TypeMap
Подробное описание свойств
$_querysource
protected Cake\Database\Query|null
Объект запроса, используемый в качестве выражения значений
© 2005–present 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.7/class-Cake.Database.Expression.ValuesExpression.html