Исходный код вики Методы API
Последние авторы
| author | version | line-number | content |
|---|---|---|---|
| 1 | (% class="lead" %) | ||
| 2 | Вопросы, связанные с работой методов API: | ||
| 3 | |||
| 4 | **Почему в ответах некоторых методов API возвращается свойство $type?** | ||
| 5 | |||
| 6 | |(% style="border-color:white" %)((( | ||
| 7 | (% class="box infomessage" %) | ||
| 8 | ((( | ||
| 9 | **Примечание:** рекомендуется ознакомиться {{html}}<a href="https://docs.loymax.net/xwiki/bin/view/Main/General_information/Used_technologies/">со стеком технологий</a>{{/html}}, используемых системой Loymax. | ||
| 10 | ))) | ||
| 11 | |||
| 12 | ((( | ||
| 13 | Объекты, используемые во фреймворке **.Net**, переводятся из структуры данных в последовательность байтов или строку. В таком формате данные удобно передавать и хранить. | ||
| 14 | |||
| 15 | (% class="box" %) | ||
| 16 | ((( | ||
| 17 | Процесс передачи состояния объекта в поток байтов с целью их сохранения в памяти ПК, в базе данных или файле называется **сериализацией**. Основное назначение сериализации — сохранение состояния объекта, чтобы в случае необходимости была возможность восстановить его. | ||
| 18 | Обратный перевод байтов в структуру данных называется **десериализцией**. | ||
| 19 | ))) | ||
| 20 | |||
| 21 | Система Loymax для сериализации/десериализации использует **Newtonsoft.Json.JsonSerializer**. | ||
| 22 | ))) | ||
| 23 | )))|(% style="border-color:white; text-align:center; width:25%" %){{lightbox image="Group 1 (1).png"/}} | ||
| 24 | |||
| 25 | Рассмотрим процесс сериализации/десериализации на примере работы метода для [[получения списка брендов>>doc:Main.Integration.Ways_to_use_API.API_methods.Methods_of_public_api.Brands.WebHome||anchor="H41F43E43B44344743543D43843544143F43844143A43043144043543D43443E432"]]. | ||
| 26 | |||
| 27 | Все бренды в Системе созданы по одному шаблону (модели), то есть наследуются от одного типа данных. | ||
| 28 | |||
| 29 | Сериализация: | ||
| 30 | |||
| 31 | * Существует тип **BrandBase**. | ||
| 32 | * Пользователь создал бренды: **Brand1 **и **Brand2**. | ||
| 33 | * **Brand1 **и **Brand2 **наследуют все свойства типа **BrandBase**. | ||
| 34 | * Так как бренды являются объектами .Net, они переводятся в поток байтов для хранения в базе данных. | ||
| 35 | |||
| 36 | Алгоритм получения информации о брендах через методы API работает следующим образом (происходит десериализация): | ||
| 37 | |||
| 38 | 1. Клиент отправляет запрос на получение списка брендов (##GET: /v1.2/brands##). | ||
| 39 | 1. Сервер обрабатывает запрос, формирует и отправляет SQL-запрос в базу данных на получение списка брендов. | ||
| 40 | 1. База данных в ответ на запрос сервера возвращает серверу список брендов, которые переводятся из потока байтов обратно в объект .Net. | ||
| 41 | 1. Сервер возвращает клиенту список брендов в формате JSON: | ||
| 42 | 1*. Сериализатор **Newtonsoft.Json.JsonSerializer **преобразует объект .Net в формат JSON. | ||
| 43 | 1*. **Brand1 **и **Brand2 **являются объектами, созданными по типу **BrandBase**. Так как сериализатор ожидает получить только объект типа **BrandBase**, а **Brand1 **и **Brand2 **распознает как отдельные типы, которые наследуются от общего типа **BrandBase**, то он присваивает им свойство ##$type##, в котором указана модель, согласно которой был создан объект, чтобы при десериализации создать объект исходного типа. | ||
| 44 | |||
| 45 | Таким образом, в ответе на запрос для получения списка брендов, информация о **Brand1 **будет выглядеть следующим образом: | ||
| 46 | |||
| 47 | (% class="box" %) | ||
| 48 | ((( | ||
| 49 | ##{ | ||
| 50 | "$type": "Loymax.Api.Models.BrandInfo.BrandBase, Loymax.Api", | ||
| 51 | "id": 111222, | ||
| 52 | "guid": "00000000-0000-0000-0000-000000000000", | ||
| 53 | "code": "7878b563333841d79a5e5d14fde29cbe", | ||
| 54 | "order": 0, | ||
| 55 | "state": "Normal", | ||
| 56 | "uid": "10e6c953-132d-441b-8ecb-1525b2d06e10", | ||
| 57 | "name": "Brand1", | ||
| 58 | "description": "Новый бренд", | ||
| 59 | "fullDescription": null, | ||
| 60 | "url": null, | ||
| 61 | "images": [] | ||
| 62 | }## | ||
| 63 | ))) | ||
| 64 | |||
| 65 | |||
| 66 |