Интерфейс EntityInterface
Описывает методы, которым должен соответствовать любой класс, представляющий хранилище данных.
В версии 4.x следующие методы будут официально добавлены в интерфейс:
- Cake\Datasource\EntityInterface реализует ArrayAccess, JsonSerializable
Прямые реализаторы
Краткое описание магических свойств
-
$idpublicПсевдоним для часто используемого первичного ключа.mixed
Краткое описание методов
- accessible() public
Хранит информацию о том, можно ли изменить или установить значение свойства в этом объекте. Специальное свойство
*также может быть помечено как доступное или защищенное, что означает, что любое другое свойство, указанное ранее, примет его значение. Например,$entity->accessible('*', true)означает, что любое свойство, которое еще не указано, будет по умолчанию доступно. - clean() public
Помечает весь объект как чистый, что означает, что он будет выглядеть так, будто ни одно свойство не было изменено или добавлено. Это полезно для первоначальной загрузки объекта.
- dirty() public
Устанавливает состояние «измененного» для отдельного свойства. Если вызов осуществляется без второго аргумента, он вернёт, было ли свойство изменено после создания объекта.
При вызове без аргументов возвращается информация о том, есть ли в объекте измененные свойства.
Устарело
3.4.0 Используйте setDirty() и isDirty() вместо этого.
Параметры
- string|null
$propertyнеобязательно null - поле для установки или проверки состояния
- null|boolean
$isDirtyнеобязательно null true означает, что свойство было изменено, false — что оно не было изменено, а null заставит функцию вернуть текущее состояние для данного свойства
Возвращает
boolean
было ли свойство изменено или нет
- string|null
- errors() public
Устанавливает сообщения об ошибках для поля или списка полей. Если вызывается без второго аргумента, возвращает сообщения об ошибках валидации для указанных полей. Если вызывается без аргументов, возвращает все сообщения об ошибках валидации, сохранённые в этом объекте.
При использовании в качестве устанавливающего метода этот метод вернёт экземпляр текущего объекта для цепочки методов.
Устарело
3.4.0 Используйте setErrors() и getErrors() вместо этого.
Параметры
- string|array|null
$fieldнеобязательно null - Поле для получения ошибок.
- string|array|null
$errorsнеобязательно null - Ошибки, которые нужно установить для $field
- boolean
$overwriteнеобязательно false - Перезаписывать ли существующие ошибки для $field
Возвращает
array|Cake\Datasource\EntityInterface
- string|array|null
- extract() public
Возвращает массив с запрошенными свойствами, хранящимися в этом объекте, индексированными по имени свойства
Параметры
- array
$properties - список свойств, которые нужно вернуть
- boolean
$onlyDirtyнеобязательно false - Возвращать запрошенное свойство только если оно изменено
Возвращает
array
- array
- get() public
Возвращает значение свойства по имени
Параметры
- string
$property - имя свойства для извлечения
Возвращает
mixed
- string
- has() public
Возвращает true, если в объекте существует свойство с именем $property, независимо от того, пусто оно или нет.
Параметры
- string
$property - Проверяемое свойство.
Возвращает
boolean
- string
- hiddenProperties() public
Получить/установить скрытые свойства в этом объекте.
Если аргумент properties равен null, возвращаются текущие скрытые свойства. В противном случае, скрытые свойства устанавливаются.
Параметры
- null|array
$propertiesнеобязательно null - Массив свойств для скрытия или null для получения свойств
Возвращает
array|Cake\Datasource\EntityInterface
- null|array
- isNew() public
Возвращает true, если объект ещё не сохранён в базе данных. Данный метод может вернуть null в случае отсутствия информации о статусе объекта.
- set() public
Устанавливает одно или несколько свойств указанному значению
- toArray() public
Возвращает массив со всеми видимыми свойствами, установленных в этом объекте.
- unsetProperty() public
Удаляет свойство или список свойств из этого объекта
- virtualProperties() public
Получить/установить виртуальные свойства в этом объекте.
- visibleProperties() public
Получить список видимых свойств.
Подробное описание методов
accessible()source public
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
dirty( string|null $property null , null|boolean $isDirty null )
errors()source public
errors( string|array|null $field null , string|array|null $errors null , boolean $overwrite false )
extract()source public
extract( array $properties , boolean $onlyDirty false )
get()source public
get( string $property )
has()source public
has( string $property )
hiddenProperties()source public
hiddenProperties( null|array $properties null )
isNew()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–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/3.4/class-Cake.Datasource.EntityInterface.html