Scal JSON

Powiązane Rekomendacje

Czym jest scalanie JSON (JSON Merge)?

Przypadki użycia

• Scalanie odpowiedzi API z wielu mikrousług w ujednoliconą strukturę JSON dla frontendu
• Agregacja wielowarstwowych plików konfiguracyjnych base / dev / prod i generowanie ostatecznej konfiguracji według środowiska
• Łączenie, deduplikacja i uzupełnianie wielu plików tłumaczeń i18n według języka w kompletny słownik
• Scalanie wielu tablic danych mock lub odpowiedzi stronicowanych API w pełny zbiór danych
• Scalanie domyślnej konfiguracji komponentu frontendowego + konfiguracji użytkownika + zdalnej konfiguracji eksperymentów A/B
• Scalanie plików eksportu JSON z wielu systemów źródłowych podczas migracji danych i ujednolicanie ich do formatu downstream

Jak Używać

1. Wklej kolejno od 2 do N fragmentów JSON do scalenia w pola wejściowe po lewej stronie (domyślnie 2) lub kliknij „+”, aby dodać kolejne wejścia
2. Wybierz strategię scalania z listy rozwijanej na pasku narzędzi: Deep Merge / Shallow Merge / Array Concat / Array Replace
3. Kliknij przycisk „Scal”; w polu wyjściowym po prawej stronie pojawi się sformatowany wynik scalania; jeśli wystąpi błąd składni, wyświetlony zostanie konkretny numer linii i komunikat o błędzie
4. Po sprawdzeniu poprawności wyniku kliknij „Kopiuj”, aby umieścić scalony wynik w schowku, lub „Pobierz”, aby zapisać go jako plik merged.json do dalszego formatowania, walidacji Schema lub innego przetwarzania

Funkcje

• 4 strategie scalania: Deep Merge / Shallow Merge / Array Concat / Array Replace, przełączane jednym kliknięciem dla różnych scenariuszy biznesowych
• Obsługa od 2 do N fragmentów JSON: domyślnie 2 pola wejściowe, przycisk „+” pozwala dynamicznie dodawać kolejne źródła JSON, elastycznie dopasowując się do agregacji z wielu źródeł
• Rekursywne głębokie scalanie: inteligentnie obsługuje wielopoziomowe zagnieżdżone obiekty, przetwarza konflikty na poziomie liści zgodnie z wybraną strategią, zachowując wszystkie prawidłowe pola
• Elastyczne rozwiązywanie konfliktów: konflikty na najwyższym poziomie rozwiązywane są zgodnie z wybraną strategią; konflikty w zagnieżdżonych obiektach przechodzą do głębszego scalania; konflikty tablic rozwiązywane są rozróżnieniem arrayConcat/arrayReplace
• Ujednolicone formatowanie wyjścia: wynik scalania wyświetlany z 2-spacjowym wcięciem, ułatwiając ręczny przegląd i bezpośrednie kopiowanie do narzędzi downstream
• Scalanie w czasie rzeczywistym: po wklejeniu kliknij „Scal”, aby natychmiast uzyskać wynik; w przypadku błędu wyświetlany jest konkretny numer linii JSON i komunikat o błędzie
• Lokalne przetwarzanie chroni prywatność: parsowanie, scalanie i formatowanie odbywają się w całości lokalnie w przeglądarce, wprowadzone dane nie są wysyłane na żaden serwer
• Bezproblemowa integracja z narzędziami downstream: wynik scalania można jednym kliknięciem skopiować do narzędzi formatowania JSON, walidacji Schema lub generowania kodu

Przykłady kodu

// 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łębokie scalanie: zagnieżdżone obiekty scalane rekursywnie, liście nadpisywane przez ostatnią wartość
const deep = merge({}, a, b);
console.log(deep);
// => { user: { name: 'Alice', age: 29, email: 'a@x.com' }, tags: ['admin', 'editor'] }

// Płytkie scalanie: klucze najwyższego poziomu nadpisywane w całości, bez wchodzenia w zagnieżdżenia
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łębokie scalanie
result = merge(a, b)
print(result)
# => {'user': {'name': 'Alice', 'age': 29, 'email': 'a@x.com'}, 'tags': ['admin', 'editor']}

# Uwaga: mergedeep domyślnie scala tablice, napisy/liczby nadpisuje
# Aby nadpisywać tablice, dodaj strategy='override'

# Scalanie wielu tablic JSON w jedną długą tablicę
jq -s 'add' a.json b.json c.json

# Rekursywne scalanie wielu obiektów JSON (jq 1.6+)
jq -s 'reduce .[] as $item ({}; . * $item)' a.json b.json

# Płytkie scalanie: nadpisanie kluczy z b na a
jq -s '.[0] * .[1]' a.json b.json

# Scalanie tablic z pozostawieniem tylko unikalnych pól id
jq -s '[.[].items[]] | unique_by(.id)' a.json b.json

Często Zadawane Pytania

Rozwiązywanie problemów

Słownik

JSON Merge

Operacja łączenia dwóch lub więcej obiektów JSON w jeden nowy obiekt zgodnie z określonymi regułami. Główna trudność to „strategia rozwiązywania konfliktów przy powtarzających się nazwach kluczy”.

Deep Merge / Głębokie scalanie

Strategia rekursywnego wchodzenia w zagnieżdżone obiekty i scalania każdego węzła-liścia oddzielnie; gdy obie strony są zwykłymi obiektami, następuje rekursja, w przeciwnym razie stosuje się nadpisanie.

Shallow Merge / Płytkie scalanie

Strategia scalania tylko kluczy najwyższego poziomu, gdzie klucze o tej samej nazwie są nadpisywane w całości; w JS odpowiada `Object.assign({}, a, b)`.

Array Concat / Konkatenacja tablic

Jedna ze strategii scalania tablic: łączy wiele tablic w jedną długą z zachowaniem kolejności wszystkich elementów; często używana do agregacji odpowiedzi API.

Array Replace / Zastąpienie tablic

Jedna ze strategii scalania tablic: tablica o tej samej nazwie jest w całości nadpisywana przez ostatnią wprowadzoną; często używana do nadpisywania konfiguracji.

Object.assign

Wbudowana metoda JavaScript, która kopiuje płytko wszystkie wyliczalne własności własne z jednego lub więcej obiektów źródłowych do obiektu docelowego; de facto standardowa implementacja płytkiego scalania.

lodash.merge

Funkcja głębokiego scalania dostarczana przez bibliotekę Lodash, najczęściej używana implementacja deep merge w ekosystemie Node.js; scala tablice zamiast je nadpisywać.

mergedeep (Python)

Biblioteka głębokiego scalania w ekosystemie Pythona, instalowana przez pip install mergedeep; obsługuje parametr strategy kontrolujący zachowanie scalania lub nadpisywania tablic.

jq -s 'add'

Polecenie jq sumujące wiele tablic JSON w jedną tablicę; do scalania wielu obiektów JSON należy użyć `reduce .[] as $item ({}; . * $item)`.

BFF (Backend for Frontend)

Warstwa agregacji w architekturze mikrousług, znajdująca się między frontendem a usługami backendowymi; często wymaga scalenia odpowiedzi JSON z wielu usług w ujednoliconą odpowiedź — klasyczny scenariusz użycia scalania JSON.

Porównanie 4 strategii scalania JSON

Tabela porównawcza popularnych implementacji scalania JSON

Authoritative References

• MDNObject.assign - Dokumentacja MDN Web Docs
• LodashOficjalna dokumentacja Lodash _.merge
• jqOficjalny podręcznik jq - reduce i add
• IETFOficjalna specyfikacja JSON (RFC 8259)