Gộp JSON

Đề xuất Liên quan

JSON Merge (Gộp JSON) là gì?

Trường hợp sử dụng

• Gộp response API từ nhiều microservice thành cấu trúc JSON thống nhất cho frontend sử dụng
• Tổng hợp file cấu hình đa tầng base / dev / prod, ghi đè theo môi trường tạo cấu hình cuối cùng
• Gộp, loại bỏ trùng lặp và bổ sung nhiều file dịch i18n theo ngôn ngữ thành từ điển hoàn chỉnh
• Gộp nhiều mảng dữ liệu mock hoặc nhiều response API phân trang thành tập dữ liệu hoàn chỉnh
• Gộp cấu hình mặc định component frontend + cấu hình tùy chỉnh người dùng + cấu hình A/B testing từ xa
• Trong di chuyển dữ liệu, gộp file xuất JSON từ nhiều hệ thống nguồn, thống nhất thành định dạng hạ nguồn

Cách Sử dụng

1. Dán tuần tự từ 2 đến N đoạn JSON cần gộp vào ô nhập bên trái (mặc định 2 ô), hoặc nhấn「+」để thêm nhiều đầu vào hơn
2. Chọn chiến lược gộp trong hộp chọn thả xuống của thanh công cụ: Gộp sâu (Deep) / Gộp nông (Shallow) / Nối mảng (Array Concat) / Thay thế mảng (Array Replace)
3. Nhấn nút「Gộp」, ô xuất bên phải sẽ hiển thị kết quả đã định dạng sau khi gộp; nếu đầu vào có lỗi cú pháp sẽ hiển thị số dòng cụ thể và thông báo lỗi
4. Sau khi xác nhận kết quả chính xác, nhấn「Sao chép」để đưa kết quả gộp vào bộ nhớ đệm, hoặc nhấn「Tải xuống」để lưu thành file merged.json tiếp tục xử lý định dạng, xác thực Schema và các bước tiếp theo

Tính năng

• 4 chiến lược gộp: Gộp sâu / Gộp nông / Nối mảng / Thay thế mảng, chuyển đổi một cú nhấp đáp ứng các tình huống nghiệp vụ khác nhau
• Hỗ trợ từ 2 đến N đoạn JSON: mặc định 2 ô nhập, nhấn「+」để thêm động nhiều JSON nguồn hơn, linh hoạt thích ứng tổng hợp đa nguồn
• Gộp đệ quy sâu: xử lý thông minh object lồng nhau đa tầng, xung đột nút lá xử lý theo chiến lược chỉ định, giữ lại mọi trường hợp lệ
• Giải quyết xung đột linh hoạt: xung đột tầng cao nhất thực hiện theo chiến lược đã chọn; xung đột object lồng nhau sẽ đi vào gộp sâu; xung đột mảng phân biệt xử lý theo arrayConcat/arrayReplace
• Xuất định dạng thống nhất: kết quả gộp hiển thị với thụt lề 2 khoảng trắng, thuận tiện xem xét thủ công và sao chép trực tiếp sang công cụ hạ nguồn
• Thực thi gộp thời gian thực: dán xong nhấn「Gộp」là có kết quả, khi lỗi hiển thị số dòng JSON cụ thể và thông báo lỗi
• Xử lý cục bộ bảo vệ quyền riêng tư: phân tích cú pháp, gộp, định dạng đều hoàn thành cục bộ trên trình duyệt, nội dung nhập không gửi đến bất kỳ máy chủ nào
• Kết nối liền mạch hạ nguồn: kết quả gộp có thể sao chép một cú nhấp sang công cụ Định dạng JSON, Xác thực Schema, Sinh mã và các công cụ khác để tiếp tục xử lý

Ví dụ mã

// npm install lodash.merge
import merge from 'lodash.merge';

const a = { user: { name: 'Alice', age: 28 }, tags: ['admin'] };
const b = { user: { email: 'a@x.com', age: 29 }, tags: ['editor'] };

// Gộp sâu: object lồng nhau được gộp đệ quy, nút lá giá trị sau ghi đè giá trị trước
const deep = merge({}, a, b);
console.log(deep);
// => { user: { name: 'Alice', age: 29, email: 'a@x.com' }, tags: ['admin', 'editor'] }

