Đưa vào một class @Document của Spring Data MongoDB cùng các class và record nhúng của nó, công cụ dựng JSON ví dụ cho những gì controller trả về khi gửi document đó. Hình dạng theo cách serialize Jackson mặc định của Spring Boot, nên nó mô tả response của API, không phải BSON được lưu trong MongoDB.
Nó tiết kiệm thời gian với các document MongoDB đầy list nhúng, field Map và timestamp Instant, nơi viết tay mẫu response rất mệt, đồng thời làm lộ rõ khoảng cách giữa định dạng lưu trữ và định dạng response.
@Document cùng các class hoặc record nhúng của nó vào ô Spring Data MongoDB.id và ngày tháng bằng giá trị thực tế trước khi dùng JSON trong tài liệu hay test.@Document(collection = "devices")
public class Device {
@Id
private String id;
private String serial;
@Field("fw")
private String firmwareVersion;
private Map<String, Double> lastReadings;
private List<Alert> alerts;
private Instant registeredAt;
}
record Alert(String level, String message, Instant raisedAt) {}{
"id": "",
"serial": "",
"firmwareVersion": "",
"lastReadings": {
"key": 0
},
"alerts": [
{
"level": "",
"message": "",
"raisedAt": "1970-01-01T00:00:00Z"
}
],
"registeredAt": "1970-01-01T00:00:00Z"
}Alert trong List<Alert> là record, nên các component level, message và raisedAt của nó thành field. Map<String, Double> thành {"key": 0}, và Instant là chuỗi UTC kết thúc bằng Z. @Field("fw") chỉ đổi tên field lưu trong MongoDB, nên key JSON vẫn là firmwareVersion.
record Alert(String level, ...), được đọc làm field.List và Set thành mảng một phần tử; Map<String, T> thành {"key": value}.Instant, ZonedDateTime và OffsetDateTime cho 1970-01-01T00:00:00Z, còn LocalDateTime cho chuỗi không có offset.ObjectId nhận chuỗi ObjectId hex mẫu.@DBRef thành object lồng nhau khi chúng có trong đầu vào.@JsonIgnore, @JsonProperty, @JsonIgnoreProperties và field kế thừa theo cùng quy tắc với trang JPA.Những cấu trúc mà MongoDB gói vào một document, như danh sách review, map option và mảng lịch sử, tạo ra ví dụ response rất dài. Dán các class vào là mọi cấp lồng nhau được viết ra giúp bạn.
Tên rút gọn qua @Field hay field ánh xạ sang _id làm key trong database khác key của API. Output cho thấy phía API, để bạn đặt hai bên cạnh nhau.
@Field("..."), @Indexed và @TextIndexed không đổi key JSON nên không được phản ánh.@Id String id được lưu thành _id nhưng khi ra khỏi Jackson là id, và output hiển thị đúng như vậy.org.bson.types.ObjectId thành object có timestamp và date, không phải chuỗi hex. Để gửi dạng chuỗi như hiển thị ở đây, hãy đăng ký ToStringSerializer hoặc dùng id kiểu String.GeoJsonPoint, thành null.@Id nên là ObjectId hay String?Với String, Spring Data chuyển nó thành ObjectId khi lưu và API trả về chuỗi hex gọn gàng. Giữ kiểu ObjectId nghĩa là bạn cần cấu hình Jackson thêm cho response.
@DBRef có thật sự trả về dạng object lồng nhau không?@DBRef phân giải document được tham chiếu khi đọc (lần truy cập đầu tiên nếu là lazy), nên response chứa object lồng nhau. Tham chiếu thủ công chỉ lưu id ObjectId hoặc String thì chỉ trả về id.
Map<String, Object> tự do trông như thế nào?Kiểu giá trị của nó không xác định nên thành {"key": null}. Hãy thay bằng loại giá trị bạn thực sự lưu trước khi đưa vào tài liệu.