JSON, YAML hay XML: nên dùng định dạng nào?

Cùng một dữ liệu ở ba định dạng

Một người dùng có tên, cờ đang hoạt động và hai vai trò trông như sau ở từng định dạng:

JSON và YAML ánh xạ trực tiếp sang object, list và giá trị đơn (scalar) trong hầu hết ngôn ngữ lập trình. XML mô tả một cây phần tử, và cách ánh xạ sang object chỉ là quy ước: ở đây cờ active có thể là thuộc tính hoặc phần tử con, và bản thân XML không cho biết giá trị đó là boolean chứ không phải văn bản true.

So sánh song song

JSON: chặt chẽ và dễ đoán

Ngữ pháp của JSON nhỏ đến mức vừa một trang giấy, nên trình phân tích ở mọi ngôn ngữ đều thống nhất với nhau. Chính sự chặt chẽ đó cũng gây ra những lỗi hay gặp nhất:

• Khóa và chuỗi phải dùng dấu ngoặc kép; dấu nháy đơn là không hợp lệ.
• Không có dấu phẩy thừa sau phần tử cuối cùng của object hoặc array.
• Không có chú thích, nên cấu hình viết bằng JSON không thể tự giải thích. Các biến thể như JSONC và JSON5 có thêm chú thích nhưng không phải JSON chuẩn.
• RFC 8259 yêu cầu JSON trao đổi giữa các hệ thống phải dùng UTF-8.

Ngữ pháp không giới hạn kích thước số, nhưng RFC 8259 lưu ý rằng phần lớn phần mềm dùng số thực double IEEE 754. Trong JavaScript, số nguyên lớn hơn 9007199254740992 (2^53) bị mất độ chính xác, nên ID lớn gửi dưới dạng chuỗi sẽ an toàn hơn.

YAML: dễ đọc nhưng nhiều cạm bẫy

YAML được thiết kế để con người đọc và sửa, và YAML 1.2 gần như là tập cha của JSON, nên hầu hết file JSON cũng là YAML hợp lệ. Sự linh hoạt của nó có cái giá:

• Thụt lề chính là cấu trúc. Lệch một dấu cách là thay đổi cấp lồng nhau, và không được dùng tab để thụt lề.
• Giá trị không đặt trong ngoặc sẽ bị đoán kiểu. Theo quy tắc YAML 1.1, vẫn được nhiều trình phân tích dùng, no, off và yes thành boolean, nên mã quốc gia NO biến thành false. Schema lõi của YAML 1.2 chỉ coi true và false là boolean, nhưng hãy kiểm tra trình phân tích của bạn theo phiên bản nào.
• Giá trị như 1.10 có thể thành số 1.1, và 012 có thể thành số bát phân. Hãy đặt trong ngoặc những chuỗi chỉ trông giống số, như số phiên bản và mã bưu chính.

XML: dài dòng nhưng sinh ra cho tài liệu

Với dữ liệu thuần túy, XML nặng hơn JSON, nhưng nó xử lý được những thứ hai định dạng kia không làm được: nội dung hỗn hợp (văn bản có markup xen giữa, như <p>Hello <b>world</b></p>), namespace cho phép các bộ từ vựng từ nhiều nguồn cùng tồn tại trong một file, và kiểm tra hợp lệ trưởng thành qua XSD. Các định dạng như DOCX, XLSX, SVG và RSS bên dưới đều là XML.

Chuyển XML sang JSON về bản chất là mất mát. Thuộc tính, thứ tự phần tử, phần tử lặp lại và nội dung hỗn hợp không có tương đương duy nhất trong JSON, nên các công cụ chuyển đổi phải chọn quy ước, chẳng hạn tiền tố @ cho thuộc tính hoặc ép phần tử lặp lại thành array.