Класс AssociationCollection
Контейнер/коллекция для ассоциативных классов.
Содержит методы для управления ассоциациями и упорядочения операций сохранения и удаления.
- Cake\ORM\AssociationCollection реализует IteratorAggregate использует Cake\ORM\AssociationsNormalizerTrait
Краткое описание свойств
- Сохраненные ассоциации
$_itemsprotected
Краткое описание методов
- _getNoCascadeItems() protectedВозвращает элементы без обратного вызова каскадного удаления.
- _save() protectedВспомогательный метод для сохранения данных ассоциации.
- _saveAssociations() protectedВспомогательный метод для сохранения данных ассоциации.
- add() publicДобавить ассоциацию в коллекцию
- cascadeDelete() public
Каскадное удаление по различным ассоциациям. Сначала каскадное удаление по ассоциациям, для которых cascadeCallbacks равно true.
- get() publicПолучить присоединённую ассоциацию по имени.
- getByProperty() publicПолучить ассоциацию по имени свойства.
- getIterator() publicРазрешить итерацию по ассоциациям
- has() publicПроверить наличие присоединённой ассоциации по имени.
- keys() publicПолучить имена всех ассоциаций в коллекции.
- normalizeKeys() public
Возвращает ассоциативный массив имён ассоциаций из смешанного массива. Если передано значение true, возвращает все имена ассоциаций в этой коллекции.
- remove() publicУдалить ассоциацию.
- removeAll() publicУдалить все зарегистрированные ассоциации.
- saveChildren() publicСохранить все ассоциации, являющиеся дочерними для данного сущности.
- saveParents() publicСохранить все ассоциации, являющиеся родительскими для данной сущности.
- type() publicПолучить массив ассоциаций, соответствующих определённому типу.
Подробное описание методов
_getNoCascadeItems()source protected
_getNoCascadeItems( Cake\Datasource\EntityInterface $entity , array $options )
Возвращает элементы без обратного вызова каскадного удаления.
Параметры
-
Cake\Datasource\EntityInterface$entity - Сущность, для которой нужно удалить ассоциации.
- array
$options - Опции, используемые в операции удаления.
Возвращает
Cake\ORM\Association[]_save()source protected
_save( Cake\ORM\Association $association , Cake\Datasource\EntityInterface $entity , array $nested , array $options )
Вспомогательный метод для сохранения данных ассоциации.
Параметры
-
Cake\ORM\Association$association - Объект ассоциации для сохранения.
-
Cake\Datasource\EntityInterface$entity - Сущность для сохранения
- array
$nested - Опции для вложенных ассоциаций
- array
$options - Оригинальные опции
Возвращает
booleanУспех
_saveAssociations()source protected
_saveAssociations( Cake\ORM\Table $table , Cake\Datasource\EntityInterface $entity , array $associations , array $options , boolean $owningSide )
Вспомогательный метод для сохранения данных ассоциации.
Параметры
-
Cake\ORM\Table$table - Таблица, на которой сейчас выполняется сохранение
-
Cake\Datasource\EntityInterface$entity - Сущность для сохранения
- array
$associations - Массив ассоциаций для сохранения.
- array
$options - Оригинальные опции
- boolean
$owningSide Сравнение с методом isOwningSide ассоциативных классов.
Возвращает
booleanУспех
Выбрасывает
InvalidArgumentExceptionПри использовании неизвестного псевдонима.
add()source public
add( string $alias , Cake\ORM\Association $association )
Добавить ассоциацию в коллекцию
Если добавленный псевдоним содержит . , часть перед . будет отброшена. Это упрощает использование плагинов, поскольку часто используется синтаксис Plugin.Class.
Параметры
- string
$alias - Псевдоним ассоциации
-
Cake\ORM\Association$association - Добавляемая ассоциация.
Возвращает
Cake\ORM\AssociationОбъект добавляемой ассоциации.
cascadeDelete()source public
cascadeDelete( Cake\Datasource\EntityInterface $entity , array $options )
Каскадное удаление по различным ассоциациям. Сначала каскадное удаление по ассоциациям, для которых cascadeCallbacks равно true.
Параметры
-
Cake\Datasource\EntityInterface$entity - Сущность, для которой нужно удалить ассоциации.
- array
$options - Опции, используемые в операции удаления.
get()source public
get( string $alias )
Получить присоединённую ассоциацию по имени.
Параметры
- string
$alias - Псевдоним ассоциации для получения.
Возвращает
Cake\ORM\Association|nullАссоциацию или null.
getByProperty()source public
getByProperty( string $prop )
Получить ассоциацию по имени свойства.
Параметры
- string
$prop - Свойство для поиска ассоциации.
Возвращает
Cake\ORM\Association|nullАссоциацию или null.
getIterator()source public
getIterator( )
Разрешить итерацию по ассоциациям
Возвращает
ArrayIteratorРеализация
IteratorAggregate::getIterator() has()source public
has( string $alias )
Проверить наличие присоединённой ассоциации по имени.
Параметры
- string
$alias - Псевдоним ассоциации для получения.
Возвращает
booleanСуществует ли ассоциация.
normalizeKeys()source public
normalizeKeys( boolean|array $keys )
Возвращает ассоциативный массив имён ассоциаций из смешанного массива. Если передано значение true, возвращает все имена ассоциаций в этой коллекции.
Параметры
- boolean|array
$keys - список имён ассоциаций для нормализации
Возвращает
arrayremove()source public
remove( string $alias )
Удалить ассоциацию.
После удаления ассоциация больше не будет доступна.
Параметры
- string
$alias - Имя псевдонима.
removeAll()source public
removeAll( )
Удалить все зарегистрированные ассоциации.
После удаления ассоциации больше недоступны.
saveChildren()source public
saveChildren( Cake\ORM\Table $table , Cake\Datasource\EntityInterface $entity , array $associations , array $options )
Сохранить все ассоциации, которые являются дочерними для данного сущности.
Дочерние ассоциации включают любые ассоциации, где заданная таблица не является стороной владения.
Параметры
-
Cake\ORM\Table$table - Сущность для таблицы.
-
Cake\Datasource\EntityInterface$entity - Сущность для сохранения связанных данных.
- массив
$associations Список ассоциаций, из которых необходимо сохранить дочерние элементы. Ассоциации, которые не указаны в этом списке, не будут сохранены.
- массив
$options - Параметры операции сохранения.
Возвращает
booleanУспех
saveParents()source public
saveParents( Cake\ORM\Table $table , Cake\Datasource\EntityInterface $entity , array $associations , array $options [] )
Сохранить все ассоциации, которые являются родительскими для данной сущности.
Родительские ассоциации включают любые ассоциации, где заданная таблица является стороной владения.
Параметры
-
Cake\ORM\Table$table - Сущность для таблицы.
-
Cake\Datasource\EntityInterface$entity - Сущность для сохранения связанных данных.
- массив
$associations Список ассоциаций, из которых необходимо сохранить родительские элементы. Ассоциации, которые не указаны в этом списке, не будут сохранены.
- массив
$optionsoptional [] - Параметры операции сохранения.
Возвращает
booleanУспех
type()source public
type( string|array $class )
Получить массив ассоциаций, соответствующих определенному типу.
Параметры
- строка|массив
$class Тип ассоциаций, который вы хотите. Например, 'BelongsTo' или массив типа ['BelongsTo', 'HasOne']
Возвращает
массивМассив объектов Association.
Методы, используемые из Cake\ORM\AssociationsNormalizerTrait
_normalizeAssociations()source protected
_normalizeAssociations( array $associations )
Возвращает массив из исходного переданного списка ассоциаций, где обозначение точек преобразуется в вложенные массивы, чтобы их можно было обработать другими процедурами.
Параметры
- массив
$associations - Массив включенных ассоциаций.
Возвращает
массивМассив, в котором обозначение точек преобразуется в вложенные массивы
Подробности свойств
© 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.3/class-Cake.ORM.AssociationCollection.html