Интерфейс EntityInterface
Описывает методы, которым должен соответствовать любой класс, представляющий хранилище данных.
В версии 4.x следующие методы будут официально добавлены в интерфейс:
- Cake\Datasource\EntityInterface implements ArrayAccess, JsonSerializable
Непосредственные реализаторы
Краткое описание магических свойств
-
$idpublicПсевдоним для часто используемого первичного ключа.mixed
Краткое описание методов
-
Хранит информацию о том, можно ли изменить или установить значение свойства в этом объекте. Специальное свойство
*также может быть помечено как доступное или защищённое, что означает, что любое другое указанное ранее свойство примет его значение. Например,$entity->accessible('*', true)означает, что любое не указанное ранее свойство будет по умолчанию доступно. - clean() public
Устанавливает весь объект как чистый, что означает, что все свойства будут выглядеть как не изменённые и не добавленные. Это полезный вызов для первоначальной загрузки объекта.
-
Устанавливает состояние грязности отдельного свойства. Если вызов осуществляется без второго аргумента, он вернёт, было ли свойство изменено после создания объекта.
-
Устанавливает сообщения об ошибках для поля или списка полей. Если вызов осуществляется без второго аргумента, он возвращает ошибки валидации для указанных полей. Если вызов осуществляется без аргументов, он возвращает все сообщения об ошибках валидации, хранящиеся в этом объекте.
- extract() public
Возвращает массив с запрошенными свойствами, хранящимися в этом объекте, индексированными по имени свойства
- get() publicВозвращает значение свойства по имени
- has() public
Возвращает, содержит ли этот объект свойство с именем $property, независимо от того, пустое оно или нет.
- hiddenProperties() publicПолучение/установка скрытых свойств в этом объекте.
- isNew() public
Возвращает, был ли этот объект уже сохранён. Этот метод может вернуть null в случае отсутствия предыдущей информации о состоянии этого объекта.
- set() publicУстанавливает одно или несколько свойств заданному значению
- toArray() publicВозвращает массив со всеми видимыми свойствами, заданными в этом объекте.
- unsetProperty() publicУдаляет свойство или список свойств из этого объекта
- virtualProperties() publicПолучение/установка виртуальных свойств в этом объекте.
- visibleProperties() publicПолучить список видимых свойств.
Подробное описание методов
accessible()source public deprecated
accessible( string|array $property , boolean|null $set = null )
Хранит информацию о том, можно ли изменить или установить значение свойства в этом объекте. Специальное свойство * также может быть помечено как доступное или защищённое, что означает, что любое другое указанное ранее свойство примет его значение. Например, $entity->accessible('*', true) означает, что любое не указанное ранее свойство будет по умолчанию доступно.
Устарело
3.4.0 Используйте setAccess() и isAccessible() вместо этого.Параметры
- string|array
$property - Либо одно, либо список свойств для изменения их доступности.
- boolean|null
$setнеобязательно null true помечает свойство как доступное, false помечает его как защищённое.
Возвращает
Cake\Datasource\EntityInterface|booleanclean()source public
clean( )
Устанавливает весь объект как чистый, что означает, что все свойства будут выглядеть как не изменённые и не добавленные. Это полезный вызов для первоначальной загрузки объекта.
dirty()source public deprecated
dirty( string|null $property = null , null|boolean $isDirty = null )
Устанавливает состояние грязности отдельного свойства. Если вызов осуществляется без второго аргумента, он вернёт, было ли свойство изменено после создания объекта.
Если вызов осуществляется без аргументов, он вернёт, есть ли в объекте свойства, которые были изменены.
Устарело
3.4.0 Используйте setDirty() и isDirty() вместо этого.Параметры
- string|null
$propertyнеобязательно null - поле, для которого нужно установить или проверить состояние
- null|boolean
$isDirtyнеобязательно null true означает, что свойство было изменено, false означает, что оно не было изменено, а null заставит функцию вернуть текущее состояние для этого свойства
Возвращает
booleanбыло ли свойство изменено или нет
errors()source public deprecated
errors( string|array|null $field = null , string|array|null $errors = null , boolean $overwrite = false )
Устанавливает сообщения об ошибках для поля или списка полей. Если вызов осуществляется без второго аргумента, он возвращает ошибки валидации для указанных полей. Если вызов осуществляется без аргументов, он возвращает все сообщения об ошибках валидации, хранящиеся в этом объекте.
При использовании в качестве установщика этот метод вернёт экземпляр этого объекта для цепочки вызовов.
Устарело
3.4.0 Используйте setErrors() и getErrors() вместо этого.Параметры
- string|array|null
$fieldнеобязательно null - Поле, для которого нужно получить ошибки.
- string|array|null
$errorsнеобязательно null - Ошибки, которые нужно установить для $field
- boolean
$overwriteнеобязательно false - Заменить ли существующие ошибки для $field
Возвращает
array|Cake\Datasource\EntityInterfaceextract()source public
extract( array $properties , boolean $onlyDirty = false )
Возвращает массив с запрошенными свойствами, хранящимися в этом объекте, индексированными по имени свойства
Параметры
- array
$properties - список свойств, которые должны быть возвращены
- boolean
$onlyDirtyнеобязательно false - Возвратить запрошенное свойство только если оно изменённое
Возвращает
arrayget()source public
get( string $property )
Возвращает значение свойства по имени
Параметры
- string
$property - имя свойства, которое нужно получить
Возвращает
mixedhas()source public
has( string|array $property )
Возвращает, содержит ли этот объект свойство с именем $property, независимо от того, пустое оно или нет.
Параметры
- string|array
$property - Свойство для проверки.
Возвращает
booleanhiddenProperties()source public
hiddenProperties( null|array $properties = null )
Получение/установка скрытых свойств в этом объекте.
Если аргумент properties равен null, будут возвращены текущие скрытые свойства. В противном случае скрытые свойства будут установлены.
Параметры
- null|array
$propertiesнеобязательно null - Либо массив свойств для скрытия, либо null для получения свойств
Возвращает
array|Cake\Datasource\EntityInterfaceisNew()source public
isNew( boolean|null $new = null )
Возвращает, был ли этот объект уже сохранен в базе данных. Этот метод может возвращать null, если нет информации о состоянии объекта.
Если вызван с булевым значением, этот метод установит состояние данного экземпляра. Использование true означает, что экземпляр не был сохранен в базе данных, false что он уже сохранен.
Параметры
- boolean|null
$newнеобязательно null - Указывает, был ли этот экземпляр сохранен.
Возвращает
booleanЕсли известно, был ли сущность уже сохранён, в противном случае null
set()source public
set( string|array $property , mixed $value = null , array $options = [] )
Устанавливает одно или несколько свойств в указанное значение.
Параметры
- string|array
$property имя свойства для установки или список свойств с соответствующими значениями
- mixed
$valueнеобязательно null Значение для установки свойства или массив, если первый аргумент также является массивом, в этом случае будет обработан как $options
- array
$optionsнеобязательно [] опции для использования при установке свойства. Разрешенные ключи опций -
setterиguard
Возвращает
Cake\Datasource\EntityInterfacetoArray()source public
toArray( )
Возвращает массив со всеми видимыми свойствами, установленными в этом объекте.
Примечание скрытые свойства не видны и не будут выведены методом toArray().
Возвращает
arrayunsetProperty()source public
unsetProperty( string|array $property )
Удаляет свойство или список свойств из этого объекта
Параметры
- string|array
$property - Свойство для удаления.
Возвращает
Cake\Datasource\EntityInterfacevirtualProperties()source public
virtualProperties( null|array $properties = null )
Получение/Установка виртуальных свойств этого объекта.
Если аргумент properties равен null, будут возвращены текущие виртуальные свойства. В противном случае виртуальные свойства будут установлены.
Параметры
- null|array
$propertiesнеобязательно null - Массив свойств, которые следует рассматривать как виртуальные, или null для получения свойств
Возвращает
array|Cake\Datasource\EntityInterfacevisibleProperties()source public
visibleProperties( )
Получение списка видимых свойств.
Возвращает
arrayСписок свойств, которые «видимы» во всех представлениях.
Краткое описание магических методов
Подробное описание магических свойств
$idsource
public mixed
© 2005–present 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.8/class-Cake.Datasource.EntityInterface.html