Rivalry2

HTML Diff

0 added 0 removed

Original 2026-01-01

Modified 2026-02-26

1 В вебе взаимодействие происходит по схеме клиент-сервер. Клиент отправляет запрос, а сервер отдает ответ.

2 Обычно в запросах и ответах содержится информация о том, что именно клиент хочет от сервера. Например, при запросах на получение данных указывается, какие данные сервер должен вернуть. Чаще всего эти данные представляются в виде структур, при этом нам нужно передать их в текстовом виде. В этом случае разработчики используют сериализацию.

3 В этом уроке мы разберем формат сериализации данных - JSON. Мы рассмотрим, как сериализовать и десериализовать данные в JSON в Golang.

4 <h2>Сериализация и десериализация в Golang</h2>

5 Представим, что нам нужно получить список пользователей. Клиент отправляет запрос GET /users, а сервер отдает ответ в виде списка пользователей. Список пользователей - это массив структур. Каждая структура содержит информацию о пользователе. Например, имя, фамилию, возраст, пол.

6 Мы знаем, что HTTP - это текстовый протокол, поэтому в запросе и ответе могут быть только текстовые данные. Поэтому нам нужно передать массив пользователей в текстовом виде. В этом нам поможетсериализация- процесс преобразования данных в строку. Сервер сериализует массив пользователей в строку и передает клиенту. Клиент может десериализовать строку обратно в массив структур пользователей.

7 Десериализация - это процесс преобразования сериализованной строки обратно в данные, которое понимает приложение.

8 На схеме ниже показано, как происходит сериализация и десериализация данных при отправке HTTP-ответа от сервера к клиенту:

9 Сервер сериализует объекты пользователей в строку, отправляет это в теле HTTP-ответа, а клиент читает тело ответа и десериализует строку обратно в данные.

10 Существует множество протоколов сериализации данных. Они отличаются способами преобразования данных в строку и форматами сериализованной строки. Наиболее популярные протоколы сериализации данных: JSON, XML, YAML, MessagePack и Protocol Buffers.

11 В этом курсе мы разберем самый популярный протокол сериализации данных -JSON. У него есть следующие преимущества:

12 <ul><li>Простой в изучении, чтении и понимании</li>

13 <li>Поддерживается большинством языков программирования</li>

14 <li>Формат достаточно компактный по сравнению с широко используемым в прошлом XML</li>

15 </ul>Перед тем, как продолжить, ознакомьтесь с этим форматом сериализации в<a>документации</a>.

16 Для сериализации и десериализации данных в JSON используется стандартная библиотека. Для этого в ней есть две функции:

17 <ul><li>json.Marshal() - сериализует данные в JSON</li>

18 <li>json.Unmarshal() - десериализует данные из JSON</li>

19 </ul>Так в GO происходит сериализация и десериализация структуры:

20 При запуске программы видим вывод:

21 В данном Go-приложении мы преобразовали объект пользователяUserв JSON-строку и обратно. В результате мы получили ту же структуруUser, но с пустым полемpassword, потому что указали, что это приватное поле. Если бы мы отправили такую JSON-строку по сети другому веб-приложению, то оно смогло бы восстановить изначальный объектUserбез поляpassword.

22 Важные моменты работы с JSON в Go:

23 <ul><li>В структуре сериализуются только публичные свойства, которые написаны с заглавной буквы. В нашем примере свойство password - приватное, поэтому оно не попало в JSON-строку. Такое же правило действует и на десериализацию. Если мы добавим значение password в JSON-строку, то это значение все равно не попадет в десериализованную структуру

24 </li>

25 <li>В JSON-строке можно указывать название свойства, которое будет отличаться от названия свойства в структуре. Для этого используется тег json:"". В нашем примере мы указали тег для свойства ID в виде json:"id". Так можно указывать, в каком виде должно называться свойство в JSON-строке в зависимости от соглашений в проекте

26 </li>

27 <li>При описании тега json:"" можно указать опцию omitempty. Эта опция говорит о том, что если значение свойства является нулевым, то это поле не нужно включать в сериализованную строку

28 </li>

29 </ul>Мы научились работать с JSON в Golang, теперь рассмотрим, как использовать этот формат в веб-приложениях.

30 <h2>JSON в веб-приложении</h2>

31 В веб-приложениях JSON используется, чтобы обменивать данные между клиентом и сервером. Клиент может отправлять HTTP-запрос с телом запроса в формате JSON, а сервер может возвращать HTTP-ответ с телом в формате JSON.

32 Веб-клиент отправляет JSON в теле запроса в случае, когда нужно изменить состояние чего-либо. Например, если пользователь заполнил форму регистрации, то веб-клиент отправит JSON с данными формы на сервер. Сервер в этом случае сохранит нового пользователя в базе данных.

33 Сервер возвращает ответ с JSON, когда клиент запрашивает данные. Например, клиент запросил список курсов на Хекслете, и сервер вернул JSON массив структур курсов.

34 Реализуем эти концепции на примере Fiber веб-приложения. В Fiber работа с JSON происходит через контекст запроса c *fiber.Ctx. Для этого есть два метода:

35 <ul><li>c.BodyParser() - преобразует JSON-тело запроса в объект</li>

36 <li>c.JSON() - отправляет JSON-строку в теле ответа</li>

37 </ul>Реализуем веб-приложение для сохранения логов, в котором отправим JSON в теле запроса и получим JSON в теле ответа.

38 В приложении будет единственный метод /logs, который будет принимать POST-запросы на сохранение записи. В теле запроса передается структура одной записи логов. В ответе веб-приложение возвращает структуру с идентификатором сохраненной записи:

39 Запускаем веб-приложение и отправляем запрос на сохранение тестовой записи:

40 В ответ получаем идентификатор:

41 В данном веб-приложении мы описали структуры запроса и ответа с публичными свойствами и JSON-тегами. Благодаря этому, мы смогли использовать структуру запроса CreateLogEntryRequest в методе c.BodyParser(), чтобы десериализовать тела запроса из JSON. Также мы использовали структуру ответа CreateLogEntryResponse в методе c.JSON(), чтобы сериализовать тела ответа в JSON.

42 <h2>Выводы</h2>

43 В этом уроке мы изучили, что такое сериализация - процесс преобразования структур данных в строку. И десериализация - процесс преобразования сериализованной строки обратно в данные.

44 Еще мы разобрали самый популярный формат сериализации данных - JSON, так как он простой в генерации и чтении по сравнению с аналогами.

45 Напомним еще несколько важных моментов из урока:

46 <ul><li>В Go у структур сериализуются только публичные поля</li>

47 <li>В фреймворке Fiber есть функция c.BodyParser(), которая позволяет десериализовать JSON тело запроса в структуру</li>

48 <li>В фреймворке Fiber есть функция c.JSON(), которая позволяет сериализовать структуру тела ответа в JSON</li>

49 </ul>