53 lines
1.7 KiB
Markdown
53 lines
1.7 KiB
Markdown
|
# Сущность
|
|||
|
|
|
|||
|
|
[Вернуться к содержанию](readme.md#toc)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
Сущностями являются все классы, которые необходимы для взаимодействия с API. Они находятся в директори `src/Entities` и
|
|||
|
|
расширяют абстрактный класс `AtolOnline\Entities\Entity`.
|
|||
|
|
|
|||
|
|
Каждая сущность содержит в себе только те данные, которые необходимы согласно схемы АТОЛ Онлайн API.
|
|||
|
|
|
|||
|
|
Ниже перечислены возможности сущностей.
|
|||
|
|
|
|||
|
|
## Приведение к строке JSON
|
|||
|
|
|
|||
|
|
```php
|
|||
|
|
echo $entity;
|
|||
|
|
$json_string = (string)$entity;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Приведение к массиву
|
|||
|
|
|
|||
|
|
```php
|
|||
|
|
// результат идентичен
|
|||
|
|
$json_array1 = $entity->jsonSerialize();
|
|||
|
|
$json_array2 = $entity->toArray();
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Чтение из массива
|
|||
|
|
|
|||
|
|
```php
|
|||
|
|
$var = new \AtolOnline\Entities\Client('Иванов Иван');
|
|||
|
|
echo $var['name']; // 'Иванов Иван'
|
|||
|
|
$var['name'] = 'Петров Пётр'; // BadMethodCallException
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Fluent-сеттеры
|
|||
|
|
|
|||
|
|
Реализованы на уровне конкретных классов сущностей, но у некоторых могут полностью отсуствовать.
|
|||
|
|
|
|||
|
|
```php
|
|||
|
|
$entity->setFoo($value)->setBar('bar')->...
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Сеттеры валидируют и фильтруют данные согласно схеме АТОЛ Онлайн API, а в случае ошибочных значений -- выбрасывают
|
|||
|
|
исключения.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
Читай также: [Коллекция сущностей](collection.md)
|
|||
|
|
|
|||
|
|
[Вернуться к содержанию](readme.md#toc)
|