ArduinoJson 6 и 7: переносим старые скетчи на новый JsonDocument

Обновление библиотеки до седьмой версии я откладывал полгода, пока не понадобился чужой пример с фильтрами — он собирался только на v7. После обновления компилятор выдал список предупреждений на сотню строк: мой скетч 2019 года, три форка с GitHub и половина закладок писались в другие эпохи. Примеры в интернете старше версий — это нормально: шестая вышла в 2018-м, седьмая — весной 2024-го, а туториалы живут дольше обеих. Глупость ситуации в том, что чужой код v5 и v6 вам всё равно придётся читать: он окружает нас в форумах, чатах и готовых проектах, значит — нужен навык перевода, а не только новый синтаксис.

Главный сдвиг седьмой версии формулируется в одно предложение: пул памяти всегда живёт в куче, поэтому StaticJsonDocument и DynamicJsonDocument слились в один JsonDocument. В шестой разница между ними была в источнике байтов: Static вырезал ёмкость из статической области ещё на компиляции, Dynamic брал её у кучи malloc-ом в момент создания и был чуть медленнее. Седьмая план не спрашивает: не хватило — просит у кучи ещё порцию и продолжает разбор. На практике декларация перестала быть обещанием плате и стала обычным объявлением переменной, которое ничего не резервирует.

Разберём три отличия по существу, переезд за три шага и отдельный случай — примеры пятой версии, где поменялись не имена, а сам ход разбора. Базу седьмой версии мы уже проходили в уроке про JsonDocument и в уроке про установку; здесь — сравнение поколений и практический перенос старого кода.

Первое — декларация. Два класса с ёмкостью превращаются в один без неё: StaticJsonDocument<256> doc; и DynamicJsonDocument doc(256); в седьмой версии пишутся одинаково — JsonDocument doc;. Старые имена не выкинуты: они остались псевдонимами, старый код собирается, но каждая декларация даёт предупреждение о deprecated. Я перестал глушить эти предупреждения и начал их собирать: список warning-строк после первой компиляции — готовый чек-лист переезда, бесплатно.

Второе — строки. Шестая версия хранила const char* по указателю: строка лежала там, где лежала, и никто её не копировал — мы разбирали это в уроке про строки и копии вместе с граблями срока жизни. Седьмая всегда делает копию в пул: указатель не может протухнуть, за это платят байтами ёмкости — на маленьких документах цена копеечная, на длинных заголовках заметная. Приём с strdup и ручными копиями из отдельного урока в седьмой версии теряет смысл — пул держит строки сам. На бумаге это плата за спокойствие; в цифрах — те самые байты, которые мы научимся считать в конце серии.

Третье — смысл кода NoMemory. В шестой он значил: ёмкость мала, увеличьте число в скобках. В седьмой ёмкости нет, и тот же код значит: кончилась куча — вопрос переезжает с декларации на весь бюджет платы. Проверка err из урока про коды разбора не меняется ни буквой; меняется лечение — вместо цифры в скобках разбираются с кучей. Проверка err при этом одна и та же, только список подозреваемых другой: не декларация, а соседние библиотеки, String-буферы и сам размер пакета.

Переезд в большинстве случаев механический. Шаг первый — декларации: имя, минус размер. Шаг второй — лишние doc.clear(): deserializeJson сбрасывает документ перед разбором сам, и заготовка clear из старых примеров стала шумом — это проверялось ещё в уроке про JsonDocument седьмой версии. Шаг третий — пересборка со списком предупреждений: каждая deprecated-строка — точка правки, и правятся они однообразно. Исключение — проекты с несколькими файлами: компилятор покажет предупреждения по всем сразу, и список выйдет длиннее, чем вы ожидали, — это нормально, а не повод для правок вслепую. Переезд не считается законченным после компиляции: у меня есть контрольный прогон — разбираю тот же пакет, что и до обновления, и печатаю measureJson рядом со старой цифрой; длины печати совпадают до байта, а на сборке своего документа флаг overflowed() ловит тихий пропуск, который раньше находили по обрубку пакета в журнале сервера.

Примеры пятой версии правятся по смыслу. Там разбор выглядел как JsonObject& root = jsonBuffer.parseObject(packet); — буфер отдавал ссылку на объект, отдельного кода разбора не было вовсе, а неудача проверялась методом root.success(). Печать звалась root.printTo(Serial), замер длины — root.measureLength(). Словарик соответствий — в таблице ниже; он закрывает примерно весь интернет до 2018 года, где примеры на v5 до сих пор гадают ёмкость наугад.

Ниже — один и тот же разбор в трёх редакциях: тело скетча на седьмой версии, шестая и пятая — в комментариях рядом. Так скетч читается как параллельный перевод: правка видна строчка к строчке, и видно, что логика переезду не подчинилась — она её не заметила.

Движок книги понимает оба написания — и JsonDocument без ёмкости, и DynamicJsonDocument(768) в духе старых примеров, — поэтому в сим-скетче ниже оба документа живут рядом: старым разбирается пакет 2023 года, новым — пакет 2025-го. Честная оговорка: на настоящей плате седьмой версии первая строка даст предупреждение о deprecated и дальше будет работать как обычный пул; в симуляторе предупреждений не видно, разницу показывает только компилятор. measureJson при этом печатает одни и те же байты для обоих документов — пул один, различие только в том, кто его планировал.

Пакеты — два поколения одного сервиса: в 2023-м были temp и humi, к 2025-му сервер добавил rain и press. Код чтения doc.temp и doc.humi не изменился ни на символ: смена версии библиотеки и смена протокола — независимые события, и оба не трогают чтение. LED на D12 горит, когда в пакете найдено поле rain: containsKey различает поколения пакетов тем же API, каким вы читаете значения. Сравните bayt двух пакетов: печать потяжелела на два десятка байта — серверы растут вширь без спроса, и именно печать показывает это первым.

После переезда остаётся вопрос, который седьмая версия не решила, а переадресовала: сколько памяти вообще просить под пакет, когда куча на Uno — два килобайта. План больше не нужен декларации, но нужен вам — при расчёте бюджета кучи, при диагностике NoMemory и при подборе фильтров. Считаем по слотам и строкам, с проверкой печати и прикидкой на салфетке — следующий урок: NoMemory и расчёт ёмкости. Домашнее задание: найдите в закладках самый старый пример с JSON, переведите его по словарику и сравните, сколько предупреждений осталось после пересборки — обычно ноль, а если не ноль, то это честный список того, что вы ещё не трогали. Остаток обычно живёт в забытых модулях — одна-две строки, и это хороший исход: список короче, чем память проблем. Попутно сравните печатные размеры старых и новых пакетов — то же упражнение готовит вас к расчёту ёмкости из следующего урока.