Класс AssociationCollection

__construct()source public

__construct( Cake\ORM\Locator\LocatorInterface $tableLocator = null )

Конструктор.

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

Параметры

Cake\ORM\Locator\LocatorInterface $tableLocator optional null

Экземпляр локатора таблиц.

_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.

getByType()source public

getByType( string|array $class )

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

Параметры

string|array $class

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

Возвращает

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

С тех пор как

3.5.3

getIterator()source public

getIterator( )

Разрешить итерацию по ассоциациям

Возвращает

ArrayIterator

Реализация

IteratorAggregate::getIterator()

has()source public

has( string $alias )

Проверка наличия прикрепленной ассоциации по имени.

Параметры

string $alias

Псевдоним ассоциации для получения.

Возвращает

boolean
Существует ли ассоциация.

keys()source public

keys( )

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

Возвращает

string[]

load()source public

load( string $className , string $associated , array $options = [] )

Создает и добавляет объект Association в эту коллекцию.

Параметры

string $className

Имя класса ассоциации.

string $associated

Псевдоним целевой таблицы.

array $options необязательно []

Список опций для настройки определения ассоциации.

Возвращает

Cake\ORM\Association

Вызывает исключение

InvalidArgumentException

normalizeKeys()source public

normalizeKeys( boolean|array $keys )

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

Параметры

boolean|array $keys

список имен ассоциаций для нормализации

Возвращает

array

remove()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

Сущность для сохранения связанных данных.

array $associations

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

array $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

Сущность для сохранения связанных данных.

array $associations

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

array $options необязательно []

Параметры для операции сохранения.

Возвращает

boolean
Успешно

type()source public устарело

type( string|array $class )

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

Устарело

3.5.3 Используйте getByType() вместо этого.

Параметры

string|array $class

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

Возвращает

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

_normalizeAssociations()source protected

_normalizeAssociations( array $associations )

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

Параметры

array $associations

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

Возвращает

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

getTableLocator()source public

getTableLocator( )

Получение локатора таблицы.

Возвращает

Cake\ORM\Locator\LocatorInterface

setTableLocator()source public

setTableLocator( Cake\ORM\Locator\LocatorInterface $tableLocator )

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

Параметры

Cake\ORM\Locator\LocatorInterface $tableLocator

Экземпляр LocatorInterface.

Возвращает

$this

tableLocator()source public устарело

tableLocator( Cake\ORM\Locator\LocatorInterface $tableLocator = null )

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

Устарело

3.5.0 Используйте getTableLocator()/setTableLocator() вместо этого.

Параметры

Cake\ORM\Locator\LocatorInterface $tableLocator необязательно null

Экземпляр LocatorInterface.

Возвращает

Cake\ORM\Locator\LocatorInterface

[]