Spec-Zone.ru › CakePHP 3.3

Класс AssociationCollection

Контейнер/коллекция для ассоциативных классов.

Содержит методы для управления ассоциациями и упорядочения операций сохранения и удаления.

Cake\ORM\AssociationCollection реализует IteratorAggregate использует Cake\ORM\AssociationsNormalizerTrait
Пространство имен: Cake\ORM
Расположение: ORM/AssociationCollection.php

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

  • $_items protected
    Cake\ORM\Association[]
    Сохраненные ассоциации

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

  • _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
Существует ли ассоциация.

keys()source public

keys( )

Получить имена всех ассоциаций в коллекции.

Возвращает

array

normalizeKeys()source public

normalizeKeys( boolean|array $keys )

Возвращает ассоциативный массив имён ассоциаций из смешанного массива. Если передано значение true, возвращает все имена ассоциаций в этой коллекции.

Параметры

boolean|array $keys
список имён ассоциаций для нормализации

Возвращает

array

remove()source public

remove( string $alias )

Удалить ассоциацию.

После удаления ассоциация больше не будет доступна.

Параметры

string $alias
Имя псевдонима.
END_OF_DOCUMENT_MARKER

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

Список ассоциаций, из которых необходимо сохранить родительские элементы. Ассоциации, которые не указаны в этом списке, не будут сохранены.

массив $options optional []
Параметры операции сохранения.

Возвращает

boolean
Успех

type()source public

type( string|array $class )

Получить массив ассоциаций, соответствующих определенному типу.

Параметры

строка|массив $class

Тип ассоциаций, который вы хотите. Например, 'BelongsTo' или массив типа ['BelongsTo', 'HasOne']

Возвращает

массив
Массив объектов Association.

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

_normalizeAssociations()source protected

_normalizeAssociations( array $associations )

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

Параметры

массив $associations
Массив включенных ассоциаций.

Возвращает

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

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

$_itemssource

protected Cake\ORM\Association[]

Сохраненные ассоциации

[]

© 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

Spec-Zone.ru

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