JSON for Beginners: A 5-Minute Guide — csv-x.com

By Marcus Chen, Kỹ Sư Tích Hợp Dữ Liệu Cấp Cao với 12 năm kinh nghiệm xây dựng các hệ thống dựa trên API cho các công ty Fortune 500

Ba năm trước, tôi đã chứng kiến một lập trình viên junior mất sáu giờ để gỡ lỗi một lỗi đơn giản, hóa ra chỉ là một dấu phẩy sai vị trí trong một tệp JSON. API cứ trả về các lỗi 400 khó hiểu, các nhật ký không hữu ích và sự thất vọng tăng lên với mỗi lần thử thất bại. Khi chúng tôi cuối cùng phát hiện ra lỗi nhỏ trong dòng 247 của tệp cấu hình, sự nhẹ nhõm thật rõ ràng—nhưng cũng là sự nhận ra rằng lập trình viên này chưa bao giờ được dạy về những điều cơ bản của JSON một cách đúng đắn. Khoảnh khắc đó đã làm nổi bật điều mà tôi đã quan sát suốt sự nghiệp: JSON đã trở nên phổ biến đến mức trong phát triển phần mềm hiện đại, chúng tôi thường giả định rằng ai cũng hiểu nó, nhưng nhiều lập trình viên học nó một cách ngẫu nhiên qua thử và sai thay vì nắm bắt được sự đơn giản thanh lịch của nó ngay từ đầu.

Ngày nay, JSON (JavaScript Object Notation) chiếm khoảng 80% tất cả các API web theo các khảo sát gần đây về các thư mục API công cộng. Nó là ngôn ngữ chung cho việc trao đổi dữ liệu giữa máy chủ và khách hàng, là xương sống của các tệp cấu hình trong vô số ứng dụng, và là định dạng mặc định cho các cơ sở dữ liệu NoSQL như MongoDB. Nếu bạn làm việc trong phát triển web, ứng dụng di động, hoặc bất kỳ hệ thống nào giao tiếp qua internet, bạn đang làm việc với JSON dù bạn có nhận ra hay không. Hướng dẫn này sẽ cung cấp cho bạn nền tảng vững chắc về JSON mà lẽ ra đã cứu được lập trình viên junior đó—và vô số người khác—khỏi hàng giờ gỡ lỗi.

JSON Chính Xác Là Gì Và Tại Sao Bạn Nên Quan Tâm?

JSON là một định dạng trao đổi dữ liệu nhẹ, dễ đọc và viết cho con người, và dễ cho máy móc phân tích và sinh ra. Được tạo ra bởi Douglas Crockford vào đầu những năm 2000, nó xuất hiện như một sự thay thế đơn giản hơn cho XML, định dạng đã thống trị việc trao đổi dữ liệu trong nhiều năm nhưng đi kèm với overhead và độ phức tạp lớn. Trong khi một tài liệu XML có thể yêu cầu 300 byte để biểu diễn một đối tượng người dùng đơn giản với tên, email, và tuổi, JSON có thể làm điều đó trong chưa đến 100 byte—giảm 66% giúp truyền tải dữ liệu nhanh hơn và giảm chi phí băng thông ở quy mô lớn.

Sự đẹp đẽ của JSON nằm ở sự tối giản của nó. Nó chỉ sử dụng sáu ký tự cấu trúc (dấu ngoặc nhọn, dấu ngoặc vuông, dấu hai chấm, và dấu phẩy) và hỗ trợ chỉ sáu kiểu dữ liệu. Sự đơn giản này có nghĩa là bạn có thể học toàn bộ đặc tả trong một buổi chiều, nhưng nó đủ mạnh để đại diện cho các cấu trúc dữ liệu phức tạp lồng vào nhau phản ánh cách chúng ta nghĩ về thông tin một cách tự nhiên. Khi tôi giải thích JSON cho những người mới, tôi nói với họ rằng nó giống như một bộ dịch toàn cầu cho dữ liệu—mọi ngôn ngữ lập trình lớn đều có thể đọc và viết nó, khiến nó trở thành lựa chọn hoàn hảo khi backend Python của bạn cần giao tiếp với frontend JavaScript của bạn, hoặc khi ứng dụng di động của bạn cần giao tiếp với dịch vụ đám mây.

Các hệ quả thực tiễn rất lớn. Trong vai trò hiện tại của tôi, chúng tôi xử lý khoảng 2,3 triệu yêu cầu API JSON hàng ngày qua kiến trúc microservices của chúng tôi. Mỗi dịch vụ nói chuyện bằng JSON, bất kể nó được viết bằng Java, Go, Python hay Node.js. Sự chuẩn hóa này đã giảm thời gian tích hợp cho các dịch vụ mới khoảng 40% so với hệ thống dựa trên XML trước đây của chúng tôi. Khi một lập trình viên mới gia nhập nhóm, họ có thể bắt đầu đóng góp cho bất kỳ dịch vụ nào trong vòng vài ngày vì định dạng dữ liệu là nhất quán ở mọi nơi.

Sự thống trị của JSON không phải ngẫu nhiên—nó giành chiến thắng nhờ giá trị của mình. Nó không phụ thuộc vào ngôn ngữ, dễ đọc cho con người, và đạt được sự cân bằng hoàn hảo giữa sự biểu cảm và sự đơn giản. Không giống như các định dạng nhị phân cần công cụ đặc biệt để kiểm tra, bạn có thể mở một tệp JSON trong bất kỳ trình soạn thảo văn bản nào và ngay lập tức hiểu được cấu trúc của nó. Không giống như các định dạng dài dòng như XML, nó không chôn vùi dữ liệu thực của bạn dưới các lớp đánh dấu. Sự kết hợp giữa khả năng tiếp cận và hiệu suất này giải thích tại sao JSON đã trở thành lựa chọn mặc định cho các API hiện đại, với các API REST sử dụng JSON trong khoảng 95% các trường hợp theo các phân tích thư mục API.

