Класс TaskCollection
Объект-коллекция для задач. Предоставляет возможности для ленивой загрузки задач и запуска обратных вызовов при загрузке задач.
- ObjectCollection
-
TaskCollection
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Console/TaskCollection.php
Краткое описание свойств
- Оболочка для установки параметров для задач.
$_Shellprotected -
$taskPathPrefixpublicДиректория внутри каждого пути оболочки, содержащая задачи.string
Унаследованные свойства
Краткое описание методов
- __construct() publicКонструктор
- load() publicЗагружает/создаёт задачу. Вернёт экземпляр из реестра, если он уже существует.
Подробное описание методов
__construct()source public
__construct( Shell $Shell )
Конструктор
Параметры
-
Shell$Shell - Оболочка, к которой прикреплена эта коллекция задач.
load()source public
load( string $task , array $settings array() )
Загружает/создаёт задачу. Вернёт экземпляр из реестра, если он уже существует.
Вы можете использовать псевдоним вашей задачи, как существующей, установив ключ 'className', например:
public $tasks = array( 'DbConfig' => array( 'className' => 'Bakeplus.DbConfigure' ); );
Все вызовы к задаче DbConfig будут использовать задачу DbConfigure, которая находится в плагине Bakeplus.
Параметры
- строка
$task - Имя задачи для загрузки
- массив
$settingsнеобязательно array() - Настройки для задачи.
Возвращает
ЗадачаОбъект задачи, либо уже загруженную, либо новую.
Исключения
MissingTaskExceptionесли задача не найдена
Методы, унаследованные от ObjectCollection
__get()source public
__get( string $name )
Предоставляет публичный доступ для чтения к загруженным объектам
Параметры
- строка
$name - Имя свойства для чтения
Возвращает
смешанное__isset()source public
__isset( string $name )
Предоставляет доступ isset к _loaded
Параметры
- строка
$name - Имя проверяемого объекта.
Возвращает
booleanattached()source public
attached( string $name null )
Получает список прикреплённых объектов или состояние заданного объекта
Устарело
3.0.0 Будет удалено в 3.0. Используйте loaded вместо него.Параметры
- строка
$nameнеобязательно null Необязательно. Имя объекта, для которого нужно проверить состояние. Если опущен, возвращает массив текущих прикреплённых объектов
Возвращает
смешанноеЕсли $name указан, возвращает булево значение состояния соответствующего объекта. В противном случае возвращает массив всех прикреплённых объектов.
disable()source public
disable( string|array $name )
Отключает обратные вызовы для объекта или массива объектов. Публичные методы объекта всё ещё вызываемы как обычно.
Параметры
- строка|массив
$name - Имя (в CamelCase) объекта(ов) для отключения (строка или массив)
enable()source public
enable( string|array $name , boolean $prioritize true )
Включает обратные вызовы для объекта или массива объектов
Параметры
- строка|массив
$name - Имя (в CamelCase) объекта(ов) для включения (строка или массив)
- boolean
$prioritizeнеобязательно true - Установить список включённых объектов после включения
enabled()source public
enabled( string $name null )
Получает список текущих включенных объектов или текущее состояние единичного объекта
Параметры
- строка
$nameнеобязательно null Необязательно. Имя объекта, для которого нужно проверить состояние. Если опущен, возвращает массив текущих включённых объектов
Возвращает
смешанноеЕсли $name указан, возвращает булево значение состояния соответствующего объекта. В противном случае возвращает массив всех включённых объектов.
loaded()source public
loaded( string $name null )
Получает список загруженных объектов или состояние заданного объекта
Параметры
- строка
$nameнеобязательно null Необязательно. Имя объекта, для которого нужно проверить состояние. Если опущен, возвращает массив текущих загруженных объектов
Возвращает
смешанноеЕсли $name указан, возвращает булево значение состояния соответствующего объекта. В противном случае возвращает массив всех загруженных объектов.
normalizeObjectArray()source public static
normalizeObjectArray( array $objects )
Нормализует массив объектов, создаёт массив, который облегчает ленивую загрузку
Параметры
- массив
$objects - Массив дочерних объектов для нормализации.
Возвращает
массивМассив нормализованных объектов.
prioritize()source public
prioritize( )
Приоритетизация списка включённых объектов
Возвращает
массивПриоритетизированный список объектов
set()source public
set( string $name null , CakeObject $object null )
Добавляет или перезаписывает экземпляр объекта в коллекцию
Параметры
- строка
$nameнеобязательно null - Имя объекта
-
CakeObject$objectнеобязательно null - Объект для использования
Возвращает
массивЗагруженные объекты
setPriority()source public
setPriority( string|array $name , integer|null $priority null )
Установка приоритета для объекта или массива объектов
Параметры
- строка|массив
$name Имя (в CamelCase) объекта(ов) для включения (строка или массив). Если строка, используется второй параметр $priority. В противном случае это должен быть ассоциативный массив с именами объектов в качестве ключей и значениями как приоритеты для установки.
- целое число|null
$priorityнеобязательно null - Целое значение приоритета или null для значения по умолчанию
trigger()source public
trigger( string|CakeEvent $callback , array $params array() , array $options array() )
Вызвать метод обратного вызова для каждого объекта в коллекции. Используется для вызова методов объектов в коллекции. Методы будут вызваны в порядке их добавления.
Параметры
breakOnУстанавливается в значение или значения, на которых требуется остановить распространение обратного вызова. Может быть скалярным значением или массивом значений для остановки. По умолчаниюfalse.breakУстанавливается в true для включения остановки. Когда обратный вызов прерывается, будет возвращено последнее возвращенное значение. Если используется в сочетании сcollectReturn, будут возвращены собранные результаты. По умолчаниюfalse.collectReturnУстанавливается в true для сбора возвращаемого значения каждого объекта в массив. Этот массив значений возврата будет возвращен из вызова trigger(). По умолчаниюfalse.modParamsПозволяет каждому объекту, на котором вызывается обратный вызов, изменять параметры для последующего объекта. Установка modParams в целое число позволит вам изменить параметр с этим индексом. Любое ненулевое значение будет изменять параметр с указанным индексом. По умолчанию false.
Параметры
- строка|
CakeEvent$callback Метод, который нужно вызвать для всех объектов. Предполагается, что все объекты реализуют вызываемый метод. Если предоставлен экземпляр CakeEvent, имя события будет обработано для получения имени обратного вызова. Это делается путем получения последнего слова после точки в имени события (например,
Model.afterSaveсобытие вызовет обратный вызовafterSave).- массив
$paramsнеобязательно массив() - Массив параметров для вызываемого обратного вызова.
- массив
$optionsнеобязательно массив() - Массив параметров.
Возвращаемое значение
mixedЛибо последнее результат, либо все результаты, если включен collectReturn.
Исключения
CakeExceptionпри использовании modParams с индексом, который не существует.
unload()source public
unload( string $name )
Имя объекта, который необходимо удалить из коллекции
Параметры
- строка
$name - Имя объекта для удаления.
Подробное описание свойств
$taskPathPrefixsource
public строка
Директория внутри пути каждой оболочки, содержащая задачи.
'tasks/'
© 2005–2016 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/2.9/class-TaskCollection.html