// Gộp nông: khóa tầng cao nhất bị ghi đè toàn bộ, không đi vào lồng nhau
const shallow = Object.assign({}, a, b);
console.log(shallow);
// => { user: { email: 'a@x.com', age: 29 }, tags: ['editor'] }

# pip install mergedeep
from mergedeep import merge

a = {"user": {"name": "Alice", "age": 28}, "tags": ["admin"]}
b = {"user": {"email": "a@x.com", "age": 29}, "tags": ["editor"]}

# Gộp sâu
result = merge(a, b)
print(result)
# => {'user': {'name': 'Alice', 'age': 29, 'email': 'a@x.com'}, 'tags': ['admin', 'editor']}

# Lưu ý: mergedeep mặc định gộp mảng, chuỗi/số thì ghi đè
# Nếu cần ghi đè mảng, thêm strategy='override'

# Nối nhiều mảng JSON thành một mảng dài
jq -s 'add' a.json b.json c.json

# Gộp đệ quy nhiều đối tượng JSON (jq 1.6+)
jq -s 'reduce .[] as $item ({}; . * $item)' a.json b.json

# Gộp nông: ghi đè khóa tầng cao nhất của b lên a
jq -s '.[0] * .[1]' a.json b.json

# Sau khi gộp mảng, chỉ giữ lại trường id đã loại trùng
jq -s '[.[].items[]] | unique_by(.id)' a.json b.json

Câu hỏi Thường gặp

Xử lý sự cố

Thuật ngữ

JSON Merge

Thao tác hợp nhất hai hoặc nhiều đối tượng JSON thành một đối tượng mới theo quy tắc chỉ định; điểm mấu chốt là "chiến lược giải quyết khi tên khóa bị xung đột".

Deep Merge / Gộp sâu

Chiến lược đệ quy vào object lồng nhau, gộp từng nút lá riêng biệt; khi cả hai phía đều là object thuần thì đệ quy, ngược lại xử lý theo cách ghi đè.

Shallow Merge / Gộp nông

Chiến lược chỉ gộp các khóa tầng cao nhất, khóa trùng tên bị ghi đè toàn bộ; trong JS tương đương với `Object.assign({}, a, b)`.

Array Concat / Nối mảng

Một trong những chiến lược gộp mảng: nối nhiều mảng thành một mảng dài giữ nguyên thứ tự tất cả phần tử; thường dùng để tổng hợp response API.

Array Replace / Thay thế mảng

Một trong những chiến lược gộp mảng: mảng trùng tên lấy giá trị nhập sau làm chuẩn ghi đè toàn bộ; thường dùng để ghi đè cấu hình.

Object.assign

Phương thức có sẵn của JavaScript, sao chép nông (shallow copy) tất cả thuộc tính riêng có thể đếm được từ một hoặc nhiều object nguồn sang object đích; là triển khai chuẩn thực tế của Shallow Merge.

lodash.merge

Hàm gộp sâu được cung cấp bởi thư viện Lodash, là triển khai deep merge phổ biến nhất trong hệ sinh thái Node.js; mảng được gộp thay vì ghi đè.

mergedeep (Python)

Thư viện gộp sâu trong hệ sinh thái Python, cài đặt bằng pip install mergedeep; hỗ trợ tham số strategy để kiểm soát hành vi gộp/ghi đè mảng.

jq -s 'add'

Lệnh jq cộng nhiều mảng JSON thành một mảng duy nhất; để gộp nhiều object JSON cần dùng `reduce .[] as $item ({}; . * $item)`.

BFF (Backend for Frontend)

Lớp tổng hợp nằm giữa frontend và các dịch vụ backend trong kiến trúc microservice; thường cần gộp response JSON từ nhiều service thành response thống nhất, là tình huống kinh điển của JSON Merge.

So sánh 4 chiến lược gộp JSON

Bảng đối chiếu triển khai gộp JSON phổ biến

Authoritative References

• MDNObject.assign - Tài liệu MDN Web
• LodashTài liệu chính thức Lodash _.merge
• jqSổ tay chính thức jq - reduce và add
• IETFĐặc tả chính thức JSON (RFC 8259)