CBOR byte string и text string: сохранить тип при преобразовании

Запросить

Шлюз хозяйства экспортирует CBOR данные сенсора в текстовый формат. Если byte string автоматически превратить в обычную строку, можно потерять исходные байты или изменить смысл поля. Проверяйте тип и прикладную схему до преобразования. Внешне похожее содержимое ещё не означает одинаковую семантику. Приёмка должна подтвердить передачу разрешённых данных и обратимость там, где она требуется, сохраняя различие между текстом, двоичным значением и его диагностическим представлением в интерфейсе обслуживающего персонала.

Назвать исходный тип

RFC 8949 определяет byte string и text string как разные CBOR типы. (IETF RFC 8949 — CBOR types) Тип не следует угадывать по тому, удалось ли вывести содержимое в терминал. Подтвердите контракт поля сенсора. Двоичный идентификатор не становится UTF текстом только потому, что выбранный тест состоит из печатных символов. Если приложение задаёт специальное кодирование для экспорта, оно должно быть явным и согласованным с получателем; имя обычной строковой колонки само по себе такой договорённости не создаёт.

В карте укажите исходный CBOR тип, назначение поля, допустимую длину и способ представления в целевом формате. Отдельно определите пустое значение и отсутствие поля. Не заменяйте непечатаемые байты знаками вопроса без статуса потери. Если обратное преобразование требуется, сохраните исходную информацию и версию правила. Секретные реальные payload для проверки не нужны. Собственный тестовый набор может включать различимые байты и текст, позволяющие выявить преобразование, которое иначе оставалось бы незаметным на привычных коротких идентификаторах датчика хозяйства.

Две карточки сравнивают собственные диагностические примеры byte string h'41' с одним байтом и text string A с одним символом. Одинаковый вид при выводе не меняет двоичный или текстовый тип. Контракт экспорта сохраняет кодирование, назначение и правило; отдельный тест байтов ноль-ноль эф-эф выявляет потерю непечатаемого содержимого.
Собственная схема использует различимые учебные случаи без реальных идентификаторов. Диагностическая запись h'41' показывает содержимое byte string; экспорт и обратимость проверяются по согласованной схеме, а не по сходству строки с текстом.

Испытать различимые случаи

Подайте изолированному конвертеру одинаково выглядящие значения разных типов и отдельный двоичный набор с непечатаемыми элементами. Сравните внутреннюю модель, экспорт и результат повторного чтения. Не используйте только ASCII пример: он плохо выявляет ошибку. Сохраняйте точный байтовый состав и длину. Если схема допускает только один тип, неподходящий вход должен дать предусмотренный отказ, а не молча преобразоваться в допустимое поле. Тесты должны проверять реальные границы контракта, не подменяя его произвольным обещанием поддержки любых CBOR объектов.

Отдельно проверьте пустое поле, неизвестное кодирование и некорректный тестовый текст в рамках правил декодера. Программа должна показать ограничение и не обновить рабочий идентификатор датчика повреждённым значением. После восстановления корректного потока подтвердите новое сообщение и отсутствие остатка прежнего буфера. При экспорте для человека диагностическое представление подписывают своим типом. Оно не должно снова подаваться в приложение как будто является первоначальными байтами без обратного декодирования по согласованному правилу преобразования полевых данных хозяйства.

Принять тип вместе с данными

В акте сохраните схему и побайтовую сверку тестов. Приёмка подтверждает корректное преобразование выбранных типов и честный отказ неподдерживаемым. Для хозяйства это предотвращает тихую порчу идентификаторов, двоичной диагностики и других полей при переходе к JSON или таблице. Инженер может восстановить исходный смысл и проверить обратимость, а удобная строка на экране не скрывает потерю данных. Текст и байты сохраняют свои роли через весь проверенный тракт обработки сообщения сенсора до конечного архивного потребителя.

Все разборы