stadium-proto/Сериализация (LBM).md
shr3dd3r a9cbbc5482 Множественные исправления
Правки, внесённые в связи с последними изменениями, уточнениями и пожеланиями.
2024-05-24 00:06:47 +03:00

2.7 KiB
Raw Blame History

Сериализация и формат LBM

Данный формат сериализации используются в теле системных событий и рукопожатии. Данные сериализованные в формат LBM (AKA "данные в формате LBM") являются расположенными последовательно ячейками с ключом, длинной значения и значением, в неопределённом порядке относительно друг-друга. Положение ячеек относительно друг-друга не детерминированно и они могут быть намеренно перемешаны. Отсутствие каких-либо ячеек вообще обозначается единичным нулевым байтом.

Ключ является однобайтным числом без знака. Ключ всегда больше нуля. В каждом контексте (контекст системных событий и контекст рукопожатия) есть свой набор выделенных ключей. Все остальные, неиспользуемые ключи при парсинге опускаются. Длинна значения является двухбайтным числом без знака. Если ячейка пуста, то длинна нулевая. Значением является произвольная последовательность байт.

Одна ячейка имеет следующий вид:

B: byte(s)

|------------|
| Key: 1B    |
|------------|
| Length: 2B |
|------------|
| Value: ~B  |
|------------|

Пример в шестнадцатеричном представлении:

  Length in bytes
    |
    VVVV
0xDA00080123456789ABCDEF
  ^^    ^^^^^^^^^^^^^^^^
  |     |
 Key   Value

Следовательно, форматированные данные целиком имеют вид:

|------------|
| Cell 1: ~B |
|------------|
| Cell 2: ~B |
|------------|
| ...        |
|------------|
| Cell N: ~B |
|------------|

Пример в шестнадцатеричном представлении:

                                          Cell #4 (1B)
                       Cell #2 (4B)         |
                        |                   |
                        VVVVVVVVVVVVVV      VVVVVVVV
0xDA00080123456789ABCDEFF10004FEDCBA98220000340001FF... (and so on)
  ^^^^^^^^^^^^^^^^^^^^^^              ^^^^^^
  |                                   |
 Cell #1 (8 bytes length)             |
                                     Cell #3 (empty cell)