Класс TaskCollection
Объект-коллекция для задач. Предоставляет возможности для ленивой загрузки задач и запуска обратных вызовов при загрузке задач.
- ObjectCollection
-
TaskCollection
Авторские права: Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org)
Лицензия: MIT License
Расположение: Cake/Console/TaskCollection.php
Краткое описание свойств
- Shell для использования при установке параметров задач.
$_Shellprotected -
$taskPathPrefixpublicДиректория внутри пути каждого shell, содержащая задачи.string
Унаследованные свойства
Краткое описание методов
- __construct() publicКонструктор
- load() publicЗагружает/создает задачу. Возвращает экземпляр из реестра, если он уже существует.
Подробное описание методов
__construct()source public
__construct( Shell $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() - Настройки для задачи.
Возвращает
AppShellОбъект задачи, либо уже загруженную задачу, либо новую.
Исключения
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 , 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.
Параметры
- string|
CakeEvent$callback Метод, который нужно вызвать для всех объектов. Предполагается, что все объекты реализуют вызываемый метод. Если предоставлен экземпляр CakeEvent, то имя события будет обработано для получения имени обратного вызова. Это делается путем получения последнего слова после точки в имени события (например, событие
Model.afterSaveвызовет обратный вызовafterSave).- array
$paramsнеобязательно array() - Массив параметров для вызываемого обратного вызова.
- array
$optionsнеобязательно array() - Массив параметров.
Возвращаемое значение
mixedЛибо последнее результат, либо все результаты, если включен collectReturn.
Исключения
CakeExceptionпри использовании modParams с индексом, который не существует.
unload()source public
unload( string $name )
Имя объекта, который нужно удалить из коллекции
Параметры
- string
$name - Имя объекта для удаления.
Подробное описание свойств
$taskPathPrefixsource
public string
Директория внутри пути каждой оболочки, содержащая задачи.
'tasks/'
© 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/2.10/class-TaskCollection.html