109. Go1.25: JSON v2

07.07.2025

Скачать

К списку выпусков

Ссылки выпуска:

• Capture HTTP requests in Postman
• Telethon: Pure Python 3 MTProto API Telegram client library, for bots too! (11k stars)
• Go 1.25 interactive tour (Anton Zhiyanov)
• JSON evolution in Go: from v1 to v2 (Anton Zhiyanov)

Postman предоставляет прокси подобно mitmproxy

Telethon для написания клиентов - мой проект

Go: JSON v2

В версии 1.25, которая выйдет этой осенью появится JSON v2. Это не значит, что нужно обязательно переходить на эту версию, однако ознакомиться с её функционалом будет полезно. Пакет реализован с использованием дженериков. Находится в директории v2 в encoding/json. Состоит всего из 7 функций. Также появился encoding/json/jsontext - это такой движок, а точнее потоковый токенайзер и парсер JSON объектов. Можно получать последовательно токены, анализировать, писать токены. v2 же занимается меппингом из внутреннего представления в типы Go и наоборот. Планируется, что v1 и v2 будут работать на базе jsontext пакета.

Маршалинг в v2 по скорости остался почти такой же, а вот анмашралинг ускорился от 3 до 10 раз.

MarshalWrite и UnmarshalRead для работы с одним JSON-объектом.

Добавлены опции, которые позволяют конфигурировать как будет работать маршалинг и анмаршалинг. Можно использовать опции из пакета json/v2 и из json/jsontext

• StringifyNumbers аналогично опции string в первой версии
• FormatNilSliceAsNull можно вернуть дефолтное поведение и выводить nil слайс как nil
• FormatNilMapAsNull форматирует пустой map в {} по-умолчанию, но можно переопределить
• OmitZeroStructFields аналогично опции omitzero в json теге при объявлении поля структуры
• MatchCaseInsensitiveNames v2 мепит по точному соответсвию, если имя json-поля не задано, но эта опция позволяет вернуть поведение v1
• SpaceAfterColon, SpaceAfterComma можно слегка повысить читаемость
• jsontext.Multiline(true) можно красиво отформатировать JSON
• jsontext.WithIndent, jsontext.WithIndentPrefix

Добавлены опции вроде inline для embed (встроенных) структур и unknown. Последняя очень полезна для отладки - позволяет при Unmarshal накапливать все необъявленные в структуре Go поля: Data map[string]any `json:",unknown"`

Для кастомного маршалинга по-прежнему поддерживаются MarshalJSON и UnmarshalJSON, но рекомендуется для повышения производительности использовать MarshalJSONTo и UnmarshalJSONFrom.

Важные резличия v1 и v2:

• v2 маршалит nil слайсы в []
• v2 маршалит nil map в {}
• v2 маршалит []byte в base64 строку (можно изменить опцией format: array в теге)
• v2 запрещает невалидные UTF-8 символы в строках (опция AllowInvalidUTF8 может отменить это поведение)