Sáu Khối Xây Dựng: Các Kiểu Dữ Liệu Của JSON

Hiểu về JSON bắt đầu bằng việc hiểu sáu kiểu dữ liệu của nó, mà tạo thành từ vựng hoàn chỉnh của định dạng. Không giống như các ngôn ngữ lập trình có hàng chục kiểu dữ liệu, JSON giữ mọi thứ đơn giản một cách có chủ đích, đó là một phần của sự thông minh của nó. Sáu loại này có thể đại diện cho hầu hết mọi cấu trúc dữ liệu mà bạn sẽ gặp trong các ứng dụng thế giới thực.

Dãy ký tự là các chuỗi ký tự được bao quanh bởi dấu ngoặc kép. Chúng có thể chứa bất kỳ ký tự Unicode nào, khiến JSON thực sự trở nên quốc tế. Trong công việc của tôi với các nền tảng thương mại điện tử toàn cầu, chúng tôi thường xuyên xử lý mô tả sản phẩm bằng 47 ngôn ngữ khác nhau, tất cả đều được biểu diễn dưới dạng chuỗi JSON. Quy tắc chính: luôn sử dụng dấu ngoặc kép, không bao giờ sử dụng dấu ngoặc đơn. Một chuỗi trông như thế này: "Hello, World!" hoặc "价格: ¥299" hoặc "Café résumé".

Số trong JSON thì đơn giản rõ ràng—không có các kiểu riêng biệt cho số nguyên và số thực, không có giới hạn kích thước nào được chỉ định trong định dạng. Bạn có thể viết 42, 3.14159, -17, hoặc 6.022e23 (định dạng khoa học). Độ đơn giản này đôi khi gây nhầm lẫn khi sự chính xác rất quan trọng—các ứng dụng tài chính cần cẩn thận vì các bộ phân tích JSON có thể đại diện cho 0.1 + 0.2 là 0.30000000000000004 do số học dấu phẩy động. Trong các hệ thống ngân hàng mà tôi đã làm việc, chúng tôi luôn truyền tải giá trị tiền tệ dưới dạng chuỗi hoặc số nguyên đại diện cho xu để tránh những vấn đề chính xác này.

Boolean chỉ đơn giản là true hoặc false (chữ thường, không có dấu ngoặc). Chúng rất hoàn hảo cho các cờ hiệu và trạng thái nhị phân. Trong các tệp cấu hình, tôi sử dụng boolean rất nhiều: "debugMode": true, "enableCaching": false, "requireAuthentication": true. Sạch sẽ và rõ ràng.

Null đại diện cho sự vắng mặt của một giá trị, viết là null (chữ thường, không có dấu ngoặc). Nó khác với một chuỗi trống hoặc số không—nó có nghĩa là "không có giá trị ở đây." Sự phân biệt này rất quan trọng khi bạn đang xử lý các trường tùy chọn. Trong các hồ sơ người dùng, "middleName": null rõ ràng cho thấy người dùng không có tên giữa, khác với "middleName": "" có thể có nghĩa là họ có một cái nhưng nó trống, hoặc trường này hoàn toàn không có.

Mảng là danh sách có thứ tự của các giá trị được bao quanh bởi dấu ngoặc vuông, với các giá trị được phân tách bằng dấu phẩy. Các mảng có thể chứa bất kỳ sự kết hợp nào của các kiểu JSON: [1, 2, 3], ["red", "green", "blue"], hoặc thậm chí [42, "mixed", true, null]. Trong thực tế, các mảng thường chứa các mục cùng loại cho sự nhất quán. Tôi đã thấy các mảng có hơn 50.000 phần tử trong các tệp xuất dữ liệu, mặc dù đối với các phản hồi API, chúng tôi thường phân trang trên 100 mục để giữ cho thời gian phản hồi dưới 200 mili giây.

Đối tượng là các tập hợp không có thứ tự của cặp khóa-giá trị được bao quanh bởi dấu ngoặc nhọn. Các khóa phải là chuỗi (trong dấu ngoặc kép), theo sau bởi một dấu hai chấm, rồi là giá trị. Các đối tượng là nơi JSON thật sự tỏa sáng, cho phép bạn đại diện cho các thực thể phức tạp: {"name": "Marcus", "age": 34, "isEngineer": true}. Các đối tượng có thể lồng nhau vô hạn, mặc dù trên thực tế tôi khuyên bạn nên giữ việc lồng nhau tối đa ở mức 3-4 cấp độ để dễ bảo trì.

Quy Tắc Cú Pháp JSON: Ngữ Pháp Bạn Phải Tuân Theo

Các quy tắc cú pháp của JSON thì nghiêm ngặt, và sự nghiêm ngặt này thực sự là một đặc điểm, không phải lỗi. Không giống như JavaScript (mà JSON giống), không có khoảng trống cho sự diễn giải hoặc linh hoạt. Sự cứng nhắc này có nghĩa là các bộ phân tích JSON có thể nhanh chóng và đáng tin cậy—chúng hoặc phân tích thành công hoặc thất bại với một lỗi rõ ràng. Sau khi gỡ lỗi hàng trăm vấn đề JSON, tôi có thể nói với bạn rằng 90% vấn đề đến từ việc vi phạm những quy tắc cú pháp cơ bản này.