Vì sao Fomoxa
Phần lớn format để encoder tự chọn: thứ tự field, độ rộng số nguyên, có ghi giá trị mặc định hay không. Fomoxa bỏ hết những lựa chọn đó, nên cùng một giá trị cho ra cùng các byte ở mọi ngôn ngữ. Trang này nói khi nào điều đó đáng giá, và nó tốn gì.
Vấn đề
Với JSON hay Protobuf, cùng một dữ liệu có thể ra các byte khác nhau tuỳ ngôn ngữ, thư viện hay phiên bản. Thường thì không ai để ý, nhưng nó gây lỗi ở ba chỗ.
Chữ ký phủ lên byte. Nếu một implementation khác encode lại giá trị theo cách khác, việc kiểm tra thất bại dù dữ liệu không hề đổi.
Hai máy phải đi đến cùng một trạng thái từ cùng các input. Checksum trên trạng thái đó chỉ dùng được khi hai bên serialize nó giống hệt nhau.
Cách duy nhất để chứng minh hai SDK khớp nhau là so sánh byte của chúng. Việc đó cần đúng một đáp án để so.
Ý tưởng
Chỗ nào encoder được phép chọn, sớm muộn hai encoder sẽ chọn khác nhau. Bốn quy tắc sau không để lại lựa chọn nào cho encoder.
u32 là bốn byte, kể cả khi bằng 0, và không dùng varint.u32. Độ dài string tính theo byte UTF-8.Mỗi quy tắc có cái giá của nó, liệt kê ở phần đánh đổi: field chỉ tiến hoá ở cuối, không có gì là optional, và decode bằng sai schema thường cho ra giá trị sai thay vì báo lỗi. Đổi lại, tính đúng chỉ có một phép thử: đạt 100% các vector của RFC-0003.
Quy trình
Protobuf giữ schema trong một file .proto và sinh một type cho mỗi ngôn ngữ.
Công cụ tham chiếu của Fomoxa giữ schema ngay trên các type bạn đã có. Cách nào cũng có cái giá riêng, liệt kê bên dưới.
.proto.protoc hoặc buf cho từng ngôn ngữ đích.buf breaking.fomoxac generate trong từng project đó.fomoxac ci làm pull request thất bại khi có breaking change.fomoxac ci và nhờ handshake của runtime lúc kết nối, không phải nhờ compiler..fomoxa/schema.json là output được sinh ra.Trong thực tế: fomoxa-example-game khai báo protocol bằng Rust, C# và C++, và một script kiểm tra từng schema fingerprint đều khớp với server.
Annotation là lựa chọn của bộ công cụ tham chiếu, không phải của specification. Một file schema riêng, macro hay codec viết tay đều hợp lệ như nhau, miễn là các byte đạt RFC-0003.
Phù hợp