Класс TaskCollection
Объект-коллекция для задач. Предоставляет возможности для ленивой загрузки задач и вызова обратных вызовов при загрузке задач.
- ObjectCollection
-
TaskCollection
Авторские права: Copyright (c) Cake Software Foundation, Inc. (http://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Console/TaskCollection.php
Краткое описание свойств
- Shell для использования для установки параметров задач.
$_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 - Имя проверяемого объекта.
Возвращаемое значение
булевоattached()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 (строка или массив)
- булево
$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 , Object $object null )
Добавляет или перезаписывает экземпляр объекта в коллекции
Параметры
- строка
$nameнеобязательно null - Имя объекта
-
Object$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.
Параметры
- string|
CakeEvent$callback Метод, который нужно вызвать для всех объектов. Предполагается, что все объекты реализуют вызываемый метод. Если передан экземпляр CakeEvent, то имя события будет обработано для получения имени обратного вызова. Это делается путем извлечения последнего слова после точки в имени события (например, событие
Model.afterSaveвызовет обратный вызовafterSave).- массив
$paramsнеобязательно array() - Массив параметров для вызываемого обратного вызова.
- массив
$optionsнеобязательно array() - Массив опций.
Возвращаемое значение
смешанноеЛибо последнее значение, либо все значения, если включен collectReturn.
Исключения
CakeExceptionпри использовании modParams с индексом, который не существует.
unload()source public
unload( string $name )
Имя объекта, который нужно удалить из коллекции
Параметры
- строка
$name - Имя объекта для удаления.
Подробности свойств
$taskPathPrefixsource
public string
Директория внутри пути каждой оболочки, содержащая задачи.
'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.
http://api.cakephp.org/2.8/class-TaskCollection.html