Bài học

Giới thiệu ngắn gọn và hiện đại về định dạng trao đổi dữ liệu JSON: nó là gì và vì sao nó trở thành tiêu chuẩn de facto cho REST API, các cấu trúc cơ bản — đối tượng { } và mảng [ ], các kiểu hợp lệ (chuỗi "...", số, giá trị boolean true/ false, null), tính lồng nhau, so sánh với XML, ánh xạ JSON ↔ Java (các collection Map<K, V>, HashMap<K, V>). Phân tích ví dụ thực tế và lỗi thường gặp: dấu nháy đơn, dấu phẩy thừa, undefined, số có số 0 ở đầu.

Jackson — tiêu chuẩn de facto để làm việc với JSON trong Java: từ các thao tác tuần tự hóa và giải tuần tự đơn giản qua ObjectMapper đến tinh chỉnh bằng các chú thích @JsonProperty, @JsonIgnore, @JsonInclude, @JsonFormat. Trong bài giảng, chúng ta sẽ xem cách tích hợp ( jackson-databind), đọc và ghi đối tượng và collection, pretty-printing, làm việc với ngày giờ và các lỗi thường gặp, bao gồm generics với TypeReference và các yêu cầu với POJO (constructor không tham số, getter/setter).

Trong bài này, chúng ta tìm hiểu thư viện Google Gson: bắt đầu nhanh với các phương thức toJson/ fromJson, giải tuần tự các collection thông qua TypeToken<>, cấu hình linh hoạt với GsonBuilder ( setPrettyPrinting, serializeNulls, setDateFormat). Ta sẽ xem các annotation @SerializedName, @Expose, quản lý phiên bản @Since/ @Until, adapter tự viết qua TypeAdapter và registerTypeAdapter, sau đó so sánh với Jackson và điểm qua các lỗi thường gặp.

Khi cấu trúc JSON chưa biết trước hoặc thường xuyên thay đổi, sẽ tiện hơn khi làm việc không phải với các lớp Java cứng nhắc mà với các container chung: Map, List và cây JSON. Trong bài giảng, chúng ta xem cách dùng ObjectMapper để đọc dữ liệu vào Map<String, Object> và List, cách duyệt cây an toàn thông qua JsonNode và các phương thức của nó get/ path/ asText(), cũng như lựa chọn thay thế bằng Gson với JsonElement, JsonObject, JsonArray. Kết thúc bằng thực hành trích xuất cấu hình và phân tích các lỗi thường gặp.

Vì sao và cách kiểm tra dữ liệu đầu vào ở định dạng JSON trước khi giải tuần tự: phân tích hợp đồng dữ liệu bằng JSON Schema (các khóa type, properties, required, format), xác thực trong Java bằng thư viện everit-org/json-schema (tải schema vào Schema, gọi validate), xử lý đúng ValidationException và tạo thông báo lỗi dễ hiểu cho người dùng và API.